org.checkerframework.common.reflection

Class MethodValAnnotatedTypeFactory.MethodValQualifierHierarchy

java.lang.Object

org.checkerframework.framework.type.QualifierHierarchy

org.checkerframework.framework.util.MultiGraphQualifierHierarchy

org.checkerframework.common.reflection.MethodValAnnotatedTypeFactory.MethodValQualifierHierarchy

Enclosing class:

MethodValAnnotatedTypeFactory

protected class MethodValAnnotatedTypeFactory.MethodValQualifierHierarchy
extends MultiGraphQualifierHierarchy

Nested Class Summary

Nested classes/interfaces inherited from class org.checkerframework.framework.util.MultiGraphQualifierHierarchy

MultiGraphQualifierHierarchy.MultiGraphFactory

Field Summary

Fields inherited from class org.checkerframework.framework.util.MultiGraphQualifierHierarchy

bottoms, polymorphicQualifier, polyQualifiers, supertypesGraph, supertypesMap, tops, typeQualifiers

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	MethodValQualifierHierarchy(MultiGraphQualifierHierarchy.MultiGraphFactory factory, AnnotationMirror bottom)

Method Summary

Modifier and Type	Method and Description
boolean	isSubtype(AnnotationMirror sub, AnnotationMirror sup) Tests whether rhs is equal to or a sub-qualifier of lhs, according to the type qualifier hierarchy.
AnnotationMirror	leastUpperBound(AnnotationMirror a1, AnnotationMirror a2) Returns the least upper bound for the qualifiers a1 and a2.

Methods inherited from class org.checkerframework.framework.util.MultiGraphQualifierHierarchy

addPolyRelations, buildFullMap, findBottoms, findLub, findTops, finish, getBottomAnnotation, getBottomAnnotations, getPolymorphicAnnotation, getTopAnnotation, getTopAnnotations, getTypeQualifiers, greatestLowerBound, greatestLowerBoundTypeVariable, isSubtype, isSubtypeTypeVariable, isSubtypeTypeVariable, leastUpperBoundTypeVariable, toString

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

canHaveEmptyAnnotationSet, findAnnotationInHierarchy, findAnnotationInSameHierarchy, findCorrespondingAnnotation, getAnnotationInHierarchy, getWidth, greatestLowerBound, greatestLowerBounds, greatestLowerBounds, greatestLowerBoundsTypeVariable, isSubtype, isSubtype, isValid, leastUpperBound, leastUpperBounds, leastUpperBounds, leastUpperBoundsTypeVariable, replacePolyAll, updateMappingToMutableSet

Methods inherited from class java.lang.Object

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

Constructor Detail

MethodValQualifierHierarchy

protected MethodValQualifierHierarchy(MultiGraphQualifierHierarchy.MultiGraphFactory factory,
                                      AnnotationMirror bottom)

Method Detail

leastUpperBound

public AnnotationMirror leastUpperBound(AnnotationMirror a1,
                                        AnnotationMirror a2)

Description copied from class: QualifierHierarchy

Returns the least upper bound for the qualifiers a1 and a2.

Examples:

• For NonNull, leastUpperBound('Nullable', 'NonNull') ⇒ Nullable

The two qualifiers have to be from the same qualifier hierarchy. Otherwise, null will be returned.

Overrides:

leastUpperBound in class MultiGraphQualifierHierarchy

Returns:

the least restrictive qualifiers for both types

isSubtype

public boolean isSubtype(AnnotationMirror sub,
                         AnnotationMirror sup)

Description copied from class: MultiGraphQualifierHierarchy

Tests whether rhs is equal to or a sub-qualifier of lhs, according to the type qualifier hierarchy. This checks only the qualifiers, not the Java type.

Most qualifiers have no value fields. However, two annotations with values are subtype of each other only if they have the same values. i.e. I(m) is a subtype of I(n) iff m = n

When client specifies an annotation, a1, to be a subtype of annotation with values, a2, then a1 is a subtype of all instances of a2 regardless of a2 values.

Overrides:

isSubtype in class MultiGraphQualifierHierarchy

Parameters:

sub - the right-hand side, i.e. the sub qualifier

sup - the left-hand side, i.e. the super qualifier

Returns:

true iff rhs is a sub qualifier of lhs