javax.naming.directory

Класс InitialDirContext

java.lang. Объект

javax.naming. InitialContext

javax.naming.directory. InitialDirContext

Все Реализованные Интерфейсы:

Контекст, DirContext

Прямые Известные Подклассы:

InitialLdapContext

public class InitialDirContext
extends InitialContext
implements DirContext

Этот класс является запускающимся контекстом для того, чтобы выполнить операции каталога. Документация в описании класса InitialContext (включая тех для синхронизации) применяется здесь.

С тех пор:

1.3

См. Также:

InitialContext

Полевая Сводка

Поля javax.naming унаследованный от класса. InitialContext

defaultInitCtx, gotDefault, myProps

Поля, наследованные от интерфейса javax.naming.directory. DirContext

ADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTE

Поля, наследованные от интерфейса javax.naming. Контекст

APPLET, AUTHORITATIVE, BATCHSIZE, DNS_URL, INITIAL_CONTEXT_FACTORY, LANGUAGE, OBJECT_FACTORIES, PROVIDER_URL, REFERRAL, SECURITY_AUTHENTICATION, SECURITY_CREDENTIALS, SECURITY_PRINCIPAL, SECURITY_PROTOCOL, STATE_FACTORIES, URL_PKG_PREFIXES

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
	InitialDirContext() Создает начальный DirContext.
protected	InitialDirContext(boolean lazy) Создает начальный DirContext с опцией не инициализации этого.
	InitialDirContext(Hashtable<?,?> environment) Создает начальный DirContext, используя предоставленную среду.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	bind(Name name, Object obj, Attributes attrs) Связывает имя к объекту, наряду со связанными атрибутами.
void	bind(String name, Object obj, Attributes attrs) Связывает имя к объекту, наряду со связанными атрибутами.
DirContext	createSubcontext(Name name, Attributes attrs) Создает и ограничивает новый контекст, наряду со связанными атрибутами.
DirContext	createSubcontext(String name, Attributes attrs) Создает и ограничивает новый контекст, наряду со связанными атрибутами.
Атрибуты	getAttributes(Name name) Получает все атрибуты, связанные с именованным объектом.
Атрибуты	getAttributes(Name name, String[] attrIds) Получает выбранные атрибуты, связанные с именованным объектом.
Атрибуты	getAttributes(String name) Получает все атрибуты, связанные с именованным объектом.
Атрибуты	getAttributes(String name, String[] attrIds) Получает выбранные атрибуты, связанные с именованным объектом.
DirContext	getSchema(Name name) Получает схему, связанную с именованным объектом.
DirContext	getSchema(String name) Получает схему, связанную с именованным объектом.
DirContext	getSchemaClassDefinition(Name name) Получает контекст, содержащий объекты схемы определений классов именованного объекта.
DirContext	getSchemaClassDefinition(String name) Получает контекст, содержащий объекты схемы определений классов именованного объекта.
void	modifyAttributes(Name name, int mod_op, Attributes attrs) Изменяет атрибуты, связанные с именованным объектом.
void	modifyAttributes(Name name, ModificationItem[] mods) Изменяет атрибуты, связанные с именованным объектом, используя упорядоченный список модификаций.
void	modifyAttributes(String name, int mod_op, Attributes attrs) Изменяет атрибуты, связанные с именованным объектом.
void	modifyAttributes(String name, ModificationItem[] mods) Изменяет атрибуты, связанные с именованным объектом, используя упорядоченный список модификаций.
void	rebind(Name name, Object obj, Attributes attrs) Связывает имя к объекту, наряду со связанными атрибутами, перезаписывая любую существующую привязку.
void	rebind(String name, Object obj, Attributes attrs) Связывает имя к объекту, наряду со связанными атрибутами, перезаписывая любую существующую привязку.
NamingEnumeration<SearchResult>	search(Name name, Attributes matchingAttributes) Поиски в единственном контексте для объектов, которые содержат указанный набор атрибутов.
NamingEnumeration<SearchResult>	search(Name name, Attributes matchingAttributes, String[] attributesToReturn) Поиски в единственном контексте для объектов, которые содержат указанный набор атрибутов, и получают выбранные атрибуты.
NamingEnumeration<SearchResult>	search(Name name, String filterExpr, Object[] filterArgs, SearchControls cons) Поиски в именованном контексте или объекте для записей, которые удовлетворяют данный поисковый фильтр.
NamingEnumeration<SearchResult>	search(Name name, String filter, SearchControls cons) Поиски в именованном контексте или объекте для записей, которые удовлетворяют данный поисковый фильтр.
NamingEnumeration<SearchResult>	search(String name, Attributes matchingAttributes) Поиски в единственном контексте для объектов, которые содержат указанный набор атрибутов.
NamingEnumeration<SearchResult>	search(String name, Attributes matchingAttributes, String[] attributesToReturn) Поиски в единственном контексте для объектов, которые содержат указанный набор атрибутов, и получают выбранные атрибуты.
NamingEnumeration<SearchResult>	search(String name, String filterExpr, Object[] filterArgs, SearchControls cons) Поиски в именованном контексте или объекте для записей, которые удовлетворяют данный поисковый фильтр.
NamingEnumeration<SearchResult>	search(String name, String filter, SearchControls cons) Поиски в именованном контексте или объекте для записей, которые удовлетворяют данный поисковый фильтр.

