2.1.0-RC1

Этот предварительный выпуск совместим с предыдущим стабильным.

Подробнее о релизе: 2.0.0...2.1.0-RC1

Maven

<repository>
  <id>ossrh-rc</id>
  <name>OSSRH RC</name>
  <url>https://s01.oss.sonatype.org/content/repositories/releases/</url>
</repository>

<dependency>
  <groupId>com.bloogefest</groupId>
  <artifactId>annotation</artifactId>
  <version>2.1.0-RC1</version>
</dependency>

Gradle

repositories {
    maven {
        name = "OSSRH RC"
        url = uri("https://s01.oss.sonatype.org/content/repositories/releases/")
    }
}

dependencies {
    implementation("com.bloogefest:annotation:2.1.0-RC1")
}

Введено:

Аннотации:

• Enumed

Перечисление значений.

API Note: Уведомляет о предполагаемых значениях.

boolean toBoolean(final @Enumed({0, 1}) int value) {
    return value == 0 ? false : true;
}

• Enumed::value()

Возвращает предполагаемые значения.

Returns: Предполагаемые значения.

Implementation Requirements: Предполагаемые значения не должны повторяться.

boolean toBoolean(final @Enumed({0, 1}) int value) {
    return value == 0 ? false : true;
}

• Experimental::value()

Возвращает идентификатор выпуска, в котором ожидается, что состояние чего-то будет изменено.

Returns: Идентификатор выпуска, в котором ожидается, что состояние чего-то будет изменено.

@Experimental("3.7.4-RC1")
void work() {
    System.gc();
}

• Magical

Магическое значение.

API Note: Уведомляет о магическом значении, содержащимся в поле или локальной переменной.

void operate(final @Magical int code) {
    final @Magical var limit = 256;
    if (code > limit) System.gc();
}

• Range

Диапазон числовых значений.

API Note: Позволяет задать диапазон числовых значений.

void operate(final @Range(from = 0, to = 256) int code) {
    if (code == 0) System.gc();
}

Изменено:

Аннотации:

• Contract

Изменена документация.

• Contract::value()

Изменена документация — я добавил описание синтаксиса.
Изменена сигнатура.

• Contract::pure()

Изменена документация.
Изменена сигнатура.

• Experimental

Изменена документация.

• Nls

Изменена документация.
Изменено тело.

• NotNls

Изменена документация.
Изменено тело.

• NotNull

Изменена документация.
Изменено тело.

• Null

Изменена документация.
Изменено тело.

• Nullable

Изменена документация.
Изменено тело.

• Obsolete

Изменена документация.

• Obsolete::value()

Изменена документация.
Изменена сигнатура.

• Removal

Изменена документация.

• Removal::value()

Изменена документация.
Изменена сигнатура.

Другое:

• com.bloogefest.annotation.analysis

Изменена документация.

• com.bloogefest.annotation

Изменена документация.