Класс Runtime.Version

Представление строки версии для реализации платформы Java SE. Строка версии состоит из номера версии, за которым могут следовать информация о предварительной версии и сборке.

Номера версий

Номер версии, $VNUM, представляет собой непустую последовательность элементов, разделенных точками (U+002E). Элемент либо равен нулю, либо является целым неотрицательным числом без ведущих нулей. Последний элемент номера версии не должен быть нулём. При инкрементировании элемента все последующие элементы удаляются. Формат:

[1-9][0-9]*((\.0)*\.[1-9][0-9]*)*

Последовательность может иметь произвольную длину, но первые четыре элемента имеют определённое значение:

$FEATURE.$INTERIM.$UPDATE.$PATCH

• $FEATURE — Счётчик релиза функций, увеличивается при каждом релизе функций независимо от содержимого релиза. Функции могут быть добавлены в релиз функций, а также удалены, если об этом было сообщено не менее чем за один релиз функций до этого. Несовместимые изменения могут быть внесены, если это оправдано.

• $INTERIM — Счётчик промежуточного релиза, увеличивается для релизов, не содержащих функций, которые содержат совместимые исправления ошибок и улучшения, но не содержат несовместимых изменений, удаления функций и изменений стандартных API.

• $UPDATE — Счётчик релиза обновления, увеличивается для совместимых обновлений, которые исправляют проблемы безопасности, регрессии и ошибки в новых функциях.

• $PATCH — Счётчик экстренного патча, увеличивается только при необходимости создания экстренного релиза для исправления критической проблемы.

Пятый и последующие элементы номера версии предназначены для использования разработчиками платформ для идентификации специфичных для реализаций патчей.

Номер версии никогда не имеет завершающих нулевых элементов. Если элемент и все последующие логически имеют значение ноль, то они опускаются.

Последовательность чисел в номере версии сравнивается с другой подобной последовательностью по порядку; например, 10.0.4 меньше, чем 10.1.2. Если одна последовательность короче другой, то отсутствующие элементы короче последовательности считаются меньшими, чем соответствующие элементы более длинной последовательности; например, 10.0.2 меньше, чем 10.0.2.1.

Строки версий

Строка версии, $VSTR, представляет собой номер версии $VNUM, как описано выше, с дополнительной информацией о предварительной версии и сборке в одном из следующих форматов:

$VNUM(-$PRE)?\+$BUILD(-$OPT)?
$VNUM-$PRE(-$OPT)?
$VNUM(+-$OPT)?

где:

• $PRE, соответствующий ([a-zA-Z0-9]+) — Идентификатор предварительной версии. Обычно ea, для потенциально нестабильного раннего доступа, находящегося в активной разработке, или internal, для внутренней сборки разработчиков.

• $BUILD, соответствующий (0|[1-9][0-9]*) — Номер сборки, увеличивается при каждом продвижении сборки. $BUILD сбрасывается до 1 при инкрементировании любой части $VNUM.

• $OPT, соответствующий ([-a-zA-Z0-9.]+) — Дополнительная информация о сборке, если требуется. В случае сборки internal она часто содержит дату и время сборки.

Строка версии 10-ea соответствует $VNUM = "10" и $PRE = "ea". Строка версии 10+-ea соответствует $VNUM = "10" и $OPT = "ea".

При сравнении двух строк версии значение $OPT, если оно присутствует, может или не может иметь значение в зависимости от выбранного метода сравнения. Методы сравнения compareTo() и compareToIgnoreOptional() должны использоваться последовательно с соответствующими методами equals() и equalsIgnoreOptional().

Короткая строка версии, $SVSTR, часто полезная в менее формальных контекстах, представляет собой номер версии, за которым необязательно следует идентификатор предварительной версии:

$VNUM(-$PRE)?

Это класс базирующийся на значениях; использование операций, чувствительных к идентификатору (включая равенство ссылок (==), хэш-код идентификатора или синхронизацию) на экземплярах Version может привести к непредсказуемым результатам и следует избегать.