Методы javax.naming унаследованный от класса. InitialContext

addToEnvironment, bind, bind, close, composeName, composeName, createSubcontext, createSubcontext, destroySubcontext, destroySubcontext, doLookup, doLookup, getDefaultInitCtx, getEnvironment, getNameInNamespace, getNameParser, getNameParser, getURLOrDefaultInitCtx, getURLOrDefaultInitCtx, init, list, list, listBindings, listBindings, lookup, lookup, lookupLink, lookupLink, rebind, rebind, removeFromEnvironment, rename, rename, unbind, unbind

Методы java.lang унаследованный от класса. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Методы, наследованные от интерфейса javax.naming. Контекст

addToEnvironment, bind, bind, close, composeName, composeName, createSubcontext, createSubcontext, destroySubcontext, destroySubcontext, getEnvironment, getNameInNamespace, getNameParser, getNameParser, list, list, listBindings, listBindings, lookup, lookup, lookupLink, lookupLink, rebind, rebind, removeFromEnvironment, rename, rename, unbind, unbind

Деталь конструктора

InitialDirContext

protected InitialDirContext(boolean lazy)
                     throws NamingException

Создает начальный DirContext с опцией не инициализации этого. Это может использоваться конструктором в подклассе, когда значение параметра среды еще не известно в то время, когда конструктора InitialDirContext вызывают. Конструктор подкласса вызовет этого конструктора, вычислит значение среды, и затем вызовет init() перед возвратом.

Параметры:

lazy - истинные средства не инициализируют начальный DirContext; ложь эквивалентна вызову new InitialDirContext()

Броски:

NamingException - если с исключением именования встречаются

С тех пор:

1.3

См. Также:

InitialContext.init(Hashtable)

InitialDirContext

public InitialDirContext()
                  throws NamingException

Создает начальный DirContext. Никакие свойства среды не предоставляются. Эквивалентный new InitialDirContext(null).

Броски:

NamingException - если с исключением именования встречаются

См. Также:

InitialDirContext(Hashtable)

InitialDirContext

public InitialDirContext(Hashtable<?,?> environment)
                  throws NamingException

Создает начальный DirContext, используя предоставленную среду. Свойства среды обсуждаются в описании класса javax.naming.InitialContext.

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

Параметры:

environment - среда, используемая, чтобы создать начальный DirContext. Нуль указывает на пустую среду.

Броски:

NamingException - если с исключением именования встречаются

Деталь метода

getAttributes

public Attributes getAttributes(String name)
                         throws NamingException

Описание скопировало с интерфейса: DirContext

Получает все атрибуты, связанные с именованным объектом. См. DirContext.getAttributes(Name) для деталей.

Определенный:

getAttributes в интерфейсе DirContext

Параметры:

name - имя объекта, от которого можно получить атрибуты

Возвраты:

набор атрибутов, связанных с name

Броски:

NamingException - если с исключением именования встречаются

getAttributes

public Attributes getAttributes(String name,
                       String[] attrIds)
                         throws NamingException

Описание скопировало с интерфейса: DirContext

Получает выбранные атрибуты, связанные с именованным объектом. См. DirContext.getAttributes(Name, String[]) для деталей.

Определенный:

getAttributes в интерфейсе DirContext

Параметры:

name - Имя объекта, от которого можно получить атрибуты

attrIds - идентификаторы атрибутов, чтобы получить. нуль указывает, что все атрибуты должны быть получены; пустой массив указывает, что ни один не должен быть получен.

Возвраты:

требуемые атрибуты; никогда не обнуляйте

Броски:

NamingException - если с исключением именования встречаются

getAttributes

public Attributes getAttributes(Name name)
                         throws NamingException

Описание скопировало с интерфейса: DirContext

Получает все атрибуты, связанные с именованным объектом. См., что описание класса расценивает модели атрибута, припишите имена типов, и операционные атрибуты.

Определенный:

getAttributes в интерфейсе DirContext

Параметры:

name - имя объекта, от которого можно получить атрибуты

