So passing nullable type as a type argument or type parameter produces a warning.Īnnotating type arguments and type parameters works with the Java 8 target or higher. Type argumentsĬonsider these annotations on a Java declaration: You can annotate the type arguments and type parameters of generic types to provide nullability information for them as well.Īll examples in the section use JetBrains nullability annotations from the package. Annotating type arguments and type parameters

See the full list of supported nullability annotations in the Kotlin compiler source code. Use the compiler option In the argument, specify the fully qualified nullability annotations package and one of these report levels: You can specify whether the compiler reports a nullability mismatch based on the information from specific types of nullability annotations. JSR-305 ( javax.annotation, more details below)įindBugs ( .findbugs.annotations) JetBrains ( and from the package)Īndroid ( and )

The compiler supports several flavors of nullability annotations, including: Java types that have nullability annotations are represented not as platform types, but as actual nullable or non-null Kotlin types. (Mutable)Collection! means 'Java collection of T may be mutable or not, may be nullable or not',Īrray! means 'Java array of T (or a subtype of T), nullable or not' Nevertheless, the compiler and IDE need to display them sometimes (for example, in error messages or parameter info), so there is a mnemonic notation for them: Notation for platform typesĪs mentioned above, platform types can't be mentioned explicitly in the program, so there's no syntax for them in the language. Overall, the compiler does its best to prevent nulls from propagating far through the program although sometimes this is impossible to eliminate entirely, because of generics. Assertions are also emitted when you pass platform values to Kotlin functions expecting non-null values and in other cases. This prevents Kotlin's non-null variables from holding nulls. If you choose a non-null type, the compiler will emit an assertion upon assignment.

Val notNull: String = item // allowed, may fail at runtime Val nullable: String? = item // allowed, always works

Kotlin java