Класс ModuleDescriptor.Version

java.lang.Object

java.lang.module.ModuleDescriptor.Version

Все реализованные интерфейсы:: Comparable<ModuleDescriptor.Version>

Охватывающий класс:: ModuleDescriptor

public static final class ModuleDescriptor.Version extends Object implements Comparable<ModuleDescriptor.Version>

Строка версии модуля.

Строка версии состоит из трех компонентов: собственно номера версии, необязательной предварительной версии и необязательной версии сборки. Каждый компонент представляет собой последовательность токенов; каждый токен — это неотрицательное целое число или строка. Токены разделяются символами пунктуации '.', '-' или '+' либо переходами от последовательности цифр к последовательности символов, не являющихся цифрами или знаками пунктуации, или наоборот. Несколько следующих подряд одинаковых знаков пунктуации считаются одним знаком пунктуации.

Номер версии — это последовательность токенов, разделенных символами '.' и заканчивающаяся первым символом '-' или '+'.
Предварительная версия — это последовательность токенов, разделенных символами '.' или '-' и заканчивающаяся первым символом '+'.
Версия сборки — это последовательность токенов, разделенных символами '.', '-' или '+'.

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

Для двух строк версий, если их номера версий различаются, результатом сравнения будет результат сравнения их номеров версий; в противном случае, если одна из них содержит предварительную версию, а другая нет, первая считается предшествующей второй; в противном случае результатом сравнения будет результат сравнения их предварительных версий; в противном случае результатом сравнения будет результат сравнения их версий сборки.

Начиная с:

См. также:

Краткое описание методов

Модификатор и тип	Метод	Описание
`int`	`compareTo(ModuleDescriptor.Version that)`	Сравнивает версию этого модуля с версией другого модуля.
`boolean`	`equals(Object ob)`	Проверяет, равна ли версия этого модуля заданному объекту.
`int`	`hashCode()`	Вычисляет хеш-код версии этого модуля.
`static ModuleDescriptor.Version`	`parse(String v)`	Разбирает заданную строку как строку версии.
`String`	`toString()`	Возвращает строку, из которой была разобрана эта версия.

Методы, объявленные в классе Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`protected void`	`finalize()`	Устарело и подлежит удалению: этот элемент API может быть удален в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ждать, пока он не будет пробужден, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ждать, пока он не будет пробужден, обычно посредством уведомления или прерывания, либо пока не истечет заданное время.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ждать, пока он не будет пробужден, обычно посредством уведомления или прерывания, либо пока не истечет заданное время.

Подробное описание методов

parse

public static ModuleDescriptor.Version parse(String v)

Разбирает заданную строку как строку версии.

Параметры:: v — строка для разбора
Возвращает:: Результирующий Version
Исключения:: IllegalArgumentException — если v равно null, является пустой строкой или не может быть разобрано как строка версии

compareTo

public int compareTo(ModuleDescriptor.Version that)

Сравнивает версию этого модуля с версией другого модуля. Версии модулей сравниваются так, как описано в описании класса.

Определено в:: compareTo в интерфейсе Comparable<ModuleDescriptor.Version>
Параметры:: that — версия модуля для сравнения
Возвращает:: Отрицательное целое число, ноль или положительное целое число, если версия этого модуля меньше, равна или больше заданной версии модуля соответственно

equals

public boolean equals(Object ob)

Проверяет, равна ли версия этого модуля заданному объекту.

Если заданный объект не является Version, этот метод возвращает false. Две версии модуля равны, если равны соответствующие компоненты.

Этот метод соответствует общему контракту метода Object.equals.

Переопределяет:

equals в классе Object

Параметры:

ob — объект, с которым сравнивается этот объект

Возвращает:

true, если и только если заданный объект является ссылкой на модуль, равной этой ссылке на модуль

См. также:

hashCode

public int hashCode()

Вычисляет хеш-код версии этого модуля.

Хеш-код основан на компонентах версии и соответствует общему контракту метода Object.hashCode.

Переопределяет:

hashCode в классе Object

Возвращает:

Значение хеш-кода версии этого модуля

См. также:

toString

public String toString()

Возвращает строку, из которой была разобрана эта версия.

Переопределяет:: toString в классе Object
Возвращает:: Строка, из которой была разобрана эта версия.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.