Возвраты:

набор атрибутов, связанных с name. Возвращает пустой набор атрибута, если у имени нет никаких атрибутов; никогда не обнуляйте.

Броски:

NamingException - если с исключением именования встречаются

См. Также:

DirContext.getAttributes(String), DirContext.getAttributes(Name, String[])

getAttributes

public Attributes getAttributes(Name name,
                       String[] attrIds)
                         throws NamingException

Описание скопировало с интерфейса: DirContext

Получает выбранные атрибуты, связанные с именованным объектом. См., что описание класса расценивает модели атрибута, припишите имена типов, и операционные атрибуты.

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

Каталог мог бы возвратить больше атрибутов, чем требовалось (см. Имена типов Атрибута в описании класса), но не позволяется возвратить произвольные, несвязанные атрибуты.

См. также Операционные Атрибуты в описании класса.

Определенный:

getAttributes в интерфейсе DirContext

Параметры:

name - имя объекта, от которого можно получить атрибуты

attrIds - идентификаторы атрибутов, чтобы получить. нуль указывает, что все атрибуты должны быть получены; пустой массив указывает, что ни один не должен быть получен.

Возвраты:

требуемые атрибуты; никогда не обнуляйте

Броски:

NamingException - если с исключением именования встречаются

modifyAttributes

public void modifyAttributes(String name,
                    int mod_op,
                    Attributes attrs)
                      throws NamingException

Описание скопировало с интерфейса: DirContext

Изменяет атрибуты, связанные с именованным объектом. См. DirContext.modifyAttributes(Name, int, Attributes) для деталей.

Определенный:

modifyAttributes в интерфейсе DirContext

Параметры:

name - имя объекта, атрибуты которого будут обновлены

mod_op - работа модификации, один из: ADD_ATTRIBUTE, REPLACE_ATTRIBUTE, REMOVE_ATTRIBUTE.

attrs - атрибуты, которые будут использоваться для модификации; возможно, не нуль

Броски:

AttributeModificationException - если модификация не может быть завершена успешно

NamingException - если с исключением именования встречаются

modifyAttributes

public void modifyAttributes(Name name,
                    int mod_op,
                    Attributes attrs)
                      throws NamingException

Описание скопировало с интерфейса: DirContext

Изменяет атрибуты, связанные с именованным объектом. Порядок модификаций не определяется. Где только возможно модификации выполняются атомарно.

Определенный:

modifyAttributes в интерфейсе DirContext

Параметры:

name - имя объекта, атрибуты которого будут обновлены

mod_op - работа модификации, один из: ADD_ATTRIBUTE, REPLACE_ATTRIBUTE, REMOVE_ATTRIBUTE.

attrs - атрибуты, которые будут использоваться для модификации; возможно, не нуль

Броски:

AttributeModificationException - если модификация не может быть завершена успешно

NamingException - если с исключением именования встречаются

См. Также:

DirContext.modifyAttributes(Name, ModificationItem[])

modifyAttributes

public void modifyAttributes(String name,
                    ModificationItem[] mods)
                      throws NamingException

Описание скопировало с интерфейса: DirContext

Изменяет атрибуты, связанные с именованным объектом, используя упорядоченный список модификаций. См. DirContext.modifyAttributes(Name, ModificationItem[]) для деталей.

Определенный:

modifyAttributes в интерфейсе DirContext

Параметры:

name - имя объекта, атрибуты которого будут обновлены

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

Броски:

AttributeModificationException - если модификации не могут быть завершены успешно

NamingException - если с исключением именования встречаются

modifyAttributes

public void modifyAttributes(Name name,
                    ModificationItem[] mods)
                      throws NamingException

Описание скопировало с интерфейса: DirContext

Изменяет атрибуты, связанные с именованным объектом, используя упорядоченный список модификаций. Модификации выполняются в определенном порядке. Каждая модификация определяет код работы модификации и атрибут, на котором можно работать. Где только возможно модификации выполняются атомарно.

Определенный:

modifyAttributes в интерфейсе DirContext

Параметры:

name - имя объекта, атрибуты которого будут обновлены

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

Броски:

AttributeModificationException - если модификации не могут быть завершены успешно

NamingException - если с исключением именования встречаются

См. Также:

DirContext.modifyAttributes(Name, int, Attributes), ModificationItem

связать

public void bind(String name,
        Object obj,
        Attributes attrs)
          throws NamingException

Описание скопировало с интерфейса: DirContext

Связывает имя к объекту, наряду со связанными атрибутами. См. DirContext.bind(Name, Object, Attributes) для деталей.

Определенный:

bind в интерфейсе DirContext

Параметры:

name - имя, чтобы связать; возможно, не пусто

