Package org.checkerframework.dataflow.expression

Class MethodCall

java.lang.Object

org.checkerframework.dataflow.expression.JavaExpression

org.checkerframework.dataflow.expression.MethodCall

public class MethodCall
extends JavaExpression

A call to a @Deterministic method.

Field Summary

Fields

Modifier and Type	Field	Description
protected java.util.List<JavaExpression>	arguments	The arguments.
protected javax.lang.model.element.ExecutableElement	method	The method being called.
protected JavaExpression	receiver	The receiver argument.

Fields inherited from class org.checkerframework.dataflow.expression.JavaExpression

type

Constructor Summary

Constructors

Constructor	Description
MethodCall(javax.lang.model.type.TypeMirror type, javax.lang.model.element.ExecutableElement method, JavaExpression receiver, java.util.List<JavaExpression> arguments)	Creates a new MethodCall.

Method Summary

Modifier and Type	Method	Description
<R,P> R	accept(JavaExpressionVisitor<R,P> visitor, P p)	Accept method of the visitor pattern.
boolean	containsModifiableAliasOf(Store<?> store, JavaExpression other)	Returns true if and only if other appears anywhere in this or an expression appears in this such that other might alias this expression, and that expression is modifiable.
boolean	containsOfClass(java.lang.Class<? extends JavaExpression> clazz)
boolean	containsSyntacticEqualJavaExpression(JavaExpression other)	Returns true if and only if this contains a JavaExpression that is syntactically equal to other.
boolean	equals(@Nullable java.lang.Object obj)
java.util.List<JavaExpression>	getArguments()	Returns the method call arguments (for inspection only - do not modify any of the arguments).
javax.lang.model.element.ExecutableElement	getElement()	Returns the ExecutableElement for the method call.
JavaExpression	getReceiver()	Returns the method call receiver (for inspection only - do not modify).
int	hashCode()
boolean	isDeterministic(AnnotationProvider provider)	Returns true if the expression is deterministic.
boolean	isUnassignableByOtherCode()	Returns true if and only if the value this expression stands for cannot be changed (with respect to ==) by a method call.
boolean	isUnmodifiableByOtherCode()	Returns true if and only if the value this expression stands for cannot be changed by a method call, including changes to any of its fields.
boolean	syntacticEquals(JavaExpression je)	Returns true if and only if the two Java expressions are syntactically identical.
java.lang.String	toString()

Methods inherited from class org.checkerframework.dataflow.expression.JavaExpression

atConstructorInvocation, atFieldAccess, atMethodBody, atMethodInvocation, atMethodInvocation, containsUnknown, fromArrayAccess, fromNode, fromNodeFieldAccess, fromTree, fromVariableTree, getFormalParameters, getImplicitReceiver, getParametersAsLocalVariables, getPseudoReceiver, getReceiver, getType, listContainsSyntacticEqualJavaExpression, listIsDeterministic, syntacticEqualsList, toStringDebug

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

method

protected final javax.lang.model.element.ExecutableElement method

The method being called.

receiver

protected final JavaExpression receiver

The receiver argument.

arguments

protected final java.util.List<JavaExpression> arguments

The arguments.

Constructor Detail

MethodCall

public MethodCall(javax.lang.model.type.TypeMirror type,
                  javax.lang.model.element.ExecutableElement method,
                  JavaExpression receiver,
                  java.util.List<JavaExpression> arguments)

Creates a new MethodCall.

Parameters:

type - the type of the method call

method - the method being called

receiver - the receiver argument

arguments - the arguments

Method Detail

getElement

public javax.lang.model.element.ExecutableElement getElement()

Returns the ExecutableElement for the method call.

Returns:

the ExecutableElement for the method call

getReceiver

public JavaExpression getReceiver()

Returns the method call receiver (for inspection only - do not modify).

Returns:

the method call receiver (for inspection only - do not modify)

getArguments

public java.util.List<JavaExpression> getArguments()

Returns the method call arguments (for inspection only - do not modify any of the arguments).

Returns:

the method call arguments (for inspection only - do not modify any of the arguments)

containsOfClass

public boolean containsOfClass(java.lang.Class<? extends JavaExpression> clazz)

Specified by:

containsOfClass in class JavaExpression

isDeterministic

public boolean isDeterministic(AnnotationProvider provider)

Description copied from class: JavaExpression

Returns true if the expression is deterministic.

Specified by:

isDeterministic in class JavaExpression

Parameters:

provider - an annotation provider (a type factory)

Returns:

true if this expression is deterministic

isUnassignableByOtherCode

public boolean isUnassignableByOtherCode()

Description copied from class: JavaExpression

Returns true if and only if the value this expression stands for cannot be changed (with respect to ==) by a method call. This is the case for local variables, the self reference, final field accesses whose receiver is JavaExpression.isUnassignableByOtherCode(), and operations whose operands are all JavaExpression.isUnmodifiableByOtherCode().

Specified by:

isUnassignableByOtherCode in class JavaExpression

See Also:

JavaExpression.isUnmodifiableByOtherCode()

isUnmodifiableByOtherCode

public boolean isUnmodifiableByOtherCode()

Description copied from class: JavaExpression

Returns true if and only if the value this expression stands for cannot be changed by a method call, including changes to any of its fields.

Approximately, this returns true if the expression is JavaExpression.isUnassignableByOtherCode() and its type is immutable.

Specified by:

isUnmodifiableByOtherCode in class JavaExpression

See Also:

JavaExpression.isUnassignableByOtherCode()

syntacticEquals

public boolean syntacticEquals(JavaExpression je)

Description copied from class: JavaExpression

Returns true if and only if the two Java expressions are syntactically identical.

This exists for use by JavaExpression.containsSyntacticEqualJavaExpression(org.checkerframework.dataflow.expression.JavaExpression).

Specified by:

syntacticEquals in class JavaExpression

Parameters:

je - the other Java expression to compare to this one

Returns:

true if and only if the two Java expressions are syntactically identical

containsSyntacticEqualJavaExpression

public boolean containsSyntacticEqualJavaExpression(JavaExpression other)

Description copied from class: JavaExpression

Returns true if and only if this contains a JavaExpression that is syntactically equal to other.

Specified by:

containsSyntacticEqualJavaExpression in class JavaExpression

Parameters:

other - the JavaExpression to search for

Returns:

true if and only if this contains a JavaExpression that is syntactically equal to other

containsModifiableAliasOf

public boolean containsModifiableAliasOf(Store<?> store,
                                         JavaExpression other)

Description copied from class: JavaExpression

Returns true if and only if other appears anywhere in this or an expression appears in this such that other might alias this expression, and that expression is modifiable.

This is always true, except for cases where the Java type information prevents aliasing and none of the subexpressions can alias 'other'.

Overrides:

containsModifiableAliasOf in class JavaExpression

equals

public boolean equals(@Nullable java.lang.Object obj)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

accept

public <R,P> R accept(JavaExpressionVisitor<R,P> visitor,
                            P p)

Description copied from class: JavaExpression

Accept method of the visitor pattern.

Specified by:

accept in class JavaExpression

Type Parameters:

R - result type of the operation

P - parameter type

Parameters:

visitor - the visitor to be applied to this JavaExpression

p - the parameter for this operation

Returns:

the result of visiting this