org.checkerframework.checker.initialization

Class InitializationAnnotatedTypeFactory<Value extends org.checkerframework.framework.flow.CFAbstractValue<Value>,Store extends InitializationStore<Value,Store>,Transfer extends InitializationTransfer<Value,Transfer,Store>,Flow extends org.checkerframework.framework.flow.CFAbstractAnalysis<Value,Store,Transfer>>

java.lang.Object

org.checkerframework.framework.type.AnnotatedTypeFactory

org.checkerframework.framework.type.GenericAnnotatedTypeFactory<Value,Store,Transfer,Flow>

org.checkerframework.checker.initialization.InitializationAnnotatedTypeFactory<Value,Store,Transfer,Flow>

All Implemented Interfaces:

org.checkerframework.javacutil.AnnotationProvider

Direct Known Subclasses:

NullnessAnnotatedTypeFactory

public abstract class InitializationAnnotatedTypeFactory<Value extends org.checkerframework.framework.flow.CFAbstractValue<Value>,Store extends InitializationStore<Value,Store>,Transfer extends InitializationTransfer<Value,Transfer,Store>,Flow extends org.checkerframework.framework.flow.CFAbstractAnalysis<Value,Store,Transfer>>
extends org.checkerframework.framework.type.GenericAnnotatedTypeFactory<Value,Store,Transfer,Flow>

The annotated type factory for the freedom-before-commitment type-system. The freedom-before-commitment type-system and this class are abstract and need to be combined with another type-system whose safe initialization should be tracked. For an example, see the NullnessChecker. Also supports rawness as a type-system for tracking initialization, though FBC is preferred.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	InitializationAnnotatedTypeFactory.CommitmentTreeAnnotator
protected class	InitializationAnnotatedTypeFactory.CommitmentTypeAnnotator
protected class	InitializationAnnotatedTypeFactory.InitializationQualifierHierarchy The QualifierHierarchy for the initialization type system.

Nested classes/interfaces inherited from class org.checkerframework.framework.type.GenericAnnotatedTypeFactory

org.checkerframework.framework.type.GenericAnnotatedTypeFactory.ScanState

Nested classes/interfaces inherited from class org.checkerframework.framework.type.AnnotatedTypeFactory

org.checkerframework.framework.type.AnnotatedTypeFactory.InheritedFromClassAnnotator, org.checkerframework.framework.type.AnnotatedTypeFactory.ParameterizedMethodType

Field Summary

Fields

Modifier and Type	Field and Description
protected AnnotationMirror	COMMITTED Initialized or NonRaw.
protected AnnotationMirror	FBCBOTTOM FBCBottom or NonRaw.
protected AnnotationMirror	FREE UnderInitialization or null.
protected Set<Class<? extends Annotation>>	initAnnos
protected AnnotationMirror	NOT_ONLY_COMMITTED NotOnlyInitialized or null.
protected AnnotationMirror	UNCLASSIFIED UnknownInitialization or Raw.
protected boolean	useFbc Should the initialization type system be FBC? If not, the rawness type system is used for initialization.

Fields inherited from class org.checkerframework.framework.type.GenericAnnotatedTypeFactory

analysis, cfgVisualizer, defaults, dependentTypesHelper, emptyStore, flowByDefault, flowResult, flowResultAnalysisCaches, initializationStaticStore, initializationStore, methodInvocationStores, poly, regularExitStores, returnStatementStores, scannedClasses, transfer, treeAnnotator, typeAnnotator

Fields inherited from class org.checkerframework.framework.type.AnnotatedTypeFactory

checker, elements, fromExpressionTreeCache, fromMemberTreeCache, fromTypeTreeCache, ignoreUninferredTypeArguments, loader, processingEnv, qualHierarchy, reflectionResolver, root, shouldCache, trees, typeArgumentInference, typeFormatter, typeHierarchy, types, typeVarSubstitutor, uid, visitorState

Constructor Summary