obj - объект связать; возможно нуль

attrs - атрибуты, чтобы связаться с привязкой

Броски:

NameAlreadyBoundException - если имя уже связывается

InvalidAttributesException - если некоторые "обязательные" атрибуты привязки не предоставляются

NamingException - если с исключением именования встречаются

связать

public void bind(Name name,
        Object obj,
        Attributes attrs)
          throws NamingException

Описание скопировало с интерфейса: DirContext

Связывает имя к объекту, наряду со связанными атрибутами. Если attrs будет нулем, то получающейся привязке свяжут атрибуты с obj, если obj будет DirContext, и никакие атрибуты иначе. Если attrs будет ненулем, то у получающейся привязки будет attrs как его атрибуты; игнорируются любые атрибуты, связанные с obj.

Определенный:

bind в интерфейсе DirContext

Параметры:

name - имя, чтобы связать; возможно, не пусто

obj - объект связать; возможно нуль

attrs - атрибуты, чтобы связаться с привязкой

Броски:

NameAlreadyBoundException - если имя уже связывается

InvalidAttributesException - если некоторые "обязательные" атрибуты привязки не предоставляются

NamingException - если с исключением именования встречаются

См. Также:

Context.bind(Name, Object), DirContext.rebind(Name, Object, Attributes)

снова переплести

public void rebind(String name,
          Object obj,
          Attributes attrs)
            throws NamingException

Описание скопировало с интерфейса: DirContext

Связывает имя к объекту, наряду со связанными атрибутами, перезаписывая любую существующую привязку. См. DirContext.rebind(Name, Object, Attributes) для деталей.

Определенный:

rebind в интерфейсе DirContext

Параметры:

name - имя, чтобы связать; возможно, не пусто

obj - объект связать; возможно нуль

attrs - атрибуты, чтобы связаться с привязкой

Броски:

InvalidAttributesException - если некоторые "обязательные" атрибуты привязки не предоставляются

NamingException - если с исключением именования встречаются

снова переплести

public void rebind(Name name,
          Object obj,
          Attributes attrs)
            throws NamingException

Описание скопировало с интерфейса: DirContext

Связывает имя к объекту, наряду со связанными атрибутами, перезаписывая любую существующую привязку. Если attrs является нулем, и obj является DirContext, атрибуты от obj используются. Если attrs является нулем, и obj не является DirContext, любые существующие атрибуты, связанные с объектом, уже связанным в каталоге, остаются неизменными. Если attrs является ненулем, любые существующие атрибуты, связанные с объектом, уже связанным в каталоге, удаляются, и attrs связывается с именованным объектом. Если obj является DirContext, и attrs является ненулем, атрибуты obj игнорируются.

Определенный:

rebind в интерфейсе DirContext

Параметры:

name - имя, чтобы связать; возможно, не пусто

obj - объект связать; возможно нуль

attrs - атрибуты, чтобы связаться с привязкой

Броски:

InvalidAttributesException - если некоторые "обязательные" атрибуты привязки не предоставляются

NamingException - если с исключением именования встречаются

См. Также:

Context.bind(Name, Object), DirContext.bind(Name, Object, Attributes)

createSubcontext

public DirContext createSubcontext(String name,
                          Attributes attrs)
                            throws NamingException

Описание скопировало с интерфейса: DirContext

Создает и ограничивает новый контекст, наряду со связанными атрибутами. См. DirContext.createSubcontext(Name, Attributes) для деталей.

Определенный:

createSubcontext в интерфейсе DirContext

Параметры:

name - имя контекста, чтобы создать; возможно, не пусто

attrs - атрибуты, чтобы связаться с недавно создаваемым контекстом

Возвраты:

недавно создаваемый контекст

Броски:

NameAlreadyBoundException - если имя уже связывается

InvalidAttributesException - если attrs не содержит все обязательные атрибуты, требуемые для создания

NamingException - если с исключением именования встречаются

createSubcontext

public DirContext createSubcontext(Name name,
                          Attributes attrs)
                            throws NamingException

Описание скопировало с интерфейса: DirContext

Создает и ограничивает новый контекст, наряду со связанными атрибутами. Этот метод создает новый подконтекст с именем, связывает его в целевом контексте (названное всеми кроме терминального атомарного компонента имени), и связывает предоставленные атрибуты с недавно создаваемым объектом. Все промежуточные и целевые контексты должны уже существовать. Если attrs является нулем, этот метод эквивалентен Context.createSubcontext().

Определенный:

createSubcontext в интерфейсе DirContext

Параметры:

name - имя контекста, чтобы создать; возможно, не пусто

attrs - атрибуты, чтобы связаться с недавно создаваемым контекстом

