public class CalledMethodsTransfer extends AccumulationTransfer
atypeFactory
analysis, sequentialSemantics
Constructor and Description |
---|
CalledMethodsTransfer(CalledMethodsAnalysis analysis)
Create a new CalledMethodsTransfer.
|
Modifier and Type | Method and Description |
---|---|
void |
accumulate(Node node,
TransferResult<CFValue,CFStore> result,
String... values)
Updates the estimate of how many things
node has accumulated. |
TransferResult<CFValue,CFStore> |
visitMethodInvocation(MethodInvocationNode node,
TransferInput<CFValue,CFStore> input) |
addInformationFromPreconditions, createTransferResult, finishValue, finishValue, getNarrowedValue, getValueFromFactory, getWidenedValue, initialStore, insertIntoStores, isNotFullyInitializedReceiver, moreSpecificValue, processCommonAssignment, processConditionalPostconditions, processPostconditions, recreateTransferResult, setFixedInitialStore, splitAssignments, strengthenAnnotationOfEqualTo, usesSequentialSemantics, visitArrayAccess, visitAssignment, visitCase, visitClassName, visitConditionalNot, visitEqualTo, visitFieldAccess, visitInstanceOf, visitLambdaResultExpression, visitLocalVariable, visitNarrowingConversion, visitNode, visitNotEqual, visitObjectCreation, visitReturn, visitStringConcatenateAssignment, visitStringConversion, visitTernaryExpression, visitThis, visitVariableDeclaration, visitWideningConversion
visitArrayCreation, visitArrayType, visitAssertionError, visitBitwiseAnd, visitBitwiseComplement, visitBitwiseOr, visitBitwiseXor, visitBooleanLiteral, visitCharacterLiteral, visitClassDeclaration, visitConditionalAnd, visitConditionalOr, visitDoubleLiteral, visitExplicitThis, visitFloatingDivision, visitFloatingRemainder, visitFloatLiteral, visitGreaterThan, visitGreaterThanOrEqual, visitImplicitThis, visitIntegerDivision, visitIntegerLiteral, visitIntegerRemainder, visitLeftShift, visitLessThan, visitLessThanOrEqual, visitLongLiteral, visitMarker, visitMemberReference, visitMethodAccess, visitNullChk, visitNullLiteral, visitNumericalAddition, visitNumericalMinus, visitNumericalMultiplication, visitNumericalPlus, visitNumericalSubtraction, visitPackageName, visitParameterizedType, visitPrimitiveType, visitShortLiteral, visitSignedRightShift, visitStringConcatenate, visitStringLiteral, visitSuper, visitSynchronized, visitThrow, visitTypeCast, visitUnsignedRightShift, visitValueLiteral
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
visitArrayCreation, visitArrayType, visitAssertionError, visitBitwiseAnd, visitBitwiseComplement, visitBitwiseOr, visitBitwiseXor, visitBooleanLiteral, visitCharacterLiteral, visitClassDeclaration, visitConditionalAnd, visitConditionalOr, visitDoubleLiteral, visitExplicitThis, visitFloatingDivision, visitFloatingRemainder, visitFloatLiteral, visitGreaterThan, visitGreaterThanOrEqual, visitImplicitThis, visitIntegerDivision, visitIntegerLiteral, visitIntegerRemainder, visitLeftShift, visitLessThan, visitLessThanOrEqual, visitLongLiteral, visitMarker, visitMemberReference, visitMethodAccess, visitNullChk, visitNullLiteral, visitNumericalAddition, visitNumericalMinus, visitNumericalMultiplication, visitNumericalPlus, visitNumericalSubtraction, visitPackageName, visitParameterizedType, visitPrimitiveType, visitShortLiteral, visitSignedRightShift, visitStringConcatenate, visitStringLiteral, visitSuper, visitSynchronized, visitThrow, visitTypeCast, visitUnsignedRightShift
public CalledMethodsTransfer(CalledMethodsAnalysis analysis)
analysis
- the analysispublic TransferResult<CFValue,CFStore> visitMethodInvocation(MethodInvocationNode node, TransferInput<CFValue,CFStore> input)
visitMethodInvocation
in interface NodeVisitor<TransferResult<CFValue,CFStore>,TransferInput<CFValue,CFStore>>
visitMethodInvocation
in class CFAbstractTransfer<CFValue,CFStore,CFTransfer>
public void accumulate(Node node, TransferResult<CFValue,CFStore> result, String... values)
AccumulationTransfer
node
has accumulated.
If the node is an invocation of a method that returns its receiver, then its receiver's type will also be updated. In a chain of method calls, this process will continue backward as long as each receiver is itself a receiver-returning method invocation.
For example, suppose node
is the expression a.b().c()
, the new value (added
by the accumulation analysis because of the .c()
call) is "foo", and b and c return
their receiver. This method will directly update the estimate of a.b().c()
to include
"foo". In addition, the estimates for the expressions a.b()
and a
would have
their estimates updated to include "foo", because c and b (respectively) return their
receivers. Note that due to what kind of values can be held in the store, this information is
lost outside the method chain. That is, the returns-receiver propagated information is lost
outside the expression in which the returns-receiver method invocations are nested.
As a concrete example, consider the Called Methods accumulation checker: if build
requires a, b, and c to be called, then foo.a().b().c().build();
will typecheck (they
are in one fluent method chain), but foo.a().b().c(); foo.build();
will not -- the
store does not keep the information that a, b, and c have been called outside the chain. foo
's type will be CalledMethods("a")
, because only a()
was called directly on
foo
. For such code to typecheck, the Called Methods accumulation checker uses an
additional rule: the return type of a receiver-returning method rr()
is CalledMethods("rr")
. This rule is implemented directly in the TreeAnnotator
subclass defined in the Called
Methods type factory.
accumulate
in class AccumulationTransfer
node
- the node whose estimate should be expandedresult
- the transfer result containing the store to be modifiedvalues
- the new accumulation values