Constructors

Constructor and Description
InitializationAnnotatedTypeFactory(org.checkerframework.common.basetype.BaseTypeChecker checker, boolean useFbc)

Method Summary

Modifier and Type	Method and Description
protected boolean	areAllFieldsCommittedOnly(ClassTree classTree) Are all fields committed-only?
AnnotationMirror	createFreeAnnotation(Class<?> typeFrame) Creates a UnderInitialization annotation with the given type frame.
AnnotationMirror	createFreeAnnotation(TypeMirror typeFrame) Creates a UnderInitialization annotation with the given type as its type frame argument.
protected org.checkerframework.framework.util.MultiGraphQualifierHierarchy.MultiGraphFactory	createQualifierHierarchyFactory()
protected org.checkerframework.framework.type.treeannotator.TreeAnnotator	createTreeAnnotator()
protected org.checkerframework.framework.type.typeannotator.TypeAnnotator	createTypeAnnotator()
AnnotationMirror	createUnclassifiedAnnotation(Class<?> typeFrame) Creates a UnknownInitialization or Raw annotation with a given type frame.
AnnotationMirror	createUnclassifiedAnnotation(TypeMirror typeFrame) Creates an UnknownInitialization or Raw annotation with a given type frame.
org.checkerframework.framework.type.AnnotatedTypeMirror	getAnnotatedTypeLhs(Tree lhsTree)
abstract AnnotationMirror	getFieldInvariantAnnotation() Returns the annotation that makes up the invariant of this commitment type system, such as @NonNull.
protected AnnotationMirror	getFreeOrRawAnnotationOfSuperType(TypeMirror type) Returns a UnderInitialization annotation (or UnknownInitialization if rawness is used) that has the supertype of type as type frame.
Set<Class<? extends Annotation>>	getInitializationAnnotations()
List<VariableTree>	getInitializedInvariantFields(Store store, TreePath path) Returns the (non-static) fields that have the invariant annotation and are initialized in a given store.
Set<Class<? extends Annotation>>	getInvalidConstructorReturnTypeAnnotations()
org.checkerframework.framework.type.AnnotatedTypeMirror.AnnotatedDeclaredType	getSelfType(Tree tree)
TypeMirror	getTypeFrameFromAnnotation(AnnotationMirror annotation) Returns the type frame of a given annotation.
List<VariableTree>	getUninitializedInvariantFields(Store store, TreePath path, boolean isStatic, List<? extends AnnotationMirror> receiverAnnotations) Returns the (non-static) fields that have the invariant annotation and are not yet initialized in a given store.
protected abstract boolean	hasFieldInvariantAnnotation(org.checkerframework.framework.type.AnnotatedTypeMirror type) Returns whether or not type has the invariant annotation.
protected boolean	hasFieldInvariantAnnotation(VariableTree field) Returns whether or not field has the invariant annotation.
boolean	isCommitted(org.checkerframework.framework.type.AnnotatedTypeMirror anno) Does anno have the annotation Initialized? If useFbc is false, then NonRaw is used in the comparison.
boolean	isCommitted(AnnotationMirror anno) Is anno the Initialized annotation? If useFbc is false, then NonRaw is used in the comparison.
boolean	isFbcBottom(org.checkerframework.framework.type.AnnotatedTypeMirror anno) Does anno have the bottom annotation?
boolean	isFbcBottom(AnnotationMirror anno) Is anno the bottom annotation?
boolean	isFree(org.checkerframework.framework.type.AnnotatedTypeMirror anno) Does anno have the annotation UnderInitialization (with any type frame)? Always returns false if useFbc is false.
boolean	isFree(AnnotationMirror anno) Is anno the UnderInitialization annotation (with any type frame)? Always returns false if useFbc is false.
protected boolean	isInitializationAnnotation(AnnotationMirror anno) Is the annotation anno an initialization qualifier?
boolean	isInitializedForFrame(org.checkerframework.framework.type.AnnotatedTypeMirror type, TypeMirror frame)
boolean	isUnclassified(org.checkerframework.framework.type.AnnotatedTypeMirror anno) Does anno have the annotation UnknownInitialization (with any type frame)? If useFbc is false, then Raw is used in the comparison.
boolean	isUnclassified(AnnotationMirror anno) Is anno the UnknownInitialization annotation (with any type frame)? If useFbc is false, then Raw is used in the comparison.
void	postAsMemberOf(org.checkerframework.framework.type.AnnotatedTypeMirror type, org.checkerframework.framework.type.AnnotatedTypeMirror owner, Element element)
protected void	setSelfTypeInInitializationCode(Tree tree, org.checkerframework.framework.type.AnnotatedTypeMirror.AnnotatedDeclaredType selfType, TreePath path)