Возвраты:

недавно создаваемый контекст

Броски:

NameAlreadyBoundException - если имя уже связывается

InvalidAttributesException - если attrs не содержит все обязательные атрибуты, требуемые для создания

NamingException - если с исключением именования встречаются

См. Также:

Context.createSubcontext(Name)

getSchema

public DirContext getSchema(String name)
                     throws NamingException

Описание скопировало с интерфейса: DirContext

Получает схему, связанную с именованным объектом. См. DirContext.getSchema(Name) для деталей.

Определенный:

getSchema в интерфейсе DirContext

Параметры:

name - имя объекта, схема которого должна быть получена

Возвраты:

схема связалась с контекстом; никогда не обнуляйте

Броски:

OperationNotSupportedException - если схема, не поддерживаемая

NamingException - если с исключением именования встречаются

getSchema

public DirContext getSchema(Name name)
                     throws NamingException

Описание скопировало с интерфейса: DirContext

Получает схему, связанную с именованным объектом. Схема описывает правила относительно структуры пространства имен и атрибутов, сохраненных в пределах этого. Схема определяет, какие типы объектов могут быть добавлены к каталогу и где они могут быть добавлены; какие обязательные и дополнительные атрибуты объект может иметь. Диапазон поддержки схем специфичен для каталога.

Этот метод возвращает корень дерева информации о схеме, которое применимо к именованному объекту. Несколько именованных объектов (или даже весь каталог) могли бы совместно использовать ту же самую схему.

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

Определенный:

getSchema в интерфейсе DirContext

Параметры:

name - имя объекта, схема которого должна быть получена

Возвраты:

схема связалась с контекстом; никогда не обнуляйте

Броски:

OperationNotSupportedException - если схема, не поддерживаемая

NamingException - если с исключением именования встречаются

getSchemaClassDefinition

public DirContext getSchemaClassDefinition(String name)
                                    throws NamingException

Описание скопировало с интерфейса: DirContext

Получает контекст, содержащий объекты схемы определений классов именованного объекта. См. DirContext.getSchemaClassDefinition(Name) для деталей.

Определенный:

getSchemaClassDefinition в интерфейсе DirContext

Параметры:

name - имя объекта, определение класса объекта которого должно быть получено

Возвраты:

DirContext, содержащий определения классов именованного объекта; никогда не обнуляйте

Броски:

OperationNotSupportedException - если схема, не поддерживаемая

NamingException - если с исключением именования встречаются

getSchemaClassDefinition

public DirContext getSchemaClassDefinition(Name name)
                                    throws NamingException

Описание скопировало с интерфейса: DirContext

Получает контекст, содержащий объекты схемы определений классов именованного объекта.

Одна категория информации, найденной в схемах каталога, является определениями классов. Определение "класса объекта" определяет тип объекта и какие атрибуты (обязательный и дополнительный) объект должен иметь. Отметьте, что ссылка "класса объекта" термина здесь находится в смысле каталога, а не в смысле Java. Например, если бы именованный объект является объектом каталога класса "Человека", getSchemaClassDefinition() возвратил бы DirContext, представляющий определение класса объекта (каталога) "Человека".

Информация, которая может быть получена из определения класса объекта, зависима от каталога.

До JNDI 1.2, этот метод, возвращенный единственный объект схемы представление определения класса именованного объекта. Начиная с JNDI 1.2, этот метод возвращает DirContext, содержащий все определения классов именованного объекта.

Определенный:

getSchemaClassDefinition в интерфейсе DirContext

Параметры:

name - имя объекта, определение класса объекта которого должно быть получено

Возвраты:

DirContext, содержащий определения классов именованного объекта; никогда не обнуляйте

Броски:

OperationNotSupportedException - если схема, не поддерживаемая

NamingException - если с исключением именования встречаются

поиск

public NamingEnumeration<SearchResult> search(String name,
                                     Attributes matchingAttributes)
                                       throws NamingException

Описание скопировало с интерфейса: DirContext

Поиски в единственном контексте для объектов, которые содержат указанный набор атрибутов. См. DirContext.search(Name, Attributes) для деталей.

Определенный:

search в интерфейсе DirContext

Параметры:

name - имя контекста, чтобы искать

matchingAttributes - атрибуты, чтобы искать

Возвраты:

перечисление объектов SearchResult

Броски:

NamingException - если с исключением именования встречаются

поиск

public NamingEnumeration<SearchResult> search(Name name,
                                     Attributes matchingAttributes)
                                       throws NamingException

Описание скопировало с интерфейса: DirContext

