org.checkerframework.dataflow.analysis

Class FlowExpressions.Receiver

java.lang.Object

org.checkerframework.dataflow.analysis.FlowExpressions.Receiver

Direct Known Subclasses:

FlowExpressions.ArrayAccess, FlowExpressions.ArrayCreation, FlowExpressions.BinaryOperation, FlowExpressions.ClassName, FlowExpressions.FieldAccess, FlowExpressions.LocalVariable, FlowExpressions.MethodCall, FlowExpressions.ThisReference, FlowExpressions.Unknown, FlowExpressions.ValueLiteral

Enclosing class:

FlowExpressions

public abstract static class FlowExpressions.Receiver
extends Object

The poorly-named Receiver class is actually a Java AST. Each subclass represents a different type of expression, such as MethodCall, ArrayAccess, LocalVariable, etc.

Field Summary

Fields

Modifier and Type	Field and Description
protected TypeMirror	type The type of this expression.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Receiver(TypeMirror type) Create a Receiver (a Java AST node representing an expression).

Method Summary

Modifier and Type	Method and Description
boolean	containsModifiableAliasOf(Store<?> store, FlowExpressions.Receiver other) Returns true if and only if other appears anywhere in this receiver or an expression appears in this receiver such that other might alias this expression, and that expression is modifiable.
abstract boolean	containsOfClass(Class<? extends FlowExpressions.Receiver> clazz)
boolean	containsSyntacticEqualReceiver(FlowExpressions.Receiver other) Returns true if and only if this receiver contains a receiver that is syntactically equal to other.
boolean	containsUnknown()
String	debugToString() Print this verbosely, for debugging.
TypeMirror	getType()
abstract boolean	isUnassignableByOtherCode() Returns true if and only if the value this expression stands for cannot be changed (with respect to ==) by a method call.
abstract 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(FlowExpressions.Receiver other) Returns true if and only if the two receiver are syntactically identical.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

type

protected final TypeMirror type

The type of this expression.

Constructor Detail

Receiver

protected Receiver(TypeMirror type)

Create a Receiver (a Java AST node representing an expression).

Parameters:

type - the type of the expression

Method Detail

getType

public TypeMirror getType()

containsOfClass

public abstract boolean containsOfClass(Class<? extends FlowExpressions.Receiver> clazz)

containsUnknown

public boolean containsUnknown()

isUnassignableByOtherCode

public abstract boolean isUnassignableByOtherCode()

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 isUnassignableByOtherCode(), and binary operations whose left and right operands are both isUnmodifiableByOtherCode().

See Also:

isUnmodifiableByOtherCode()

isUnmodifiableByOtherCode

public abstract 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.

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

See Also:

isUnassignableByOtherCode()

syntacticEquals

public boolean syntacticEquals(FlowExpressions.Receiver other)

Returns true if and only if the two receiver are syntactically identical.

Returns:

true if and only if the two receiver are syntactically identical

containsSyntacticEqualReceiver

public boolean containsSyntacticEqualReceiver(FlowExpressions.Receiver other)

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

Returns:

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

containsModifiableAliasOf

public boolean containsModifiableAliasOf(Store<?> store,
                                         FlowExpressions.Receiver other)

Returns true if and only if other appears anywhere in this receiver or an expression appears in this receiver 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'.

debugToString

public String debugToString()

Print this verbosely, for debugging.

Returns:

a verbose printed representation of this