public final Enum DefaultLocation

Defines that a given NonNullByDefault annotation should affect all unannotated array components within the scope of the annotated declaration.

Example

 @NonNullByDefault(ARRAY_CONTENTS)
interface X {
    Number[] n1;
    Number[][] n2;
}

These declarations are interpreted as:

    @NonNull Number [] n1;
   @NonNull Number [] @NonNull[] n2;

I.e., both fields can still be null (see the unannotated left-most pair of brackets) but none of the contents of these arrays is allowed to be null (at any dimension).

Defines that a given NonNullByDefault annotation should affect all unannotated field types within the scope of the annotated declaration.

Example

 @NonNullByDefault(FIELD)
class X {
    Number number = Integer.MAX_VALUE;
}

Here Number will be interpreted as @NonNull Number.

Defines that a given NonNullByDefault annotation should affect all unannotated parameters of any method or constructor within the scope of the annotated declaration.

Example

 @NonNullByDefault(PARAMETER)
interface X {
    void print(Number n);
}

Here Number will be interpreted as @NonNull Number.

Defines that a given NonNullByDefault annotation should affect all unannotated method return types within the scope of the annotated declaration.

Example

 @NonNullByDefault(RETURN_TYPE)
interface X {
    Number getNumber();
}

Here Number will be interpreted as @NonNull Number.

Defines that a given NonNullByDefault annotation should affect all unannotated type arguments within the scope of the annotated declaration (except wildcards and type variables).

Example

 @NonNullByDefault(TYPE_ARGUMENT)
interface X<T> {
    void process(List<T> tl, List<Number> nl);
}

Here Number will be interpreted as @NonNull Number, but the use of type variable T is not affected.

Defines that a given NonNullByDefault annotation should affect all unannotated explicit type bounds within the scope of the annotated declaration. A type bound of type java.lang.Object is never considered as an explicit bound, i.e., T extends Object is never affected by NonNullByDefault.

Example

 @NonNullByDefault(TYPE_BOUND)
interface X {
    <T extends Number> void process(T t, List<? super Number> l);
}

Here both occurrences of Number will be interpreted as @NonNull Number.

Defines that a given NonNullByDefault annotation should affect all unannotated type parameter declarations within the scope of the annotated declaration.

Example

 @NonNullByDefault(TYPE_PARAMETER)
class X {
    <T> T identity(T t) { return t; }
}

Here <T> will be interpreted as <@NonNull T>.