Поиски в единственном контексте для объектов, которые содержат указанный набор атрибутов. Этот метод возвращает все атрибуты таких объектов. Это эквивалентно предоставлению нуля как параметр atributesToReturn к методу search(Name, Attributes, String[]).
См. DirContext.search(Name, Attributes, String[]) для полного описания.

Определенный:

search в интерфейсе DirContext

Параметры:

name - имя контекста, чтобы искать

matchingAttributes - атрибуты, чтобы искать

Возвраты:

перечисление объектов SearchResult

Броски:

NamingException - если с исключением именования встречаются

См. Также:

DirContext.search(Name, Attributes, String[])

поиск

public NamingEnumeration<SearchResult> search(String name,
                                     Attributes matchingAttributes,
                                     String[] attributesToReturn)
                                       throws NamingException

Описание скопировало с интерфейса: DirContext

Поиски в единственном контексте для объектов, которые содержат указанный набор атрибутов, и получают выбранные атрибуты. См. DirContext.search(Name, Attributes, String[]) для деталей.

Определенный:

search в интерфейсе DirContext

Параметры:

name - имя контекста, чтобы искать

matchingAttributes - атрибуты, чтобы искать

attributesToReturn - атрибуты, чтобы возвратиться

Возвраты:

ненулевое перечисление объектов SearchResult

Броски:

NamingException - если с исключением именования встречаются

поиск

public NamingEnumeration<SearchResult> search(Name name,
                                     Attributes matchingAttributes,
                                     String[] attributesToReturn)
                                       throws NamingException

Описание скопировало с интерфейса: DirContext

Поиски в единственном контексте для объектов, которые содержат указанный набор атрибутов, и получают выбранные атрибуты. Поиск выполняется, используя значение по умолчанию SearchControls настройки.

Для объекта, который будет выбран, каждый атрибут в matchingAttributes должен соответствовать некоторый атрибут объекта. Если matchingAttributes является пустым или нулевым, все объекты в целевом контексте возвращаются.

Атрибут A1 в matchingAttributes как полагают, соответствует атрибуту A2 объекта, если у A1 и A2 есть тот же самый идентификатор, и каждое значение A1 равно некоторому значению A2. Это подразумевает, что порядок значений не является существенным, и что A2 может содержать "дополнительные" значения, не найденные в A1, не влияя на сравнение. Это также подразумевает что, если у A1 нет никаких значений, то тестирование на соответствие эквивалентно тестированию на присутствие атрибута A2 с тем же самым идентификатором.

Точное определение "равенства", используемого в сравнении значений атрибута, определяется базовой службой каталогов. Это могло бы использовать Object.equals метод, например, или мог бы использовать схему, чтобы определить различную работу равенства. Для того, чтобы соответствовать основанный на операциях кроме равенства (таких как сравнение подстроки) используют версию search метод, который берет параметр фильтра.

Когда изменения производятся в этом DirContext, эффект на перечисления, возвращенные предшествующими звонками в этот метод, неопределен.

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

Каталог мог бы возвратить больше атрибутов, чем требовалось (см. Имена типов Атрибута в описании класса), но не позволяется возвратить произвольные, несвязанные атрибуты.

См. также Операционные Атрибуты в описании класса.

Определенный:

search в интерфейсе DirContext

Параметры:

name - имя контекста, чтобы искать

matchingAttributes - атрибуты, чтобы искать. Если пустой или нулевой, все объекты в целевом контексте возвращаются.

attributesToReturn - атрибуты, чтобы возвратиться. нуль указывает, что все атрибуты должны быть возвращены; пустой массив указывает, что ни один не должен быть возвращен.

Возвраты:

ненулевое перечисление объектов SearchResult. Каждый SearchResult содержит атрибуты, идентифицированные attributesToReturn и имя соответствующего объекта, названного относительно контекста, названного name.

Броски:

NamingException - если с исключением именования встречаются

См. Также:

SearchControls, SearchResult, DirContext.search(Name, String, Object[], SearchControls)

поиск

public NamingEnumeration<SearchResult> search(String name,
                                     String filter,
                                     SearchControls cons)
                                       throws NamingException

Описание скопировало с интерфейса: DirContext

Поиски в именованном контексте или объекте для записей, которые удовлетворяют данный поисковый фильтр. Выполняет поиск как определено поисковыми средствами управления. См. DirContext.search(Name, String, SearchControls) для деталей.

Определенный:

search в интерфейсе DirContext

Параметры:

name - имя контекста или объекта искать

filter - выражение фильтра, чтобы использовать для поиска; возможно, не нуль

cons - поисковые средства управления, которые управляют поиском. Если ноль, поисковые средства управления по умолчанию используются (эквивалентный (new SearchControls())).

Возвраты:

перечисление SearchResult s для объектов, которые удовлетворяют фильтр.

