Spec-Zone .ru
спецификации, руководства, описания, API
|
public class Rdn extends Object implements Serializable, Comparable<Object>
LdapName
. class Rdn представляет RDN как отображения типа/значения атрибута, которые могут быть просмотрены, используя Attributes
. Кроме того, это содержит методы удобства, которые позволяют легкое извлечение типа и значения, когда Rdn состоят из единственной пары типа/значения, которая является, как это появляется в типичном использовании. Это также содержит методы помощника, которые позволяют выходить бесформатного значения атрибута и невыходить значения, отформатированного согласно синтаксису выхода, определенному в RFC2253. Для методов, которые берут или возвращают значение атрибута как Объект, значением является любой Строка (в неоставленной форме) или байтовый массив.
Rdn
должным образом проанализирует весь допустимый RDNs, но не пытается обнаружить все возможные нарушения, анализируя недопустимый RDNs. Это "щедро" в принятии недопустимого RDNs. "Законность" имени определяется в конечном счете, когда она предоставляется серверу LDAP, который может принять или отклонить имя, основанное на факторах, таких как его соображения информации и функциональной совместимости схемы.
Следующий пример кода показывает, как создать Rdn, используя конструктора, который берет тип и значение как параметры:
Rdn rdn = new Rdn("cn", "Juicy, Fruit"); System.out.println(rdn.toString());Последняя строка напечатает cn=Juicy\, Fruit.
unescapeValue()
метод может использоваться, чтобы невыйти из оставленной запятой, приводящей к исходному значению "Juicy, Fruit". escapeValue()
метод добавляет escape, назад предшествующий запятой. Этот class может инстанцировать строковое представление RDN, определенного в RFC 2253 как показано в следующем примере кода:
Rdn rdn = new Rdn("cn=Juicy\\, Fruit"); System.out.println(rdn.toString());Последняя строка напечатает cn=Juicy\, Fruit.
Параллельный многопоточный доступ только для чтения экземпляра Rdn не должен синхронизироваться.
Если не указано иное, поведение передачи нулевого параметра конструктору или методу в этом class заставит NullPointerException быть брошенным.
Конструктор и Описание |
---|
Rdn(Attributes attrSet)
Создает Rdn из данного набора атрибута.
|
Rdn(Rdn rdn)
Создает Rdn из данного rdn.
|
Rdn(String rdnString)
Создает Rdn из данной строки.
|
Rdn(String type, Object value)
Создает Rdn из данного типа атрибута и значения.
|
Модификатор и Тип | Метод и Описание |
---|---|
int |
compareTo(Object obj)
Сравнивает этот Rdn с указанным Объектом для порядка.
|
boolean |
equals(Object obj)
Сравнивает указанный Объект с этим Rdn для равенства.
|
static String |
escapeValue(Object val)
Учитывая значение атрибута, возвращает строку, которой оставляют согласно правилам, определенным в
|
Строка |
getType()
Получает один из типа этого Рдн.
|
Объект |
getValue()
Получает одно из значения этого Рдн.
|
int |
hashCode()
Возвращает хэш-код этого RDN.
|
int |
size()
Получает число пар типа/значения атрибута в этом Rdn.
|
Атрибуты |
toAttributes()
Получает
Attributes представление отображений типа/значения содержится в этом Rdn. |
Строка |
toString()
|
static Object |
unescapeValue(String val)
Учитывая строку значения атрибута, форматированную согласно правилам, определенным в
|
public Rdn(Attributes attrSet) throws InvalidNameException
Attributes
. Строковые значения атрибута не являются interpretted как
attrSet
- Ненулевые и непустые атрибуты, содержащие отображения типа/значения.InvalidNameException
- Если содержание attrSet не может использоваться, чтобы создать допустимый RDN.public Rdn(String rdnString) throws InvalidNameException
LdapName
.rdnString
- Ненулевой и непустой RFC2253 отформатированная строка.InvalidNameException
- Если синтаксическая ошибка происходит во время парсинга rdnString.public Rdn(Rdn rdn)
rdn
- Ненулевой Rdn, который будет скопирован.public Rdn(String type, Object value) throws InvalidNameException
type
- Ненулевая и непустая строка приписывает тип.value
- Ненулевое и непустое значение атрибута.InvalidNameException
- Если тип/значение не может использоваться, чтобы создать допустимый RDN.toString()
public Object getValue()
Для многозначного RDN этот метод возвращает значение, соответствующее типу, возвращенному getType()
метод.
public String getType()
Для многозначного RDN у пар типа/значения нет никакого определенного порядка, определенного на них. В этом случае этот метод возвращает тип одной из пар типа/значения. getValue()
метод возвращает значение, соответствующее типу, возвращенному этим методом.
public String toString()
public int compareTo(Object obj)
Если obj является нулем или не экземпляром Rdn, ClassCastException бросается.
Тип атрибута и пары значения RDNs выстраиваются в линию друг против друга и сравниваются лексикографически. Порядок компонентов в многозначном Rdns (таких как "ou=Sales+cn=Bob") не является существенным.
compareTo
в интерфейсе Comparable<Object>
obj
- Ненулевой объект сравниться с.ClassCastException
- если obj является нулем или не Rdn. public boolean equals(Object obj)
Введите и оцените соответствие equalilty, делается как указано ниже:
Если obj является нулем или не экземпляром Rdn, false возвращается.
equals
в class Object
obj
- объект, который будет сравнен для равенства с этим Rdn.hashCode()
public int hashCode()
hashCode
в class Object
equals(java.lang.Object)
public Attributes toAttributes()
Attributes
представление отображений типа/значения содержится в этом Rdn.public int size()
public static String escapeValue(Object val)
Например, если val, "Предъявляют иск, Grabbit и Runn", оставленное значение, возвращенное этим методом, "Предъявляют иск \, Grabbit и Runn".
Строковое значение представляется как Строка и двоичное значение как байтовый массив.
val
- Ненулевой объект, которого оставят.ClassCastException
- если val, не Строка или байтовый массив.public static Object unescapeValue(String val)
Юридические и недопустимые значения определяются в RFC 2253. Этот метод щедр в принятии значений и не ловит все недопустимые значения. Поэтому, передача в недопустимом значении не могла бы обязательно инициировать IllegalArgumentException.
val
- Непустая строка, которой неоставят.IllegalArgumentException
- Когда Недопустимое значение обеспечивается.
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92