Класс InitialLdapContext

java.lang.Object
- javax.naming.InitialContext
- - javax.naming.directory.InitialDirContext
  - - javax.naming.ldap.InitialLdapContext

Все реализованные интерфейсы:: Context, DirContext, LdapContext

public class InitialLdapContext
extends InitialDirContext
implements LdapContext

Этот класс является начальным контекстом для выполнения расширенных операций и контролей LDAPv3.

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

Управляющие элементы запроса

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

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

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

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

Она сначала указывает критические управляющие элементы для создания начального контекста (critConnCtls), а затем устанавливает управляющие элементы запроса контекста (critModCtls) для операции контекста. Если по какой-то причине lctx необходимо переподключиться к серверу, она будет использовать critConnCtls. Подробнее об управляющих элементах запроса см. интерфейс LdapContext.

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

С:: 1.3
См. также:: LdapContext, InitialContext, InitialDirContext, NamingManager.setInitialContextFactoryBuilder(javax.naming.spi.InitialContextFactoryBuilder)

Поля

Поля, объявленные в классе javax.naming.InitialContext

defaultInitCtx, gotDefault, myProps

Поля, объявленные в интерфейсе javax.naming.Context

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

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

ADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTE

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

CONTROL_FACTORIES

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

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

Методы

Методы, объявленные в классе javax.naming.InitialContext

composeName, composeName, doLookup, doLookup, getDefaultInitCtx, getURLOrDefaultInitCtx, getURLOrDefaultInitCtx, init

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

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

Методы, объявленные в интерфейсе javax.naming.Context

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

Методы, объявленные в интерфейсе 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.ldap.LdapContext

extendedOperation, getConnectControls, getRequestControls, getResponseControls, newInstance, reconnect, setRequestControls

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

InitialLdapContext

public InitialLdapContext()
                   throws NamingException

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

Исключения:: NamingException — если возникло исключение именования

InitialLdapContext

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

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

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

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

Параметры:: environment — среда, используемая для создания начального DirContext. Null указывает пустую среду.; connCtls — управляющие элементы запроса подключения для начального контекста. Если null, управляющие элементы запроса подключения не используются.
Исключения:: NamingException — если возникло исключение именования
См. также:: LdapContext.reconnect(javax.naming.ldap.Control[]), LdapContext.reconnect(javax.naming.ldap.Control[])