Броски:

InvalidSearchFilterException - если поисковый определенный фильтр не поддерживается или понимается под базовым каталогом

InvalidSearchControlsException - если поисковые средства управления содержат недопустимые настройки

NamingException - если с исключением именования встречаются

поиск

public NamingEnumeration<SearchResult> search(Name name,
                                     String filter,
                                     SearchControls cons)
                                       throws NamingException

Описание скопировало с интерфейса: DirContext

Поиски в именованном контексте или объекте для записей, которые удовлетворяют данный поисковый фильтр. Выполняет поиск как определено поисковыми средствами управления.

Формат и интерпретация filter следует за RFC 2254 со следующими интерпретациями для attr и value упомянутый в RFC.

attr идентификатор атрибута.

value строковое представление значение атрибута. Преобразование этого строкового представления в значение атрибута специфично для каталога.

Для утверждения "someCount=127", например, attr "someCount" и value "127". Провайдер определяет, основанный на ID атрибута ("someCount") (и возможно его схема), что значение атрибута является целым числом. Это тогда анализирует строку "127" соответственно.

Любые символы неASCII в строке фильтра должны быть представлены соответствующим Java (Unicode) символы, и не закодированы как октеты UTF-8. Поочередно, нотация "наклонной-черты-влево-hexcode", описанная в RFC 2254, может использоваться.

Если каталог не поддерживает строковое представление некоторых или все его атрибуты, форму search это признает, что параметры фильтра в форме Объектов могут использоваться вместо этого. Поставщик услуг для такого каталога тогда преобразовал бы параметры фильтра его специфичному для службы представлению для оценки фильтра. См. search(Name, String, Object[], SearchControls).

RFC 2254 определяет определенные операторы для фильтра, включая соответствия подстроки, равенство, приблизительное соответствие, больше чем, меньше чем. Эти операторы отображаются на операторы с соответствующей семантикой в базовом каталоге. Например, для равняется оператору, предположите, что у каталога есть соответствующее правило, определяющее "равенство" атрибутов в фильтре. Это правило использовалось бы для того, чтобы проверить равенство атрибутов, определенных в фильтре с атрибутами объектов в каталоге. Точно так же, если бы у каталога есть соответствующее правило для того, чтобы упорядочить, это правило использовалось бы для того, чтобы сделать "больше чем" и "меньше чем" сравнения.

Не все операторы, определенные в RFC 2254, применимы ко всем атрибутам. Когда оператор не применим, исключение InvalidSearchFilterException бросается.

Результат возвращается в перечислении SearchResult s. Каждый SearchResult содержит имя объекта и другой информации об объекте (см. SearchResult). Имя любой относительно целевого контекста поиска (который называют name параметр), или это - строка URL. Если целевой контекст включается в перечисление (как возможно когда cons определяет поисковый контекст SearchControls.OBJECT_SCOPE или SearchControls.SUBSTREE_SCOPE), его имя является пустой строкой. SearchResult может также содержать атрибуты соответствующего объекта, если параметр cons, определенный, который приписывает быть возвращенным.

Если у объекта нет требуемого атрибута, что несуществующий атрибут будет проигнорирован. Те требуемые атрибуты, которые действительно имеет объект, будут возвращены.

Каталог мог бы возвратить больше атрибутов, чем требовалось (см. Имена типов Атрибута в описании класса), но не позволяется возвратить произвольные, несвязанные атрибуты.

См. также Операционные Атрибуты в описании класса.

Определенный:

search в интерфейсе DirContext

Параметры:

name - имя контекста или объекта искать

filter - выражение фильтра, чтобы использовать для поиска; возможно, не нуль

cons - поисковые средства управления, которые управляют поиском. Если ноль, поисковые средства управления по умолчанию используются (эквивалентный (new SearchControls())).

Возвраты:

перечисление SearchResult s объектов, которые удовлетворяют фильтр; никогда не обнуляйте

Броски:

InvalidSearchFilterException - если поисковый определенный фильтр не поддерживается или понимается под базовым каталогом

InvalidSearchControlsException - если поисковые средства управления содержат недопустимые настройки

NamingException - если с исключением именования встречаются

См. Также:

DirContext.search(Name, String, Object[], SearchControls), SearchControls, SearchResult

поиск

public NamingEnumeration<SearchResult> search(String name,
                                     String filterExpr,
                                     Object[] filterArgs,
                                     SearchControls cons)
                                       throws NamingException

Описание скопировало с интерфейса: DirContext

Поиски в именованном контексте или объекте для записей, которые удовлетворяют данный поисковый фильтр. Выполняет поиск как определено поисковыми средствами управления. См. DirContext.search(Name, String, Object[], SearchControls) для деталей.

