com.google.gwt.dev.jjs.ast

Class JMethodCall

java.lang.Object

com.google.gwt.dev.jjs.ast.JNode

com.google.gwt.dev.jjs.ast.JExpression

com.google.gwt.dev.jjs.ast.JMethodCall

All Implemented Interfaces:

HasType, HasSourceInfo, Serializable

Direct Known Subclasses:

JNewInstance, JsniMethodRef

public class JMethodCall
extends JExpression

Java method call expression.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
JMethodCall(JMethodCall other, JExpression instance, JExpression... args) Initialize a new method call equivalent to another one.
JMethodCall(JMethodCall other, JExpression instance, List<JExpression> args) Initialize a new method call equivalent to another one.
JMethodCall(SourceInfo info, JExpression instance, JMethod method, JExpression... args) Create a method call.
JMethodCall(SourceInfo info, JExpression instance, JMethod method, List<JExpression> args) Create a method call.

Method Summary

Modifier and Type	Method and Description
void	addArg(int index, JExpression toAdd) Inserts an argument at the specified index.
void	addArg(JExpression toAdd) Adds an argument to this method.
void	addArgs(JExpression... toAdd) Adds an argument to this method.
void	addArgs(List<JExpression> toAdd) Adds arguments to this method.
boolean	canBePolymorphic() Returns true if the call can dispatch to more than possible target method.
JMethodCall	cloneWithoutParameters() Creates a new method call to the same method using the same instance but without parameters.
List<JExpression>	getArgs() Returns the call arguments.
JExpression	getInstance()
JMethod	getTarget()
JType	getType() Returns the type of this expression.
boolean	hasSideEffects()
boolean	isStaticDispatchOnly() Returns true for calls that must be called statically, e.g.
boolean	isVolatile() Returns true for calls that should not be optimized.
void	markSideEffectFree()
void	overrideReturnType(JType overridenReturnType) Override the return type.
void	resolve(JMethod newMethod) Resolve an external reference during AST stitching.
void	setArg(int index, JExpression arg) Sets the argument at the specified index.
void	setCannotBePolymorphic() See canBePolymorphic().
void	setStaticDispatchOnly() See isStaticDispatchOnly().
void	setVolatile() See isVolatile().
void	traverse(JVisitor visitor, Context ctx) Causes this object to have the visitor visit itself and its children.
protected void	visitChildren(JVisitor visitor)

Methods inherited from class com.google.gwt.dev.jjs.ast.JExpression

makeReturnStatement, makeStatement

Methods inherited from class com.google.gwt.dev.jjs.ast.JNode

getSourceInfo, setSourceInfo, toSource, toString

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode

Constructor Detail

JMethodCall

public JMethodCall(JMethodCall other,
                   JExpression instance,
                   JExpression... args)

Initialize a new method call equivalent to another one. A new instance must be specified, and the new object has no arguments on initialization. This forces the caller to potentially deal with cloning objects if needed.

JMethodCall

public JMethodCall(JMethodCall other,
                   JExpression instance,
                   List<JExpression> args)

Initialize a new method call equivalent to another one. A new instance must be specified, and the new object has no arguments on initialization. This forces the caller to potentially deal with cloning objects if needed.

JMethodCall

public JMethodCall(SourceInfo info,
                   JExpression instance,
                   JMethod method,
                   List<JExpression> args)

Create a method call.

JMethodCall

public JMethodCall(SourceInfo info,
                   JExpression instance,
                   JMethod method,
                   JExpression... args)

Create a method call.

Method Detail

addArg

public void addArg(int index,
                   JExpression toAdd)

Inserts an argument at the specified index.

addArg

public void addArg(JExpression toAdd)

Adds an argument to this method.

addArgs

public void addArgs(JExpression... toAdd)

Adds an argument to this method.

addArgs

public void addArgs(List<JExpression> toAdd)

Adds arguments to this method.

canBePolymorphic

public boolean canBePolymorphic()

Returns true if the call can dispatch to more than possible target method.

cloneWithoutParameters

public JMethodCall cloneWithoutParameters()

Creates a new method call to the same method using the same instance but without parameters.

getArgs

public List<JExpression> getArgs()

Returns the call arguments.

getInstance

public JExpression getInstance()

getTarget

public JMethod getTarget()

getType

public JType getType()

Description copied from interface: HasType

Returns the type of this expression.

markSideEffectFree

public void markSideEffectFree()

hasSideEffects

public boolean hasSideEffects()

Specified by:

hasSideEffects in class JExpression

isStaticDispatchOnly

public boolean isStaticDispatchOnly()

Returns true for calls that must be called statically, e.g. super.method() invocations, and super() and this() constructor calls.

isVolatile

public boolean isVolatile()

Returns true for calls that should not be optimized.

overrideReturnType

public void overrideReturnType(JType overridenReturnType)

Override the return type.

The method call expression will have overridentReturnType as its type ignoring the return type of the target method. This is used during normalizing transformations to preserve type semantics when calling externally-defined compiler implementation methods.

For example, Cast.dynamicCast() returns Object but that method is used to implement the cast operation. Using a stronger type on the call expression allows us to preserve type information during the latter phases of compilation.

resolve

public void resolve(JMethod newMethod)

Resolve an external reference during AST stitching.

setArg

public void setArg(int index,
                   JExpression arg)

Sets the argument at the specified index.

setCannotBePolymorphic

public void setCannotBePolymorphic()

See canBePolymorphic().

setStaticDispatchOnly

public void setStaticDispatchOnly()

See isStaticDispatchOnly().

setVolatile

public void setVolatile()

See isVolatile().

traverse

public void traverse(JVisitor visitor,
                     Context ctx)

Description copied from class: JNode

Causes this object to have the visitor visit itself and its children.

Specified by:

traverse in class JNode

Parameters:

visitor - the visitor that should traverse this node

ctx - the context of an existing traversal

visitChildren

protected void visitChildren(JVisitor visitor)