Methods inherited from class org.checkerframework.framework.type.GenericAnnotatedTypeFactory

addCheckedCodeDefaults, addCheckedStandardDefaults, addComputedTypeAnnotations, addComputedTypeAnnotations, addComputedTypeAnnotations, addDefaultAnnotations, addTypeNameImplicit, addUncheckedCodeDefaults, addUncheckedStandardDefaults, analyze, applyInferredAnnotations, checkAndPerformFlowAnalysis, checkForDefaultQualifierInHierarchy, constructorFromUse, createAndInitQualifierDefaults, createCFGVisualizer, createDependentTypesHelper, createFlowAnalysis, createFlowTransferFunction, createQualifierDefaults, createQualifierPolymorphism, fromNewClass, getAnnotatedTypeLhsNoTypeVarDefault, getAnnotatedTypeRhsUnaryAssign, getAnnotatedTypeVarargsArray, getAnnotationFromJavaExpressionString, getAnnotationFromReceiver, getAnnotationMirrorFromJavaExpressionString, getCFGVisualizer, getDependentTypesHelper, getEmptyStore, getFinalLocalValues, getFirstNodeOfKindForTree, getInferredValueFor, getMethodReturnType, getMethodReturnType, getNodesForTree, getReceiverFromJavaExpressionString, getRegularExitStore, getResultingTypeOfConstructorMemberReference, getReturnStatementStores, getShouldDefaultTypeVarLocals, getSortedQualifierNames, getStoreAfter, getStoreAfter, getStoreAfter, getStoreBefore, getStoreBefore, getStoreBefore, getSupportedMonotonicTypeQualifiers, getTypeFactoryOfSubchecker, handleCFGViz, methodFromUse, performFlowAnalysis, postDirectSuperTypes, postInit, preProcessClassTree, setRoot, typeVariablesFromUse

Methods inherited from class org.checkerframework.framework.type.AnnotatedTypeFactory

