Класс LdapName

public LdapName(String name) throws InvalidNameException

Параметры:

name — это ненулевое различающееся имя, отформатированное в соответствии с правилами, определенными в RFC 2253.

Исключения:

InvalidNameException — если обнаружено нарушение синтаксиса.

См. также:

• Rdn.escapeValue(Object value)

public LdapName(List<Rdn> rdns)

Параметры:

rdns — ненулевой список Rdn, образующих это имя LDAP.

public int size()

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

size в интерфейсе Name

Возвращает:

Неотрицательное количество компонентов в этом имени LDAP.

public boolean isEmpty()

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

isEmpty в интерфейсе Name

Возвращает:

true, если это имя LDAP пусто, и false в противном случае.

public Enumeration<String> getAll()

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

getAll в интерфейсе Name

Возвращает:

Ненулевое перечисление компонентов этого имени LDAP. Каждый элемент перечисления имеет класс String.

public String get(int posn)

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

get в интерфейсе Name

Параметры:

posn — индекс компонента для извлечения, отсчитываемый от 0. Должен находиться в диапазоне [0,size()).

Возвращает:

Ненулевой компонент с индексом posn.

Исключения:

IndexOutOfBoundsException — если posn выходит за пределы указанного диапазона.

public Rdn getRdn(int posn)

Параметры:

posn — индекс RDN для извлечения, отсчитываемый от 0. Должен находиться в диапазоне [0,size()).

Возвращает:

Ненулевой RDN с индексом posn.

Исключения:

IndexOutOfBoundsException — если posn выходит за пределы указанного диапазона.

public Name getPrefix(int posn)

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

getPrefix в интерфейсе Name

Параметры:

posn — индекс компонента, на котором следует остановиться, отсчитываемый от 0. Должен находиться в диапазоне [0,size()].

Возвращает:

Экземпляр LdapName, состоящий из компонентов с индексами в диапазоне [0,posn). Если posn равен нулю, возвращается пустое имя LDAP.

Исключения:

IndexOutOfBoundsException — если posn выходит за пределы указанного диапазона.

public Name getSuffix(int posn)

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

getSuffix в интерфейсе Name

Параметры:

posn — индекс компонента, с которого следует начать, отсчитываемый от 0. Должен находиться в диапазоне [0,size()].

Возвращает:

Экземпляр LdapName, состоящий из компонентов с индексами в диапазоне [posn,size()). Если posn равен size(), возвращается пустое имя LDAP.

Исключения:

IndexOutOfBoundsException — если posn выходит за пределы указанного диапазона.

public boolean startsWith(Name n)

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

startsWith в интерфейсе Name

Параметры:

n — имя LDAP для проверки.

Возвращает:

true, если n является префиксом этого имени LDAP, и false в противном случае.

См. также:

• getPrefix(int posn)

public boolean startsWith(List<Rdn> rdns)

Параметры:

rdns — проверяемая последовательность Rdn.

Возвращает:

true, если rdns образуют префикс этого имени LDAP, и false в противном случае.

public boolean endsWith(Name n)

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

endsWith в интерфейсе Name

Параметры:

n — имя LDAP для проверки.

Возвращает:

true, если n является суффиксом этого имени, и false в противном случае.

См. также:

• getSuffix(int posn)

public boolean endsWith(List<Rdn> rdns)

Параметры:

rdns — проверяемая последовательность Rdn.

Возвращает:

true, если rdns образуют суффикс этого имени LDAP, и false в противном случае.

public Name addAll(Name suffix) throws InvalidNameException

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

addAll в интерфейсе Name

Параметры:

suffix — ненулевые компоненты для добавления.

Возвращает:

Обновленное имя (не новый экземпляр).

Исключения:

InvalidNameException — если suffix не является допустимым именем LDAP или если добавление компонентов нарушает синтаксические правила этого имени LDAP.

public Name addAll(List<Rdn> suffixRdns)

Параметры:

suffixRdns — ненулевые RDN суффикса Rdn для добавления.

Возвращает:

