Package org.checkerframework.framework.type

Class SubtypeIsSubsetQualifierHierarchy

java.lang.Object

org.checkerframework.framework.type.QualifierHierarchy

org.checkerframework.framework.type.ElementQualifierHierarchy

org.checkerframework.framework.type.MostlyNoElementQualifierHierarchy

org.checkerframework.framework.type.SubtypeIsSubsetQualifierHierarchy

@AnnotatedFor("nullness")
public class SubtypeIsSubsetQualifierHierarchy
extends MostlyNoElementQualifierHierarchy

A QualifierHierarchy where, when a qualifier has arguments, the subtype relation is determined by a subset test on the elements (arguments). The elements must be strings.

This assumes that if the lub or glb of two qualifiers has elements, then both of the arguments had the same kind as the result does.

Field Summary

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

bottoms, bottomsMap, kindToElementlessQualifier, qualifierKindHierarchy, tops, topsMap

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

atypeFactory

Constructor Summary

Constructors

Constructor	Description
SubtypeIsSubsetQualifierHierarchy(Collection<Class<? extends Annotation>> qualifierClasses, ProcessingEnvironment processingEnv, GenericAnnotatedTypeFactory<?,?,?,?> atypeFactory)	Creates a SubtypeIsSubsetQualifierHierarchy from the given classes.

Method Summary

Modifier and Type	Method	Description
protected AnnotationMirror	greatestLowerBoundWithElements(AnnotationMirror a1, QualifierKind qualifierKind1, AnnotationMirror a2, QualifierKind qualifierKind2, QualifierKind glbKind)	Returns the greatest lower bound of a1 and a2 in cases where the glb of qualifierKind1 and qualifierKind2 is a qualifier kind that has elements.
protected boolean	isSubtypeWithElements(AnnotationMirror subAnno, QualifierKind subKind, AnnotationMirror superAnno, QualifierKind superKind)	Returns true if subAnno is a subtype of superAnno.
protected AnnotationMirror	leastUpperBoundWithElements(AnnotationMirror a1, QualifierKind qualifierKind1, AnnotationMirror a2, QualifierKind qualifierKind2, QualifierKind lubKind)	Returns the least upper bound of a1 and a2 in cases where the lub of qualifierKind1 and qualifierKind2 is a qualifier kind that has elements.

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

greatestLowerBoundQualifiers, isSubtypeQualifiers, leastUpperBoundQualifiers

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

createBottomsMap, createElementlessQualifierMap, createQualifierKindHierarchy, createTopsMap, findAnnotationInHierarchy, findAnnotationInSameHierarchy, getBottomAnnotation, getBottomAnnotations, getPolymorphicAnnotation, getQualifierKind, getQualifierKind, getTopAnnotation, getTopAnnotations, isPolymorphicQualifier, isValid

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

assertSameSize, assertSameSize, canHaveEmptyAnnotationSet, getWidth, greatestLowerBoundQualifiersOnly, greatestLowerBoundShallow, greatestLowerBoundsShallow, isSubtypeQualifiersOnly, isSubtypeShallow, isSubtypeShallow, isSubtypeShallow, isSubtypeShallow, leastUpperBoundQualifiersOnly, leastUpperBoundShallow, leastUpperBoundsShallow, numberOfIterationsBeforeWidening, updateMappingToMutableSet, widenedUpperBound

Methods inherited from class java.lang.Object

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

Constructor Details

SubtypeIsSubsetQualifierHierarchy

public SubtypeIsSubsetQualifierHierarchy(Collection<Class<? extends Annotation>> qualifierClasses,
 ProcessingEnvironment processingEnv,
 GenericAnnotatedTypeFactory<?,?,?,?> atypeFactory)

Creates a SubtypeIsSubsetQualifierHierarchy from the given classes.

Parameters:

qualifierClasses - classes of annotations that are the qualifiers for this hierarchy

processingEnv - processing environment

atypeFactory - the associated type factory

Method Details

isSubtypeWithElements

protected boolean isSubtypeWithElements(AnnotationMirror subAnno,
 QualifierKind subKind,
 AnnotationMirror superAnno,
 QualifierKind superKind)

Description copied from class: MostlyNoElementQualifierHierarchy

Returns true if subAnno is a subtype of superAnno. Both subAnno and superAnno are annotations with elements. subKind is a sub qualifier kind of superKind.

Specified by:

isSubtypeWithElements in class MostlyNoElementQualifierHierarchy

Parameters:

subAnno - possible subtype annotation; has elements

subKind - the QualifierKind of subAnno

superAnno - possible super annotation; has elements

superKind - the QualifierKind of superAnno

Returns:

true if subAnno is a subtype of superAnno

leastUpperBoundWithElements

protected AnnotationMirror leastUpperBoundWithElements(AnnotationMirror a1,
 QualifierKind qualifierKind1,
 AnnotationMirror a2,
 QualifierKind qualifierKind2,
 QualifierKind lubKind)

Description copied from class: MostlyNoElementQualifierHierarchy

Returns the least upper bound of a1 and a2 in cases where the lub of qualifierKind1 and qualifierKind2 is a qualifier kind that has elements. If the lub of qualifierKind1 and qualifierKind2 does not have elements, then QualifierHierarchy.leastUpperBoundShallow(AnnotationMirror, TypeMirror, AnnotationMirror, TypeMirror) returns the correct AnnotationMirror without calling this method.

Specified by:

leastUpperBoundWithElements in class MostlyNoElementQualifierHierarchy

Parameters:

a1 - first annotation

qualifierKind1 - QualifierKind for a1

a2 - second annotation

qualifierKind2 - QualifierKind for a2

lubKind - the kind of the lub of qualifierKind1 and qualifierKind2

Returns:

the least upper bound of a1 and a2

greatestLowerBoundWithElements

protected AnnotationMirror greatestLowerBoundWithElements(AnnotationMirror a1,
 QualifierKind qualifierKind1,
 AnnotationMirror a2,
 QualifierKind qualifierKind2,
 QualifierKind glbKind)

Description copied from class: MostlyNoElementQualifierHierarchy

Returns the greatest lower bound of a1 and a2 in cases where the glb of qualifierKind1 and qualifierKind2 is a qualifier kind that has elements. If the glb of qualifierKind1 and qualifierKind2 does not have elements, then QualifierHierarchy.greatestLowerBoundShallow(AnnotationMirror, TypeMirror, AnnotationMirror, TypeMirror) returns the correct AnnotationMirror without calling this method.

Specified by:

greatestLowerBoundWithElements in class MostlyNoElementQualifierHierarchy

Parameters:

a1 - first annotation

qualifierKind1 - QualifierKind for a1

a2 - second annotation

qualifierKind2 - QualifierKind for a2

Returns:

the greatest lower bound between a1 and a2