adaptGetClassReturnTypeToReceiver, addAliasedAnnotation, addAliasedAnnotation, addAliasedAnnotation, addAliasedAnnotation, addAliasedDeclAnnotation, addAnnotationFromFieldInvariant, addInheritedAnnotation, aliasedAnnotation, annotateInheritedFromClass, annotateInheritedFromClass, checkInvalidOptionsInferSignatures, createAnnotatedTypeFormatter, createAnnotationClassLoader, createAnnotationFormatter, createQualifierHierarchy, createQualifierHierarchy, createQualifierHierarchy, createSupportedTypeQualifiers, createTypeArgumentInference, createTypeHierarchy, createTypeVariableSubstitutor, declarationFromElement, fromElement, fromElement, fromElement, getAnnotatedNullType, getAnnotatedType, getAnnotatedType, getAnnotatedType, getAnnotatedType, getAnnotatedType, getAnnotatedType, getAnnotatedType, getAnnotatedType, getAnnotatedTypeFormatter, getAnnotatedTypeFromTypeTree, getAnnotationFormatter, getAnnotationMirror, getAnnotationWithMetaAnnotation, getBoxedType, getBundledTypeQualifiersWithoutPolyAll, getBundledTypeQualifiersWithPolyAll, getCacheSize, getContext, getCurrentClassTree, getCurrentClassType, getCurrentMethodReceiver, getDeclAnnotation, getDeclAnnotationNoAliases, getDeclAnnotations, getDeclAnnotationWithMetaAnnotation, getElementUtils, getEnclosingMethod, getEnclosingType, getFieldInvariantAnnotationTree, getFieldInvariantDeclarationAnnotations, getFieldInvariants, getFnInterfaceFromTree, getFnInterfaceFromTree, getImplicitReceiverType, getNarrowedPrimitive, getPath, getProcessingEnv, getQualifierHierarchy, getReceiverType, getStringType, getSupportedTypeQualifiers, getTreeUtils, getTypeArgumentInference, getTypeHierarchy, getTypeVarSubstitutor, getUnboxedType, getUninferredWildcardType, getVisitorState, getWholeProgramInference, initializeReflectionResolution, isAnyEnclosingThisDeref, isFromByteCode, isFromStubFile, isMostEnclosingThisDeref, isSupportedQualifier, isWithinConstructor, methodFromUse, parseStubFiles, postProcessClassTree, postTypeVarSubstitution, setPathHack, toAnnotatedType, toString, type, widenToUpperBound

Methods inherited from class java.lang.Object

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

Field Detail

UNCLASSIFIED

protected final AnnotationMirror UNCLASSIFIED

UnknownInitialization or Raw.

COMMITTED

protected final AnnotationMirror COMMITTED

Initialized or NonRaw.

FREE

protected final AnnotationMirror FREE

UnderInitialization or null.

NOT_ONLY_COMMITTED

protected final AnnotationMirror NOT_ONLY_COMMITTED

NotOnlyInitialized or null.

FBCBOTTOM

protected final AnnotationMirror FBCBOTTOM

FBCBottom or NonRaw.

useFbc

protected final boolean useFbc

Should the initialization type system be FBC? If not, the rawness type system is used for initialization.

initAnnos

protected final Set<Class<? extends Annotation>> initAnnos

Constructor Detail

InitializationAnnotatedTypeFactory

public InitializationAnnotatedTypeFactory(org.checkerframework.common.basetype.BaseTypeChecker checker,
                                          boolean useFbc)

Method Detail

getInitializationAnnotations

public Set<Class<? extends Annotation>> getInitializationAnnotations()

isInitializationAnnotation

protected boolean isInitializationAnnotation(AnnotationMirror anno)

Is the annotation anno an initialization qualifier?

Parameters:

anno - the annotation to check

Returns:

true if the argument is an initialization qualifier

getInvalidConstructorReturnTypeAnnotations

public Set<Class<? extends Annotation>> getInvalidConstructorReturnTypeAnnotations()

Returns:

the list of annotations that is forbidden for the constructor return type

getFieldInvariantAnnotation

public abstract AnnotationMirror getFieldInvariantAnnotation()

Returns the annotation that makes up the invariant of this commitment type system, such as @NonNull.

Returns:

the invariant annotation for this type system

hasFieldInvariantAnnotation

protected final boolean hasFieldInvariantAnnotation(VariableTree field)

Returns whether or not field has the invariant annotation.

This method is a convenience method for hasFieldInvariantAnnotation(AnnotatedTypeMirror).

If the field is a type variable, this method returns true if any possible instantiation of the type parameter could have the invariant annotation. See hasFieldInvariantAnnotation(VariableTree) for an example.

Parameters:

field - field that might have invariant annotation

Returns:

whether or not field has the invariant annotation

hasFieldInvariantAnnotation

protected abstract boolean hasFieldInvariantAnnotation(org.checkerframework.framework.type.AnnotatedTypeMirror type)

Returns whether or not type has the invariant annotation.

