compact3

javax.naming.ldap

Класс InitialLdapContext

java.lang. Объект

javax.naming. InitialContext

javax.naming.directory. InitialDirContext

javax.naming.ldap. InitialLdapContext

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

Контекст, DirContext, LdapContext

public class InitialLdapContext
extends InitialDirContext
implements LdapContext

Этот class является запускающимся контекстом для того, чтобы выполнить LDAPv3-стиль расширенные операции и средства управления.

См. javax.naming.InitialContext и javax.naming.InitialDirContext для деталей о синхронизации, и политику для того, как создается начальный контекст.

Средства управления запросом

Когда Вы создаете начальный контекст (InitialLdapContext), можно определить список средств управления запросом. Эти средства управления будут использоваться, поскольку средства управления запросом для любого неявного LDAP "связывают" работу, выполняемую контекстом или контекстами, полученными из контекста. Их вызывают средствами управления запросом соединения. Используйте getConnectControls(), чтобы получить средства управления запросом соединения контекста.

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

Как показано может быть два различных набора средств управления запросом, связанных с контекстом: средства управления запросом соединения и контекст запрашивают средства управления. Это требуется для тех приложений, бывших должных отправить критические средства управления, которые не могли бы быть применимыми и к работе контекста и к любому неявному LDAP, "связывают" работу. Типичная пользовательская программа сделала бы следующее:

 InitialLdapContext lctx = new InitialLdapContext(env, critConnCtls);
 lctx.setRequestControls(critModCtls);
 lctx.modifyAttributes(name, mods);
 Controls[] respCtls =  lctx.getResponseControls();

Это определяет сначала критические средства управления для того, чтобы создать начальный контекст (critConnCtls), и затем устанавливает средства управления запросом контекста (critModCtls) для работы контекста. Если по некоторым причинам lctx должен повторно соединиться с сервером, он будет использовать critConnCtls. См., что LdapContext взаимодействует через интерфейс для большего количества дискуссии о средствах управления запросом.

Конструкторы поставщика услуг должны считать раздел "Поставщика услуг" в LdapContext описание class для деталей реализации.

С тех пор:

1.3

См. Также:

LdapContext, InitialContext, InitialDirContext, NamingManager.setInitialContextFactoryBuilder(javax.naming.spi.InitialContextFactoryBuilder)

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

Поля, наследованные от class javax.naming. InitialContext

defaultInitCtx, gotDefault, myProps

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

CONTROL_FACTORIES

Поля, наследованные от интерфейса 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

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

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

Конструктор и Описание
InitialLdapContext() Создает начальный контекст, не используя свойств среды или средств управления запросом соединения.
InitialLdapContext(Hashtable<?,?> environment, Control[] connCtls) Создает начальный контекст, используя свойства среды и средства управления запросом соединения.

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

Модификатор и Тип	Метод и Описание
ExtendedResponse	extendedOperation(ExtendedRequest request) Выполняет расширенную работу.
Управление[]	getConnectControls() Получает средства управления запросом соединения в действительности для этого контекста.
Управление[]	getRequestControls() Получает средства управления запросом в действительности для этого контекста.
Управление[]	getResponseControls() Получает средства управления ответом, произведенные в результате последнего метода, вызванного на этот контекст.
LdapContext	newInstance(Control[] reqCtls) Создает новый экземпляр этого контекста, инициализированного, используя средства управления запросом.
void	reconnect(Control[] connCtls) Повторно соединяется с сервером LDAP, используя предоставленные средства управления и среду этого контекста.
void	setRequestControls(Control[] requestControls) Устанавливает средства управления запросом для методов, впоследствии вызванных на этот контекст.

Методы, наследованные от class javax.naming.directory. InitialDirContext

bind, bind, createSubcontext, createSubcontext, getAttributes, getAttributes, getAttributes, getAttributes, getSchema, getSchema, getSchemaClassDefinition, getSchemaClassDefinition, modifyAttributes, modifyAttributes, modifyAttributes, modifyAttributes, rebind, rebind, search, search, search, search, search, search, search, search

Методы, наследованные от class 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

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

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

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

bind, bind, createSubcontext, createSubcontext, getAttributes, getAttributes, getAttributes, getAttributes, getSchema, getSchema, getSchemaClassDefinition, getSchemaClassDefinition, modifyAttributes, modifyAttributes, modifyAttributes, modifyAttributes, rebind, rebind, search, search, search, search, search, search, search, search

Методы, наследованные от интерфейса 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

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

InitialLdapContext

public InitialLdapContext()
                   throws NamingException

Создает начальный контекст, не используя свойств среды или средств управления запросом соединения. Эквивалентный new InitialLdapContext(null, null).

Броски:

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

InitialLdapContext

public InitialLdapContext(Hashtable<?,?> environment,
                          Control[] connCtls)
                   throws NamingException

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

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

connCtls используется в качестве базовых средств управления запросом соединения экземпляра контекста. См. описание class для деталей.

Параметры:

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

connCtls - запрос соединения управляет для начального контекста. Если ноль, никакие средства управления запросом соединения не используются.

Броски:

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

См. Также:

reconnect(javax.naming.ldap.Control[]), LdapContext.reconnect(javax.naming.ldap.Control[])

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

extendedOperation

public ExtendedResponse extendedOperation(ExtendedRequest request)
                                   throws NamingException

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

Выполняет расширенную работу. Этот метод используется, чтобы поддерживать LDAPv3 расширенные операции.

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

