Интерфейс Имени

Все суперинтерфейсы:: Cloneable, Comparable<Object>, Serializable

Все известные реализующие классы:: CompositeName, CompoundName, LdapName

public interface Name extends Cloneable, Serializable, Comparable<Object>

Интерфейс Name представляет собой общее имя — упорядоченную последовательность компонентов. Это может быть составное имя (имена, охватывающие несколько пространств имен) или составное имя (имена, используемые в отдельных иерархических системах именования).

Может быть несколько реализаций Name; например, составные имена, URL-адреса или составные имена, специфичные для пространства имен.

Компоненты имени пронумерованы. Индексы имени с N компонентами варьируются от 0 до, но не включая, N. Этот диапазон можно записать как [0,N). Наиболее значимый компонент находится в индексе 0. Пустое имя не имеет компонентов.

Ни один из методов в этом интерфейсе не принимает null в качестве допустимого значения для параметра, являющегося именем или компонентом имени. Аналогично, методы, возвращающие имя или компонент имени, никогда не возвращают null.

Экземпляр Name не может быть синхронизирован против одновременного доступа в нескольких потоках, если этот доступ не является только для чтения.

С момента:: 1.3

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final long`	`serialVersionUID`	Устаревшее. Поле `serialVersionUID` в интерфейсе неэффективно.

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

Модификатор и тип	Метод	Описание
`Name`	`add(int posn, String comp)`	Добавляет один компонент в указанную позицию в этом имени.
`Name`	`add(String comp)`	Добавляет один компонент в конец этого имени.
`Name`	`addAll(int posn, Name n)`	Добавляет компоненты имени — в порядке — в указанную позицию в этом имени.
`Name`	`addAll(Name suffix)`	Добавляет компоненты имени — в порядке — в конец этого имени.
`Object`	`clone()`	Создаёт новую копию этого имени.
`int`	`compareTo(Object obj)`	Сравнивает это имя с другим именем по порядку.
`boolean`	`endsWith(Name n)`	Определяет, заканчивается ли это имя указанным суффиксом.
`String`	`get(int posn)`	Возвращает компонент этого имени.
`Enumeration<String>`	`getAll()`	Возвращает компоненты этого имени в виде перечисления строк.
`Name`	`getPrefix(int posn)`	Создаёт имя, компоненты которого состоят из префикса компонентов этого имени.
`Name`	`getSuffix(int posn)`	Создаёт имя, компоненты которого состоят из суффикса компонентов в этом имени.
`boolean`	`isEmpty()`	Определяет, является ли это имя пустым.
`Object`	`remove(int posn)`	Удаляет компонент из этого имени.
`int`	`size()`	Возвращает количество компонентов в этом имени.
`boolean`	`startsWith(Name n)`	Определяет, начинается ли это имя с указанного префикса.

Подробное описание полей

serialVersionUID

@Deprecated static final long serialVersionUID

Устарело.

Поле serialVersionUID в интерфейсе неэффективно. Не использовать; замены нет.

Отпечаток класса, который установлен для указания совместимости сериализации с предыдущей версией класса.

См. также:

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

clone

Object clone()

Создаёт новую копию этого имени. Последующие изменения компонентов этого имени не повлияют на новую копию, и наоборот.

Возвращает:

копию этого имени

См. также:

compareTo

int compareTo(Object obj)

Сравнивает это имя с другим именем для определения порядка. Возвращает отрицательное целое число, ноль или положительное целое число, если это имя меньше, равно или больше заданного имени.

Как и в случае с Object.equals(), понятие порядка для имён зависит от класса, который реализует этот интерфейс. Например, порядок может быть основан на лексикографическом порядке компонентов имени. Конкретные атрибуты имени, такие как обработка регистра, могут повлиять на порядок. В общем случае, два имени разных классов нельзя сравнивать.

Определено в:

compareTo в интерфейсе Comparable<Object>

Параметры:

obj - непустой объект для сравнения.

Возвращает:

отрицательное целое число, ноль или положительное целое число, если это имя меньше, равно или больше заданного имени

Использует:

ClassCastException - если obj не является Name типа, который может быть сравнен с этим именем

См. также:

size

int size()

Возвращает количество компонентов в этом имени.

Возвращает:: количество компонентов в этом имени

isEmpty

boolean isEmpty()

Определяет, пусто ли это имя. Пустое имя имеет ноль компонентов.

Возвращает:: true, если это имя пусто, иначе false

getAll

Enumeration<String> getAll()

Извлекает компоненты этого имени как перечисление строк. Эффект на перечислении обновлений этого имени не определён. Если имя имеет ноль компонентов, возвращается пустое (не null) перечисление.

Возвращает:: перечисление компонентов этого имени, каждое из которых является строкой

get

String get(int posn)

Извлекает компонент этого имени.

Параметры:: posn - индекс компонента, который нужно извлечь, с нуля. Должен находиться в диапазоне [0,size()).
Возвращает:: компонент по индексу posn
Использует:: ArrayIndexOutOfBoundsException - если posn выходит за указанный диапазон

getPrefix

Name getPrefix(int posn)

Создаёт имя, компоненты которого состоят из префикса компонентов этого имени. Последующие изменения этого имени не повлияют на возвращаемое имя и наоборот.

Параметры:: posn - индекс компонента, с которого нужно остановиться, с нуля. Должен находиться в диапазоне [0,size()].
Возвращает:: имя, состоящее из компонентов с индексами в диапазоне [0,posn).
Использует:: ArrayIndexOutOfBoundsException - если posn выходит за указанный диапазон

getSuffix

Name getSuffix(int posn)

Создаёт имя, компоненты которого состоят из суффикса компонентов этого имени. Последующие изменения имени не влияют на возвращаемое имя и наоборот.

Параметры:: posn - индекс компонента, с которого нужно начать, с нуля. Должен находиться в диапазоне [0,size()].
Возвращает:: имя, состоящее из компонентов с индексами в диапазоне [posn,size()). Если posn равно size(), возвращается пустое имя.
Использует:: ArrayIndexOutOfBoundsException - если posn выходит за указанный диапазон

startsWith

boolean startsWith(Name n)

Определяет, начинается ли это имя с указанного префикса. Имя n является префиксом, если оно равно getPrefix(n.size()).

Параметры:: n - имя для проверки
Возвращает:: true, если n является префиксом этого имени, иначе false

endsWith

boolean endsWith(Name n)

Определяет, заканчивается ли это имя указанным суффиксом. Имя n является суффиксом, если оно равно getSuffix(size()-n.size()).

Параметры:: n - имя для проверки
Возвращает:: true, если n является суффиксом этого имени, иначе false

addAll

Name addAll(Name suffix) throws InvalidNameException

Добавляет компоненты имени — в порядке — в конец этого имени.

Параметры:: suffix - компоненты для добавления
Возвращает:: обновлённое имя (не новое)
Использует:: InvalidNameException - если suffix не является допустимым именем, или если добавление компонентов нарушит правила синтаксиса этого имени

addAll

Name addAll(int posn, Name n) throws InvalidNameException

Добавляет компоненты имени — в порядке — в указанную позицию внутри этого имени. Компоненты этого имени в позиции или после индекса первого нового компонента сдвигаются вверх (в сторону от 0) для размещения новых компонентов.

Параметры:: posn - индекс в этом имени, в который следует добавить новые компоненты. Должен находиться в диапазоне [0,size()].; n - компоненты для добавления
Возвращает:: обновлённое имя (не новое)
Использует:: ArrayIndexOutOfBoundsException - если posn выходит за указанный диапазон; InvalidNameException - если n не является допустимым именем, или если добавление компонентов нарушит правила синтаксиса этого имени

add

Name add(String comp) throws InvalidNameException

Добавляет один компонент в конец этого имени.

Параметры:: comp - компонент для добавления
Возвращает:: обновлённое имя (не новое)
Использует:: InvalidNameException - если добавление comp нарушит правила синтаксиса этого имени

add

Name add(int posn, String comp) throws InvalidNameException

Добавляет один компонент в указанную позицию внутри этого имени. Компоненты этого имени в позиции или после индекса нового компонента смещаются вверх на один (в сторону от индекса 0) для размещения нового компонента.

Параметры:: posn - индекс, в который нужно добавить новый компонент. Должен находиться в диапазоне [0,size()].; comp - компонент для добавления
Возвращает:: обновлённое имя (не новое)
Использует:: ArrayIndexOutOfBoundsException - если posn выходит за указанный диапазон; InvalidNameException - если добавление comp нарушит правила синтаксиса этого имени

remove

Object remove(int posn) throws InvalidNameException

Удаляет компонент из этого имени. Компонент этого имени в указанной позиции удаляется. Компоненты с индексами больше этой позиции сдвигаются вниз (в сторону индекса 0) на один.

Параметры:: posn - индекс компонента, который нужно удалить. Должен находиться в диапазоне [0,size()).
Возвращает:: удаленный компонент (строка)
Использует:: ArrayIndexOutOfBoundsException - если posn выходит за указанный диапазон; InvalidNameException - если удаление компонента нарушит правила синтаксиса имени

© 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.naming/javax/naming/Name.html