org.checkerframework.checker.initialization

Class InitializationTransfer<V extends org.checkerframework.framework.flow.CFAbstractValue<V>,T extends InitializationTransfer<V,T,S>,S extends InitializationStore<V,S>>

java.lang.Object

org.checkerframework.dataflow.cfg.node.AbstractNodeVisitor<org.checkerframework.dataflow.analysis.TransferResult<V,S>,org.checkerframework.dataflow.analysis.TransferInput<V,S>>

org.checkerframework.framework.flow.CFAbstractTransfer<V,S,T>

org.checkerframework.checker.initialization.InitializationTransfer<V,T,S>

Type Parameters:

T - the type of the transfer function

All Implemented Interfaces:

org.checkerframework.dataflow.analysis.TransferFunction<V,S>, org.checkerframework.dataflow.cfg.node.NodeVisitor<org.checkerframework.dataflow.analysis.TransferResult<V,S>,org.checkerframework.dataflow.analysis.TransferInput<V,S>>

Direct Known Subclasses:

NullnessTransfer

public class InitializationTransfer<V extends org.checkerframework.framework.flow.CFAbstractValue<V>,T extends InitializationTransfer<V,T,S>,S extends InitializationStore<V,S>>
extends org.checkerframework.framework.flow.CFAbstractTransfer<V,S,T>

A transfer function that extends CFAbstractTransfer and tracks InitializationStores. In addition to the features of CFAbstractTransfer, this transfer function also track which fields of the current class ('self' receiver) have been initialized.

More precisely, the following refinements are performed:

1. After the call to a constructor ("this()" call), all non-null fields of the current class can safely be considered initialized.
2. After a method call with a postcondition that ensures a field to be non-null, that field can safely be considered initialized (this is done in InitializationStore.insertValue(FlowExpressions.Receiver, CFAbstractValue)).
3. All non-null fields with an initializer can be considered initialized (this is done in InitializationStore.insertValue(FlowExpressions.Receiver, CFAbstractValue)).
4. After the call to a super constructor ("super()" call), all non-null fields of the super class can safely be considered initialized.

See Also:

InitializationStore

Field Summary

Fields

Modifier and Type	Field and Description
protected InitializationAnnotatedTypeFactory<?,?,?,?>	atypeFactory

Fields inherited from class org.checkerframework.framework.flow.CFAbstractTransfer

analysis, sequentialSemantics

Constructor Summary

Constructors

Constructor and Description
InitializationTransfer(org.checkerframework.framework.flow.CFAbstractAnalysis<V,S,T> analysis)

Method Summary

Modifier and Type	Method and Description
protected List<VariableElement>	initializedFieldsAfterCall(org.checkerframework.dataflow.cfg.node.MethodInvocationNode node, org.checkerframework.dataflow.analysis.ConditionalTransferResult<V,S> transferResult) Returns the fields that can safely be considered initialized after the method call node.
protected boolean	isNotFullyInitializedReceiver(MethodTree methodTree)
protected void	markInvariantFieldsAsInitialized(List<VariableElement> result, TypeElement clazzElem) Adds all the fields of the class clazzElem that have the 'invariant annotation' to the set of initialized fields result.
org.checkerframework.dataflow.analysis.TransferResult<V,S>	visitAssignment(org.checkerframework.dataflow.cfg.node.AssignmentNode n, org.checkerframework.dataflow.analysis.TransferInput<V,S> in)
org.checkerframework.dataflow.analysis.TransferResult<V,S>	visitFieldAccess(org.checkerframework.dataflow.cfg.node.FieldAccessNode n, org.checkerframework.dataflow.analysis.TransferInput<V,S> p) If an invariant field is initialized and has the invariant annotation, than it has at least the invariant annotation.
org.checkerframework.dataflow.analysis.TransferResult<V,S>	visitMethodInvocation(org.checkerframework.dataflow.cfg.node.MethodInvocationNode n, org.checkerframework.dataflow.analysis.TransferInput<V,S> in)

Methods inherited from class org.checkerframework.framework.flow.CFAbstractTransfer

addInformationFromPreconditions, finishValue, finishValue, getValueFromFactory, getValueWithSameAnnotations, initialStore, moreSpecificValue, processCommonAssignment, processConditionalPostconditions, processPostconditions, setFixedInitialStore, splitAssignments, strengthenAnnotationOfEqualTo, usesSequentialSemantics, visitArrayAccess, visitCase, visitClassName, visitConditionalNot, visitEqualTo, visitLambdaResultExpression, visitLocalVariable, visitNarrowingConversion, visitNode, visitNotEqual, visitObjectCreation, visitReturn, visitStringConcatenateAssignment, visitStringConversion, visitTernaryExpression, visitThisLiteral, visitVariableDeclaration, visitWideningConversion

Methods inherited from class org.checkerframework.dataflow.cfg.node.AbstractNodeVisitor

visitArrayCreation, visitArrayType, visitAssertionError, visitBitwiseAnd, visitBitwiseComplement, visitBitwiseOr, visitBitwiseXor, visitBooleanLiteral, visitCharacterLiteral, visitClassDeclaration, visitConditionalAnd, visitConditionalOr, visitDoubleLiteral, visitExplicitThisLiteral, visitFloatingDivision, visitFloatingRemainder, visitFloatLiteral, visitGreaterThan, visitGreaterThanOrEqual, visitImplicitThisLiteral, visitInstanceOf, 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

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.checkerframework.dataflow.cfg.node.NodeVisitor