extendedOperation в интерфейсе LdapContext

Параметры:

request - Ненулевой запрос, который будет выполнен.

Возвраты:

Возможно нулевой ответ работы. нуль означает, что работа не генерировала ответа.

Броски:

NamingException - Если ошибка произошла, выполняя расширенную работу.

newInstance

public LdapContext newInstance(Control[] reqCtls)
                        throws NamingException

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

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

У нового контекста есть те же самые свойства среды и средства управления запросом соединения как этот контекст. См. описание class для деталей. Реализации могли бы также позволить этому контексту и новому контексту совместно использовать то же самое сетевое соединение или другие ресурсы, если выполнение так не препятствует независимости любого контекста.

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

newInstance в интерфейсе LdapContext

Параметры:

reqCtls - Возможно нуль запрашивают средства управления использовать для нового контекста. Если ноль, контекст инициализируется без средств управления запросом.

Возвраты:

Ненулевой экземпляр LdapContext.

Броски:

NamingException - Если ошибка произошла, создавая новый экземпляр.

См. Также:

InitialLdapContext

повторно соединиться

public void reconnect(Control[] connCtls)
               throws NamingException

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

Повторно соединяется с сервером LDAP, используя предоставленные средства управления и среду этого контекста.

Этот метод является способом явно инициировать LDAP, "связывают" работу. Например, можно использовать этот метод, чтобы установить средства управления запросом для LDAP, "связывают" работу, или явно соединяться с сервером, чтобы возвратить средства управления ответом LDAP "связывают" работу.

Этот метод устанавливает connCtls этого контекста, чтобы быть его новыми средствами управления запросом соединения. На средства управления запросом контекста этого контекста не влияют. После того, как этот метод был вызван, любые последующие неявные пересоединения будут сделаны, используя connCtls. connCtls также используется в качестве средств управления запросом соединения для новых экземпляров контекста, полученных из этого контекста. На эти средства управления запросом соединения не влияет setRequestControls().

Конструкторы поставщика услуг должны считать раздел "Поставщика услуг" в описании class для деталей реализации.

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

reconnect в интерфейсе LdapContext

Параметры:

connCtls - Возможно нуль управляет, чтобы использовать. Если ноль, никакие средства управления не используются.

Броски:

NamingException - Если ошибка произошла, повторно соединяясь.

См. Также:

LdapContext.getConnectControls(), LdapContext.newInstance(javax.naming.ldap.Control[])

getConnectControls

public Control[] getConnectControls()
                             throws NamingException

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

Получает средства управления запросом соединения в действительности для этого контекста. Средства управления принадлежат реализации JNDI и являются неизменными. Ни массив, ни средства управления не могут быть изменены вызывающей стороной.

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

getConnectControls в интерфейсе LdapContext

Возвраты:

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

Броски:

NamingException - Если ошибка произошла, получая средства управления запросом.

setRequestControls

public void setRequestControls(Control[] requestControls)
                        throws NamingException

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

Устанавливает средства управления запросом для методов, впоследствии вызванных на этот контекст. Средства управления запросом принадлежат реализации JNDI и являются неизменными. Ни массив, ни средства управления не могут быть изменены вызывающей стороной.

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

Отметьте, что requestControls будет в действительности до следующего вызова setRequestControls(). Вы должны явно вызвать setRequestControls() с null или пустым массивом, чтобы очистить средства управления, если Вы не хотите, чтобы они больше влияли на методы контекста. Чтобы проверить, что средства управления запросом в действительности для этого контекста, используйте getRequestControls().

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

setRequestControls в интерфейсе LdapContext

Параметры:

requestControls - Возможно нуль управляет, чтобы использовать. Если ноль, никакие средства управления не используются.

Броски:

NamingException - Если ошибка произошла, устанавливая средства управления запросом.

См. Также:

LdapContext.getRequestControls()

getRequestControls

public Control[] getRequestControls()
                             throws NamingException

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

Получает средства управления запросом в действительности для этого контекста. Средства управления запросом принадлежат реализации JNDI и являются неизменными. Ни массив, ни средства управления не могут быть изменены вызывающей стороной.

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

getRequestControls в интерфейсе LdapContext

Возвраты:

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

Броски:

NamingException - Если ошибка произошла, получая средства управления запросом.

См. Также:

LdapContext.setRequestControls(javax.naming.ldap.Control[])

getResponseControls

public Control[] getResponseControls()
                              throws NamingException

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

Получает средства управления ответом, произведенные в результате последнего метода, вызванного на этот контекст. Средства управления ответом принадлежат реализации JNDI и являются неизменными. Ни массив, ни средства управления не могут быть изменены вызывающей стороной.

Эти средства управления ответом, возможно, были сгенерированы успешной или отказавшей работой.

Когда метод контекста, который может возвратить средства управления ответом, вызывается, средства управления ответом от предыдущего вызова метода очищаются. getResponseControls() возвращает все средства управления ответом, сгенерированные операциями LDAP, используемыми методом контекста в порядке, полученном от сервера LDAP. Вызов getResponseControls() не очищает средства управления ответом. Можно вызвать это много раз (и возвратить те же самые средства управления) до следующего метода контекста, который может возвратиться, средства управления вызывается.

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

getResponseControls в интерфейсе LdapContext

Возвраты:

Возможно нулевой массив средств управления. Если ноль, предыдущий метод, вызванный на этот контекст, не производил средств управления.

Броски:

NamingException - Если ошибка произошла, получая средства управления ответом.