Is there a default, class-level annotation that is NOT deprecated that specifies non-null return values by default

Question

Google is failing me. There used to be this annotation: ReturnValuesAreNonnullByDefault.

But this is now deprecated and the javadoc does not indicate which new annotation to use. @Nonnull on the whole class does not apply to return values because I just tested that out and I get no warning for a method returning null. I don't want to have to specifically annotate every single return value, so is there a good option out there?

Answer 1

You can use this answer to build your own simple @EverythingIsNonnullByDefault annotation to apply at the package/class level to cover all cases, or this one which shows you how to create separate annotations to govern fields and method return values. We opted to use them all but tend to apply the "everything" version at the package level.

If you're in a real hurry, copy-n-paste the deprecated annotation and remove the deprecation.

package com.sample;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;

import javax.annotation.meta.TypeQualifierDefault;

/**
 * This annotation can be applied to a package or class to indicate that the 
 * classes' methods in that element all return nonnull values by default
 * unless there is
 * <ul>
 *   <li>an explicit nullness annotation
 *   <li>a default method annotation applied to a more tightly nested element.
 * </ul>
 */
@Documented
@Nonnull
@TypeQualifierDefault(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface ReturnValuesAreNonnullByDefault {
    // feel free to name it MethodsAreNonnullByDefault; I find that confusing
}