Annotations for JVM-based languages

A set of Java annotations which can be used in JVM-based languages. They serve as an additional documentation and can be interpreted by IDEs and static analysis tools to improve code analysis.

Change Log | Contributing | Code of Conduct

Documentation

JavaDoc
JavaDoc for legacy Java 5.0 compatible package

Using the annotations

The annotations are published on Maven Central. To add a dependency using gradle write the following in the build.gradle file (Groovy DSL)

dependencies {
    compileOnly 'org.jetbrains:annotations:24.1.0'
}

or in the build.gradle.kts file (Kotlin DSL)

dependencies {
    compileOnly("org.jetbrains:annotations:24.1.0")
}

To add a dependency using Maven, write the following in pom.xml:

<dependency>
  <groupId>org.jetbrains</groupId>
  <artifactId>annotations</artifactId>
  <version>24.1.0</version>
  <scope>provided</scope>
</dependency>

annotations artifact requires JDK 1.8 or higher. If your project is compiled using JDK 1.5, 1.6 or 1.7 you can use the annotations-java5 artifact instead. Please note that annotations-java5 artifact is considered a legacy, so most of new annotations will appear in the annotations artifact only.