Определенный:

search в интерфейсе DirContext

Параметры:

name - имя контекста или объекта искать

filterExpr - выражение фильтра, чтобы использовать для поиска. Выражение может содержать переменные формы"{i}"где i неотрицательное целое число., Возможно, не нуль.

filterArgs - массив параметров, чтобы заменить переменные в filterExpr. Значение filterArgs[i] заменит каждое возникновение"{i}". Если ноль, эквивалентный пустому массиву.

cons - поисковые средства управления, которые управляют поиском. Если ноль, поисковые средства управления по умолчанию используются (эквивалентный (new SearchControls())).

Возвраты:

перечисление SearchResult s объектов, которые удовлетворяют фильтр; никогда не обнуляйте

Броски:

InvalidSearchControlsException - если cons содержит недопустимые настройки

InvalidSearchFilterException - если filterExpr с filterArgs представляет недопустимый поисковый фильтр

NamingException - если с исключением именования встречаются

поиск

public NamingEnumeration<SearchResult> search(Name name,
                                     String filterExpr,
                                     Object[] filterArgs,
                                     SearchControls cons)
                                       throws NamingException

Описание скопировало с интерфейса: DirContext

Поиски в именованном контексте или объекте для записей, которые удовлетворяют данный поисковый фильтр. Выполняет поиск как определено поисковыми средствами управления.

Интерпретация filterExpr основано на RFC 2254. Это может дополнительно содержать переменные формы {i} - где i целое число - которые обращаются к объектам в filterArgs массив. Интерпретация filterExpr иначе идентично тому из filter параметр метода search(Name, String, SearchControls).

Когда переменная {i} появляется в поисковом фильтре, он указывает что параметр фильтра filterArgs[i] должен использоваться в том месте. Такие переменные могут использоваться везде, где attr, значение, или matchingrule производство появляются в грамматике фильтра RFC 2254, разделите 4. Когда оцененным строке параметром фильтра заменяют переменную, фильтр интерпретируется, как будто строка была дана вместо переменной с любыми символами, имеющими специальное значение в пределах фильтров (такой как '*') быть оставленным согласно правилам RFC 2254.

Для каталогов, которые не используют строковое представление для некоторых или всех их атрибутов, параметр фильтра, соответствующий значению атрибута, может иметь тип кроме Строки. Каталоги, которые поддерживают неструктурированные оцененные двоичному файлу атрибуты, например, должны принять байтовые массивы как параметры фильтра. Интерпретация (если кто-либо) параметров фильтра какого-либо другого типа определяется поставщиком услуг для того каталога, который отображает операции фильтра на операции с соответствующей семантикой в базовом каталоге.

Этот метод возвращает перечисление результатов. Каждый элемент в перечислении содержит имя объекта и другой информации об объекте (см. SearchResult). Имя любой относительно целевого контекста поиска (который называют name параметр), или это - строка URL. Если целевой контекст включается в перечисление (как возможно когда cons определяет поисковый контекст SearchControls.OBJECT_SCOPE или SearchControls.SUBSTREE_SCOPE), его имя является пустой строкой.

SearchResult может также содержать атрибуты соответствующего объекта, если параметр cons определяет, что атрибуты возвращаются.

Если у объекта нет требуемого атрибута, что несуществующий атрибут будет проигнорирован. Те требуемые атрибуты, которые действительно имеет объект, будут возвращены.

Каталог мог бы возвратить больше атрибутов, чем требовалось (см. Имена типов Атрибута в описании класса), но не позволяется возвратить произвольные, несвязанные атрибуты.

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

См. также Операционные Атрибуты в описании класса.

Определенный:

search в интерфейсе DirContext

Параметры:

name - имя контекста или объекта искать

filterExpr - выражение фильтра, чтобы использовать для поиска. Выражение может содержать переменные формы"{i}"где i неотрицательное целое число., Возможно, не нуль.

filterArgs - массив параметров, чтобы заменить переменные в filterExpr. Значение filterArgs[i] заменит каждое возникновение"{i}". Если ноль, эквивалентный пустому массиву.

cons - поисковые средства управления, которые управляют поиском. Если ноль, поисковые средства управления по умолчанию используются (эквивалентный (new SearchControls())).

Возвраты:

перечисление SearchResult s объектов, которые удовлетворяют фильтр; никогда не обнуляйте

Броски:

InvalidSearchControlsException - если cons содержит недопустимые настройки

InvalidSearchFilterException - если filterExpr с filterArgs представляет недопустимый поисковый фильтр

NamingException - если с исключением именования встречаются

См. Также:

DirContext.search(Name, Attributes, String[]), MessageFormat