#1874: Version.java [RU]

Импорты

java.io.Serializable — Версии сериализуются (например, хранятся в записях версий плагинов в БД)
org.apache.commons.lang3.StringUtils — Разделение строк для разбора составных частей версии
org.slf4j.Logger — Логирование через SLF4J (логирование ошибок для некорректных строк версий)

Иерархия классов

Version implements Comparable<Version>, Serializable

Comparable: Обеспечивает естественный порядок — версии можно сортировать в списках, использовать в TreeSet, сравнивать операторами </> в Kotlin
Serializable: Сохраняемые номера версий (serialVersionUID = 1446772593211999270L)

Компоненты версии

Компонент	Поле	Значение по умолчанию/неустановленное	Пример
Мажорный релиз	`majorRelease`	0	3.5.4.2 → major=3
Минорный релиз	`minorRelease`	0	3.5.4.2 → minor=5
Уровень патча	`patchLevel`	0	3.5.4.2 → patch=4
Номер сборки	`buildNumber`	0	3.5.4.2 → build=2
Бета-версия	`betaVersion`	`Integer.MAX_VALUE` (не бета)	3.5b2 → beta=2
RC-версия	`releaseCandidateVersion`	`Integer.MAX_VALUE` (не RC)	3.5rc1 → rc=1
Флаг снапшота	`snapshot`	false	3.5-SNAPSHOT

Формат разбора

Конструктор строк принимает следующие шаблоны (регистронезависимые для суффиксов):

Простой: "3" → major=3
Двухчастный: "3.5" → major=3, minor=5
Трехчастный: "3.5.4" → major=3, minor=5, patch=4
Полный: "3.5.4.2" → major=3, minor=5, patch=4, build=2
Бета: "3.5b2" или "3.5b" → beta=2 или beta=0
Кандидат в релизы: "3.5rc1" или "3.5rc" → rc=1 или rc=0
Снапшот: "3.5-SNAPSHOT" или "3.5-snapshot" → snapshot=true
Комбинированный: "3.5.4.2b2-SNAPSHOT"

Логика сравнения (compareTo)

Сравнение следует строгой иерархии:

Мажорный релиз → Минорный релиз → Уровень патча → Номер сборки (числовое сравнение)
Релиз vs Пре-релиз: Если версии различаются по статусу пре-релиза:
- Обычный релиз ВЫШЕ, чем RC
- RC ВЫШЕ, чем бета
- Бета НИЖЕ, чем обычный релиз
Если обе RC: сравнить номера RC-версий
Если обе бета: сравнить номера бета-версий

Этот порядок гарантирует: 3.5b1 < 3.5rc1 < 3.5 — критически важно для определения необходимости миграции БД или обновления плагина.

Особая обработка: Заполнитель Gradle

Метод parseInt() обнаруживает неразвернутый токен Gradle "gradle.version" и обрабатывает его как 0, записывая предупреждение. Это обрабатывает случай, когда информация о версии компилируется в JAR во время сборки, а свойство версии Gradle еще не разрешено (например, при тестовых запусках в IDE).

Формат toString()

3.5 (patch=0, build=0) → "3.5"
3.5.4 (patch≠0, build=0) → "3.5.4"
3.5.4.2 (все части) → "3.5.4.2"
3.5b2 (бета) → "3.5b2"
3.5rc1 (RC) → "3.5rc1"
3.5-SNAPSHOT (снапшот) → "3.5-SNAPSHOT"

Использование Integer.MAX_VALUE в качестве сигнального значения для "не бета/RC" — элегантное проектное решение. Оно гарантирует, что при числовом сравнении не-бета версия всегда сравнивается как более высокая, чем любая бета-версия (поскольку MAX_VALUE — это максимально возможное целое число), при этом все еще допуская прямое числовое сравнение, когда обе версии бета/RC.

Метод compareTo НЕ учитывает флаг снапшота при упорядочивании. Две версии, различающиеся только статусом снапшота (например, "3.5" vs "3.5-SNAPSHOT"), будут сравниваться как равные. Это может быть намеренно — снапшоты указывают на метаданные времени сборки, а не на семантические различия версий.

#1874: `Version.java`

Архитектура