org.checkerframework.framework.qual

Annotation Type DefaultQualifier

@Documented
 @Retention(value=SOURCE)
 @Target(value={PACKAGE,TYPE,CONSTRUCTOR,METHOD,FIELD,LOCAL_VARIABLE,PARAMETER})
public @interface DefaultQualifier

Applied to a declaration of a package, type, method, variable, etc., specifies that the given annotation should be the default. The default is applied to type uses within the declaration for which no other annotation is explicitly written. (The default is not applied to the "parametric locations": class declarations, type parameter declarations, and type parameter uses.) If multiple DefaultQualifier annotations are in scope, the innermost one takes precedence. DefaultQualifier takes precedence over DefaultQualifierInHierarchy.

If you wish to write multiple @DefaultQualifier annotations (for unrelated type systems, or with different locations fields) at the same location, use DefaultQualifiers.

This annotation currently has no effect in stub files.

See Also:

TypeUseLocation, DefaultQualifiers, DefaultQualifierInHierarchy, DefaultFor

See the Checker Framework Manual:

Default qualifier for unannotated types

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
java.lang.Class<? extends java.lang.annotation.Annotation>	value The Class for the default annotation.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
TypeUseLocation[]	locations

Element Detail

value

public abstract java.lang.Class<? extends java.lang.annotation.Annotation> value

The Class for the default annotation.

To prevent affecting other type systems, always specify an annotation in your own type hierarchy. (For example, do not set "org.checkerframework.framework.qual.Unqualified" as the default.)

locations

public abstract TypeUseLocation[] locations

Returns:

the locations to which the annotation should be applied

Default:

org.checkerframework.framework.qual.TypeUseLocation.ALL