If the type is a type variable, this method returns true if any possible instantiation of the type parameter could have the invariant annotation. See hasFieldInvariantAnnotation(VariableTree) for an example.

Parameters:

type - of field that might have invariant annotation

Returns:

whether or not the type has the invariant annotation

createFreeAnnotation

public AnnotationMirror createFreeAnnotation(TypeMirror typeFrame)

Creates a UnderInitialization annotation with the given type as its type frame argument.

Parameters:

typeFrame - the type down to which some value has been initialized

Returns:

an UnderInitialization annotation with the given argument

createFreeAnnotation

public AnnotationMirror createFreeAnnotation(Class<?> typeFrame)

Creates a UnderInitialization annotation with the given type frame.

Parameters:

typeFrame - the type down to which some value has been initialized

Returns:

an UnderInitialization annotation with the given argument

createUnclassifiedAnnotation

public AnnotationMirror createUnclassifiedAnnotation(Class<?> typeFrame)

Creates a UnknownInitialization or Raw annotation with a given type frame.

Parameters:

typeFrame - the type down to which some value has been initialized

Returns:

an UnknownInitialization or Raw annotation with the given argument

createUnclassifiedAnnotation

public AnnotationMirror createUnclassifiedAnnotation(TypeMirror typeFrame)

Creates an UnknownInitialization or Raw annotation with a given type frame.

Parameters:

typeFrame - the type down to which some value has been initialized

Returns:

an UnknownInitialization or Raw annotation with the given argument

getTypeFrameFromAnnotation

public TypeMirror getTypeFrameFromAnnotation(AnnotationMirror annotation)

Returns the type frame of a given annotation.

Parameters:

annotation - a UnderInitialization or UnknownInitialization annotation

Returns:

the annotation's argument

isFree

public boolean isFree(AnnotationMirror anno)

Is anno the UnderInitialization annotation (with any type frame)? Always returns false if useFbc is false.

Parameters:

anno - the annotation to check

Returns:

true if anno is UnderInitialization

isUnclassified

public boolean isUnclassified(AnnotationMirror anno)

Is anno the UnknownInitialization annotation (with any type frame)? If useFbc is false, then Raw is used in the comparison.

Parameters:

anno - the annotation to check

Returns:

true if anno is UnknownInitialization or Raw

isFbcBottom

public boolean isFbcBottom(AnnotationMirror anno)

Is anno the bottom annotation?

Parameters:

anno - the annotation to check

Returns:

true if anno is FBCBottom or NonRaw

isCommitted

public boolean isCommitted(AnnotationMirror anno)

Is anno the Initialized annotation? If useFbc is false, then NonRaw is used in the comparison.

Parameters:

anno - the annotation to check

Returns:

true if anno is Initialized or NonRaw

isFree

public boolean isFree(org.checkerframework.framework.type.AnnotatedTypeMirror anno)

Does anno have the annotation UnderInitialization (with any type frame)? Always returns false if useFbc is false.

Parameters:

anno - the annotation to check

Returns:

true if anno has UnderInitialization

isUnclassified

public boolean isUnclassified(org.checkerframework.framework.type.AnnotatedTypeMirror anno)

Does anno have the annotation UnknownInitialization (with any type frame)? If useFbc is false, then Raw is used in the comparison.

Parameters:

anno - the annotation to check

Returns:

true if anno has UnknownInitialization or Raw

isFbcBottom

public boolean isFbcBottom(org.checkerframework.framework.type.AnnotatedTypeMirror anno)

Does anno have the bottom annotation?

Parameters:

anno - the annotation to check

Returns:

true if anno has FBCBottom or NonRaw

isCommitted

public boolean isCommitted(org.checkerframework.framework.type.AnnotatedTypeMirror anno)

Does anno have the annotation Initialized? If useFbc is false, then NonRaw is used in the comparison.

Parameters:

anno - the annotation to check

Returns:

true if anno has Initialized or NonRaw

createQualifierHierarchyFactory

