org.checkerframework.framework.util

Class GraphQualifierHierarchy

java.lang.Object

org.checkerframework.framework.type.QualifierHierarchy

org.checkerframework.framework.util.MultiGraphQualifierHierarchy

org.checkerframework.framework.util.GraphQualifierHierarchy

Direct Known Subclasses:

FenumAnnotatedTypeFactory.FenumQualifierHierarchy, UnitsAnnotatedTypeFactory.UnitsQualifierHierarchy

public class GraphQualifierHierarchy
extends MultiGraphQualifierHierarchy

Represents the type qualifier hierarchy of a type system.

This class is immutable and can be only created through MultiGraphQualifierHierarchy.MultiGraphFactory.

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

Constructor Summary

Constructors

Constructor and Description
GraphQualifierHierarchy(MultiGraphQualifierHierarchy.MultiGraphFactory f, AnnotationMirror bottom)

Method Summary

Modifier and Type	Method and Description
protected void	finish(QualifierHierarchy qualHierarchy, Map<AnnotationMirror,Set<AnnotationMirror>> fullMap, Map<AnnotationMirror,AnnotationMirror> polyQualifiers, Set<AnnotationMirror> tops, Set<AnnotationMirror> bottoms, Object... args) Method to finalize the qualifier hierarchy before it becomes unmodifiable.
Set<? extends AnnotationMirror>	getBottomAnnotations()
Set<? extends AnnotationMirror>	getTopAnnotations() Returns the top qualifiers for this hierarchy.
boolean	isSubtype(Collection<? extends AnnotationMirror> rhs, Collection<? extends AnnotationMirror> lhs) Tests whether there is any annotation in lhs that is a super qualifier of some annotation in rhs.

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

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

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

canHaveEmptyAnnotationSet, findAnnotationInHierarchy, findAnnotationInSameHierarchy, getWidth, greatestLowerBound, greatestLowerBounds, greatestLowerBounds, greatestLowerBoundsTypeVariable, isSubtype, isSubtype, isValid, leastUpperBound, leastUpperBounds, leastUpperBounds, leastUpperBoundsTypeVariable, numberOfIterationsBeforeWidening, replacePolyAll, updateMappingToMutableSet, widenedUpperBound

Methods inherited from class java.lang.Object

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

Constructor Detail

GraphQualifierHierarchy

public GraphQualifierHierarchy(MultiGraphQualifierHierarchy.MultiGraphFactory f,
                               AnnotationMirror bottom)

Method Detail

finish

protected void finish(QualifierHierarchy qualHierarchy,
                      Map<AnnotationMirror,Set<AnnotationMirror>> fullMap,
                      Map<AnnotationMirror,AnnotationMirror> polyQualifiers,
                      Set<AnnotationMirror> tops,
                      Set<AnnotationMirror> bottoms,
                      Object... args)

Description copied from class: MultiGraphQualifierHierarchy

Method to finalize the qualifier hierarchy before it becomes unmodifiable. The parameters pass all fields and allow modification.

Overrides:

finish in class MultiGraphQualifierHierarchy

getTopAnnotations

public Set<? extends AnnotationMirror> getTopAnnotations()

Returns the top qualifiers for this hierarchy. Returns multiple values for a compound checker (such as the Nullness Checker).

The top qualifier is inferred from the hierarchy, as being the only one without any super qualifiers

Overrides:

getTopAnnotations in class MultiGraphQualifierHierarchy

Returns:

the top (ultimate super) type qualifiers in the type system

getBottomAnnotations

public Set<? extends AnnotationMirror> getBottomAnnotations()

Overrides:

getBottomAnnotations in class MultiGraphQualifierHierarchy

Returns:

the bottom type qualifier in the hierarchy

isSubtype

public boolean isSubtype(Collection<? extends AnnotationMirror> rhs,
                         Collection<? extends AnnotationMirror> lhs)

Description copied from class: QualifierHierarchy

Tests whether there is any annotation in lhs that is a super qualifier of some annotation in rhs. lhs and rhs contain only the annotations, not the Java type.

Overrides:

isSubtype in class MultiGraphQualifierHierarchy

Returns:

true iff an annotation in lhs is a super of one in rhs