visitArrayCreation, visitArrayType, visitAssertionError, visitBitwiseAnd, visitBitwiseComplement, visitBitwiseOr, visitBitwiseXor, visitBooleanLiteral, visitCharacterLiteral, visitClassDeclaration, visitConditionalAnd, visitConditionalOr, visitDoubleLiteral, visitExplicitThisLiteral, visitFloatingDivision, visitFloatingRemainder, visitFloatLiteral, visitGreaterThan, visitGreaterThanOrEqual, visitImplicitThisLiteral, visitInstanceOf, 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

Field Detail

atypeFactory

protected final InitializationAnnotatedTypeFactory<?,?,?,?> atypeFactory

Constructor Detail

InitializationTransfer

public InitializationTransfer(org.checkerframework.framework.flow.CFAbstractAnalysis<V,S,T> analysis)

Method Detail

isNotFullyInitializedReceiver

protected boolean isNotFullyInitializedReceiver(MethodTree methodTree)

Overrides:

isNotFullyInitializedReceiver in class org.checkerframework.framework.flow.CFAbstractTransfer<V extends org.checkerframework.framework.flow.CFAbstractValue<V>,S extends InitializationStore<V,S>,T extends InitializationTransfer<V,T,S>>

initializedFieldsAfterCall

protected List<VariableElement> initializedFieldsAfterCall(org.checkerframework.dataflow.cfg.node.MethodInvocationNode node,
                                                           org.checkerframework.dataflow.analysis.ConditionalTransferResult<V,S> transferResult)

Returns the fields that can safely be considered initialized after the method call node.

markInvariantFieldsAsInitialized

protected void markInvariantFieldsAsInitialized(List<VariableElement> result,
                                                TypeElement clazzElem)

Adds all the fields of the class clazzElem that have the 'invariant annotation' to the set of initialized fields result.

visitAssignment

public org.checkerframework.dataflow.analysis.TransferResult<V,S> visitAssignment(org.checkerframework.dataflow.cfg.node.AssignmentNode n,
                                                                                  org.checkerframework.dataflow.analysis.TransferInput<V,S> in)

Specified by:

visitAssignment in interface org.checkerframework.dataflow.cfg.node.NodeVisitor<org.checkerframework.dataflow.analysis.TransferResult<V extends org.checkerframework.framework.flow.CFAbstractValue<V>,S extends InitializationStore<V,S>>,org.checkerframework.dataflow.analysis.TransferInput<V extends org.checkerframework.framework.flow.CFAbstractValue<V>,S extends InitializationStore<V,S>>>

Overrides:

visitAssignment in class org.checkerframework.framework.flow.CFAbstractTransfer<V extends org.checkerframework.framework.flow.CFAbstractValue<V>,S extends InitializationStore<V,S>,T extends InitializationTransfer<V,T,S>>

visitFieldAccess

public org.checkerframework.dataflow.analysis.TransferResult<V,S> visitFieldAccess(org.checkerframework.dataflow.cfg.node.FieldAccessNode n,
                                                                                   org.checkerframework.dataflow.analysis.TransferInput<V,S> p)

If an invariant field is initialized and has the invariant annotation, than it has at least the invariant annotation. Note that only fields of the 'this' receiver are tracked for initialization.

Specified by:

visitFieldAccess in interface org.checkerframework.dataflow.cfg.node.NodeVisitor<org.checkerframework.dataflow.analysis.TransferResult<V extends org.checkerframework.framework.flow.CFAbstractValue<V>,S extends InitializationStore<V,S>>,org.checkerframework.dataflow.analysis.TransferInput<V extends org.checkerframework.framework.flow.CFAbstractValue<V>,S extends InitializationStore<V,S>>>

Overrides:

visitFieldAccess in class org.checkerframework.framework.flow.CFAbstractTransfer<V extends org.checkerframework.framework.flow.CFAbstractValue<V>,S extends InitializationStore<V,S>,T extends InitializationTransfer<V,T,S>>

visitMethodInvocation

public org.checkerframework.dataflow.analysis.TransferResult<V,S> visitMethodInvocation(org.checkerframework.dataflow.cfg.node.MethodInvocationNode n,
                                                                                        org.checkerframework.dataflow.analysis.TransferInput<V,S> in)

Specified by:

visitMethodInvocation in interface org.checkerframework.dataflow.cfg.node.NodeVisitor<org.checkerframework.dataflow.analysis.TransferResult<V extends org.checkerframework.framework.flow.CFAbstractValue<V>,S extends InitializationStore<V,S>>,org.checkerframework.dataflow.analysis.TransferInput<V extends org.checkerframework.framework.flow.CFAbstractValue<V>,S extends InitializationStore<V,S>>>

Overrides:

visitMethodInvocation in class org.checkerframework.framework.flow.CFAbstractTransfer<V extends org.checkerframework.framework.flow.CFAbstractValue<V>,S extends InitializationStore<V,S>,T extends InitializationTransfer<V,T,S>>