protected org.checkerframework.framework.util.MultiGraphQualifierHierarchy.MultiGraphFactory createQualifierHierarchyFactory()

Overrides:

createQualifierHierarchyFactory in class org.checkerframework.framework.type.AnnotatedTypeFactory

areAllFieldsCommittedOnly

protected boolean areAllFieldsCommittedOnly(ClassTree classTree)

Are all fields committed-only?

postAsMemberOf

public void postAsMemberOf(org.checkerframework.framework.type.AnnotatedTypeMirror type,
                           org.checkerframework.framework.type.AnnotatedTypeMirror owner,
                           Element element)

In most cases, subclasses want to call this method first because it may clear all annotations and use the hierarchy's root annotations.

Overrides:

postAsMemberOf in class org.checkerframework.framework.type.AnnotatedTypeFactory

getAnnotatedTypeLhs

public org.checkerframework.framework.type.AnnotatedTypeMirror getAnnotatedTypeLhs(Tree lhsTree)

Overrides:

getAnnotatedTypeLhs in class org.checkerframework.framework.type.GenericAnnotatedTypeFactory<Value extends org.checkerframework.framework.flow.CFAbstractValue<Value>,Store extends InitializationStore<Value,Store>,Transfer extends InitializationTransfer<Value,Transfer,Store>,Flow extends org.checkerframework.framework.flow.CFAbstractAnalysis<Value,Store,Transfer>>

getSelfType

public org.checkerframework.framework.type.AnnotatedTypeMirror.AnnotatedDeclaredType getSelfType(Tree tree)

Overrides:

getSelfType in class org.checkerframework.framework.type.AnnotatedTypeFactory

setSelfTypeInInitializationCode

protected void setSelfTypeInInitializationCode(Tree tree,
                                               org.checkerframework.framework.type.AnnotatedTypeMirror.AnnotatedDeclaredType selfType,
                                               TreePath path)

getFreeOrRawAnnotationOfSuperType

protected AnnotationMirror getFreeOrRawAnnotationOfSuperType(TypeMirror type)

Returns a UnderInitialization annotation (or UnknownInitialization if rawness is used) that has the supertype of type as type frame.

getUninitializedInvariantFields

public List<VariableTree> getUninitializedInvariantFields(Store store,
                                                          TreePath path,
                                                          boolean isStatic,
                                                          List<? extends AnnotationMirror> receiverAnnotations)

Returns the (non-static) fields that have the invariant annotation and are not yet initialized in a given store.

getInitializedInvariantFields

public List<VariableTree> getInitializedInvariantFields(Store store,
                                                        TreePath path)

Returns the (non-static) fields that have the invariant annotation and are initialized in a given store.

isInitializedForFrame

public boolean isInitializedForFrame(org.checkerframework.framework.type.AnnotatedTypeMirror type,
                                     TypeMirror frame)

createTypeAnnotator

protected org.checkerframework.framework.type.typeannotator.TypeAnnotator createTypeAnnotator()

Overrides:

createTypeAnnotator in class org.checkerframework.framework.type.GenericAnnotatedTypeFactory<Value extends org.checkerframework.framework.flow.CFAbstractValue<Value>,Store extends InitializationStore<Value,Store>,Transfer extends InitializationTransfer<Value,Transfer,Store>,Flow extends org.checkerframework.framework.flow.CFAbstractAnalysis<Value,Store,Transfer>>

createTreeAnnotator

protected org.checkerframework.framework.type.treeannotator.TreeAnnotator createTreeAnnotator()

Overrides:

createTreeAnnotator in class org.checkerframework.framework.type.GenericAnnotatedTypeFactory<Value extends org.checkerframework.framework.flow.CFAbstractValue<Value>,Store extends InitializationStore<Value,Store>,Transfer extends InitializationTransfer<Value,Transfer,Store>,Flow extends org.checkerframework.framework.flow.CFAbstractAnalysis<Value,Store,Transfer>>