Класс LdapName

public LdapName(String name) throws InvalidNameException

Параметры:

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

Выбрасывает:

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

См. также:

• Rdn.escapeValue(Object value)

public LdapName(List<Rdn> rdns)

Параметры:

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

public int size()

Определяется в:

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

Возвращает:

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

public boolean isEmpty()

Определяется в:

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

Возвращает:

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

public Enumeration<String> getAll()

Определяется в:

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

Возвращает:

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

public String get(int posn)

Определяется в:

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

Параметры:

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

Возвращает:

Компонент по индексу posn, не равный null.

Выбрасывает:

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

public Rdn getRdn(int posn)

Параметры:

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

Возвращает:

RDN по индексу posn, не равный null.

Выбрасывает:

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 — добавляемые компоненты, не равные null.

Возвращает:

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

Выбрасывает:

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

public Name addAll(List<Rdn> suffixRdns)

Параметры:

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

Возвращает:

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

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

Определяется в:

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

Параметры:

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

suffix — добавляемые компоненты, не равные null.

Возвращает:

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

Выбрасывает:

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

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

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

Параметры:

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

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

Возвращает:

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

Выбрасывает:

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

public Name add(String comp) throws InvalidNameException

Определяется в:

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

Параметры:

comp — добавляемый компонент, не равный null.

Возвращает:

Обновлённое имя LdapName (не новый экземпляр). Не может быть равно null.

Выбрасывает:

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

public Name add(Rdn comp)

Параметры:

comp — добавляемый RDN, не равный null.

Возвращает:

Обновлённое имя LdapName (не новый экземпляр). Не может быть равно null.

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

Определяется в:

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

Параметры:

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

comp — добавляемый компонент, не равный null.

Возвращает:

Обновлённое имя LdapName (не новый экземпляр). Не может быть равно null.

Выбрасывает:

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

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

public Name add(int posn, Rdn comp)

Параметры:

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

comp — добавляемый RDN, не равный null.

Возвращает:

Обновлённое имя 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 для сравнения, не равный null.

Возвращает:

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

Выбрасывает:

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

См. также:

• Comparable.compareTo(Object)

public int hashCode()

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

hashCode в классе Object

Возвращает:

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

См. также:

• equals(Object)