Обновленное имя (не новый экземпляр).

public Name addAll(int posn, Name suffix) throws InvalidNameException

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

addAll в интерфейсе Name

Параметры:

posn — индекс, в который следует добавить новый компонент. Должен находиться в диапазоне [0,size()].

suffix — ненулевые компоненты для добавления.

Возвращает:

Обновленное имя (не новый экземпляр).

Исключения:

InvalidNameException — если suffix не является допустимым именем LDAP или если добавление компонентов нарушает синтаксические правила этого имени LDAP.

IndexOutOfBoundsException — если posn выходит за пределы указанного диапазона.

public Name addAll(int posn, List<Rdn> suffixRdns)

Параметры:

posn — индекс, в который следует добавить RDN суффикса. Должен находиться в диапазоне [0,size()].

suffixRdns — ненулевые RDN суффикса Rdn для добавления.

Возвращает:

Обновленное имя (не новый экземпляр).

Исключения:

IndexOutOfBoundsException — если posn выходит за пределы указанного диапазона.

public Name add(String comp) throws InvalidNameException

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

add в интерфейсе Name

Параметры:

comp — ненулевой компонент для добавления.

Возвращает:

Обновленный LdapName, не новый экземпляр. Не может быть null.

Исключения:

InvalidNameException — если добавление comp в конец имени нарушает синтаксис имени.

public Name add(Rdn comp)

Параметры:

comp — ненулевой RDN для добавления.

Возвращает:

Обновленный LdapName, не новый экземпляр. Не может быть null.

public Name add(int posn, String comp) throws InvalidNameException

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

add в интерфейсе Name

Параметры:

posn — индекс, в который следует добавить новый компонент. Должен находиться в диапазоне [0,size()].

comp — ненулевой компонент для добавления.

Возвращает:

Обновленный LdapName, не новый экземпляр. Не может быть null.

Исключения:

IndexOutOfBoundsException — если posn выходит за пределы указанного диапазона.

InvalidNameException — если добавление comp в указанную позицию нарушает синтаксис имени.

public Name add(int posn, Rdn comp)

Параметры:

posn — индекс, в который следует добавить новый RDN. Должен находиться в диапазоне [0,size()].

comp — ненулевой RDN для добавления.

Возвращает:

Обновленный LdapName, не новый экземпляр. Не может быть null.

Исключения:

IndexOutOfBoundsException — если posn выходит за пределы указанного диапазона.

public Object remove(int posn) throws InvalidNameException

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

remove в интерфейсе Name

Параметры:

posn — индекс удаляемого компонента. Должен находиться в диапазоне [0,size()).

Возвращает:

Удаленный компонент (String).

Исключения:

IndexOutOfBoundsException — если posn выходит за пределы указанного диапазона.

InvalidNameException — если удаление компонента нарушает синтаксические правила имени.

public List<Rdn> getRdns()

Возвращает:

Имя в виде списка RDN, являющихся экземплярами класса Rdn.

public Object clone()

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

clone в интерфейсе Name

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

clone в классе Object

Возвращает:

Копию этого имени LDAP.

См. также:

• Object.clone()

public String toString()

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

toString в классе Object

Возвращает:

Строковое представление LdapName.

public boolean equals(Object obj)

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

equals в классе Object

Параметры:

obj — объект, который может быть null и с которым выполняется сравнение.

Возвращает:

true, если obj равен этому имени LDAP, и false в противном случае.

См. также:

• hashCode()

public int compareTo(Object obj)

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

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

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

compareTo в интерфейсе Name

Параметры:

obj — ненулевой экземпляр LdapName для сравнения.

Возвращает:

Отрицательное целое число, ноль или положительное целое число, если это Name меньше, равно или больше указанного obj соответственно.

Исключения:

ClassCastException — если obj равно null или не является LdapName.

См. также:

• Comparable.compareTo(Object)

public int hashCode()

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

hashCode в классе Object

Возвращает:

Значение int, представляющее хеш-код этого имени.

См. также:

• equals(Object)