Класс InitialLdapContext
- Все реализуемые интерфейсы:
Context, DirContext, LdapContext
public class InitialLdapContext extends InitialDirContext implements LdapContext
См. javax.naming.InitialContext и javax.naming.InitialDirContext для получения сведений о синхронизации и политике создания начального контекста.
Элементы управления запросами
При создании начального контекста (InitialLdapContext) можно указать список элементов управления запросами. Эти элементы управления будут использоваться как элементы управления запросами для любой неявной операции LDAP «bind», выполняемой контекстом или производными от него контекстами. Они называются элементами управления запросами соединения. Используйте getConnectControls(), чтобы получить элементы управления запросами соединения для контекста. Элементы управления запросами, переданные конструктору начального контекста, не используются в качестве элементов управления запросами контекста для последующих операций с контекстом, таких как поиск и поиск по имени. Элементы управления запросами контекста задаются и обновляются с помощью setRequestControls().
Как показано, с контекстом могут быть связаны два разных набора элементов управления запросами: элементы управления запросами соединения и элементы управления запросами контекста. Это необходимо приложениям, которым требуется отправлять критические элементы управления, которые могут быть неприменимы одновременно к операции с контекстом и любой неявной операции LDAP «bind». Типичная пользовательская программа будет выполнять следующие действия:
Сначала в ней указываются критические элементы управления для создания начального контекста (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
- См. также:
Краткое описание полей
Поля, объявленные в классе InitialContext
defaultInitCtx, gotDefault, myProps | Модификатор и тип | Поле | Описание |
|---|---|---|
protected Context |
defaultInitCtx |
Поле, содержащее результат вызова NamingManager.getInitialContext(). |
protected boolean |
gotDefault |
Поле, указывающее, был ли начальный контекст получен вызовом NamingManager.getInitialContext(). |
protected Hashtable |
myProps |
Среда, связанная с этим InitialContext. |
Поля, объявленные в интерфейсе Context
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 | Модификатор и тип | Поле | Описание |
|---|---|---|
static final String |
AUTHORITATIVE |
Константа, содержащая имя свойства среды для указания авторитетности запрошенной службы. |
static final String |
BATCHSIZE |
Константа, содержащая имя свойства среды для указания размера пакета данных, возвращаемых с помощью протокола службы. |
static final String |
DNS_URL |
Константа, содержащая имя свойства среды для указания имен хоста и домена DNS, используемых контекстом URL JNDI (например, "dns://somehost/wiz.com"). |
static final String |
INITIAL_CONTEXT_FACTORY |
Константа, содержащая имя свойства среды для указания используемой фабрики начального контекста. |
static final String |
LANGUAGE |
Константа, содержащая имя свойства среды для указания предпочтительного языка, используемого службой. |
static final String |
OBJECT_FACTORIES |
Константа, содержащая имя свойства среды для указания списка используемых фабрик объектов. |
static final String |
PROVIDER_URL |
Константа, содержащая имя свойства среды для указания конфигурационных данных, используемых поставщиком службы. |
static final String |
REFERRAL |
Константа, содержащая имя свойства среды для указания способа обработки перенаправлений, обнаруженных поставщиком службы. |
static final String |
SECURITY_AUTHENTICATION |
Константа, содержащая имя свойства среды для указания используемого уровня безопасности. |
static final String |
SECURITY_CREDENTIALS |
Константа, содержащая имя свойства среды для указания учетных данных субъекта, используемых для аутентификации вызывающего объекта в службе. |
static final String |
SECURITY_PRINCIPAL |
Константа, содержащая имя свойства среды для указания идентификатора субъекта, используемого для аутентификации вызывающего объекта в службе. |
static final String |
SECURITY_PROTOCOL |
Константа, содержащая имя свойства среды для указания используемого протокола безопасности. |
static final String |
STATE_FACTORIES |
Константа, содержащая имя свойства среды для указания списка используемых фабрик состояний. |
static final String |
URL_PKG_PREFIXES |
Константа, содержащая имя свойства среды для указания списка префиксов пакетов, используемых при загрузке фабрик контекстов URL. |
Поля, объявленные в интерфейсе DirContext
ADD_ATTRIBUTE, REMOVE_ATTRIBUTE, REPLACE_ATTRIBUTE | Модификатор и тип | Поле | Описание |
|---|---|---|
static final int |
ADD_ATTRIBUTE |
Эта константа указывает на добавление атрибута с указанными значениями. |
static final int |
REMOVE_ATTRIBUTE |
Эта константа указывает на удаление указанных значений атрибута из атрибута. |
static final int |
REPLACE_ATTRIBUTE |
Эта константа указывает на замену атрибута указанными значениями. |
Поля, объявленные в интерфейсе LdapContext
CONTROL_FACTORIES | Модификатор и тип | Поле | Описание |
|---|---|---|
static final String |
CONTROL_FACTORIES |
Константа, содержащая имя свойства среды для указания списка используемых фабрик элементов управления. |
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
InitialLdapContext() |
Создает начальный контекст без свойств среды и элементов управления запросами соединения. |
InitialLdapContext |
Создает начальный контекст с использованием свойств среды и элементов управления запросами соединения. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
ExtendedResponse |
extendedOperation |
Выполняет расширенную операцию. |
Control[] |
getConnectControls() |
Получает действующие для этого контекста элементы управления запросами соединения. |
Control[] |
getRequestControls() |
Получает действующие для этого контекста элементы управления запросами. |
Control[] |
getResponseControls() |
Получает элементы управления ответом, сформированные в результате последнего вызова метода для этого контекста. |
LdapContext |
newInstance |
Создает новый экземпляр этого контекста, инициализированный с использованием элементов управления запросами. |
void |
reconnect |
Повторно подключается к серверу LDAP с использованием предоставленных элементов управления и среды этого контекста. |
void |
setRequestControls |
Задает элементы управления запросами для последующих вызовов методов этого контекста. |
Методы, объявленные в классе 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 | Модификатор и тип | Метод | Описание |
|---|---|---|
void |
bind |
Связывает имя с объектом и связанными с ним атрибутами. |
void |
bind |
Связывает имя с объектом и связанными с ним атрибутами. |
DirContext |
createSubcontext |
Создает и связывает новый контекст с соответствующими атрибутами. |
DirContext |
createSubcontext |
Создает и связывает новый контекст с соответствующими атрибутами. |
Attributes |
getAttributes |
Получает все атрибуты, связанные с указанным объектом. |
Attributes |
getAttributes |
Получает выбранные атрибуты, связанные с указанным объектом. |
Attributes |
getAttributes |
Получает все атрибуты, связанные с указанным объектом. |
Attributes |
getAttributes |
Получает выбранные атрибуты, связанные с указанным объектом. |
DirContext |
getSchema |
Получает схему, связанную с указанным объектом. |
DirContext |
getSchema |
Получает схему, связанную с указанным объектом. |
DirContext |
getSchemaClassDefinition |
Получает контекст, содержащий объекты схемы для определений классов указанного объекта. |
DirContext |
getSchemaClassDefinition |
Получает контекст, содержащий объекты схемы для определений классов указанного объекта. |
void |
modifyAttributes |
Изменяет атрибуты, связанные с указанным объектом. |
void |
modifyAttributes |
Изменяет атрибуты, связанные с указанным объектом, используя упорядоченный список изменений. |
void |
modifyAttributes |
Изменяет атрибуты, связанные с указанным объектом. |
void |
modifyAttributes |
Изменяет атрибуты, связанные с указанным объектом, используя упорядоченный список изменений. |
void |
rebind |
Связывает имя с объектом и связанными с ним атрибутами, перезаписывая существующую привязку. |
void |
rebind |
Связывает имя с объектом и связанными с ним атрибутами, перезаписывая существующую привязку. |
NamingEnumeration |
search |
Выполняет поиск в указанном контексте или объекте записей, соответствующих заданному фильтру поиска. |
NamingEnumeration |
search |
Выполняет поиск в указанном контексте или объекте записей, соответствующих заданному фильтру поиска. |
NamingEnumeration |
search |
Выполняет поиск в одном контексте объектов, содержащих указанный набор атрибутов. |
NamingEnumeration |
search |
Выполняет поиск в одном контексте объектов, содержащих указанный набор атрибутов, и получает выбранные атрибуты. |
NamingEnumeration |
search |
Выполняет поиск в указанном контексте или объекте записей, соответствующих заданному фильтру поиска. |
NamingEnumeration |
search |
Выполняет поиск в указанном контексте или объекте записей, соответствующих заданному фильтру поиска. |
NamingEnumeration |
search |
Выполняет поиск в одном контексте объектов, содержащих указанный набор атрибутов. |
NamingEnumeration |
search |
Выполняет поиск в одном контексте объектов, содержащих указанный набор атрибутов, и получает выбранные атрибуты. |
Методы, объявленные в классе 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 | Модификатор и тип | Метод | Описание |
|---|---|---|
Object |
addToEnvironment |
Добавляет новое свойство среды в среду этого контекста. |
void |
bind |
Связывает имя с объектом. |
void |
bind |
Связывает имя с объектом. |
void |
close() |
Закрывает этот контекст. |
String |
composeName |
Объединяет имя этого контекста с именем, относительным к этому контексту. |
Name |
composeName |
Объединяет имя этого контекста с именем, относительным к этому контексту. |
Context |
createSubcontext |
Создает и связывает новый контекст. |
Context |
createSubcontext |
Создает и связывает новый контекст. |
void |
destroySubcontext |
Удаляет указанный контекст и исключает его из пространства имен. |
void |
destroySubcontext |
Удаляет указанный контекст и исключает его из пространства имен. |
static <T> T |
doLookup |
Статический метод для получения указанного объекта. |
static <T> T |
doLookup |
Статический метод для получения указанного объекта. |
protected Context |
getDefaultInitCtx() |
Получает начальный контекст, вызывая NamingManager.getInitialContext(), и кэширует его в defaultInitCtx. |
Hashtable |
getEnvironment() |
Получает среду, действующую для этого контекста. |
String |
getNameInNamespace() |
Получает полное имя этого контекста в его собственном пространстве имен. |
NameParser |
getNameParser |
Получает анализатор, связанный с указанным контекстом. |
NameParser |
getNameParser |
Получает анализатор, связанный с указанным контекстом. |
protected Context |
getURLOrDefaultInitCtx |
Получает контекст для разрешения строкового имени name. |
protected Context |
getURLOrDefaultInitCtx |
Получает контекст для разрешения name. |
protected void |
init |
Инициализирует начальный контекст с использованием предоставленной среды. |
NamingEnumeration |
list |
Перечисляет имена, связанные в указанном контексте, вместе с именами классов привязанных к ним объектов. |
NamingEnumeration |
list |
Перечисляет имена, связанные в указанном контексте, вместе с именами классов привязанных к ним объектов. |
NamingEnumeration |
listBindings |
Перечисляет имена, связанные в указанном контексте, вместе с привязанными к ним объектами. |
NamingEnumeration |
listBindings |
Перечисляет имена, связанные в указанном контексте, вместе с привязанными к ним объектами. |
Object |
lookup |
Получает указанный объект. |
Object |
lookup |
Получает указанный объект. |
Object |
lookupLink |
Получает указанный объект, следуя по ссылкам, кроме конечного атомарного компонента имени. |
Object |
lookupLink |
Получает указанный объект, следуя по ссылкам, кроме конечного атомарного компонента имени. |
void |
rebind |
Связывает имя с объектом, перезаписывая существующую привязку. |
void |
rebind |
Связывает имя с объектом, перезаписывая существующую привязку. |
Object |
removeFromEnvironment |
Удаляет свойство среды из среды этого контекста. |
void |
rename |
Связывает новое имя с объектом, привязанным к старому имени, и отменяет привязку старого имени. |
void |
rename |
Связывает новое имя с объектом, привязанным к старому имени, и отменяет привязку старого имени. |
void |
unbind |
Отменяет привязку указанного объекта. |
void |
unbind |
Отменяет привязку указанного объекта. |
Методы, объявленные в классе Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait | Модификатор и тип | Метод | Описание |
|---|---|---|
protected Object |
clone() |
Создает и возвращает копию этого объекта. |
boolean |
equals |
Указывает, равен ли этот объект какому-либо другому объекту. |
protected void |
finalize() |
Устарело и подлежит удалению: этот элемент API может быть удален в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков. |
final Class |
getClass() |
Возвращает класс времени выполнения этого Object. |
int |
hashCode() |
Возвращает хеш-код этого объекта. |
final void |
notify() |
Пробуждает один поток, ожидающий на мониторе этого объекта. |
final void |
notifyAll() |
Пробуждает все потоки, ожидающие на мониторе этого объекта. |
String |
toString() |
Возвращает строковое представление объекта. |
final void |
wait() |
Заставляет текущий поток ждать пробуждения, обычно в результате вызова метода notify или interrupt. |
final void |
wait |
Заставляет текущий поток ждать пробуждения, обычно в результате вызова метода notify или interrupt либо по истечении определенного промежутка реального времени. |
final void |
wait |
Заставляет текущий поток ждать пробуждения, обычно в результате вызова метода notify или interrupt либо по истечении определенного промежутка реального времени. |
Подробное описание конструкторов
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— если возникло исключение именования - См. также:
Подробное описание методов
extendedOperation
public ExtendedResponse extendedOperation(ExtendedRequest request) throws NamingException
LdapContext- Определено в:
-
extendedOperationв интерфейсеLdapContext - Параметры:
-
request— запрос, который необходимо выполнить; не может быть null. - Возвращает:
- Возможно, null-ответ операции. Значение null означает, что операция не создала ответа.
- Выбрасывает:
-
NamingException— если при выполнении расширенной операции произошла ошибка.
newInstance
public LdapContext newInstance(Control[] reqCtls) throws NamingException
LdapContextНовый контекст имеет те же свойства среды и управляющие элементы запроса на подключение, что и этот контекст. Подробности см. в описании класса. Реализации также могут позволять этому контексту и новому контексту совместно использовать одно сетевое подключение или другие ресурсы, если это не препятствует независимой работе любого из контекстов.
- Определено в:
-
newInstanceв интерфейсеLdapContext - Параметры:
-
reqCtls— возможно, null-массив управляющих элементов запроса, которые следует использовать для нового контекста. Если значение null, контекст инициализируется без управляющих элементов запроса. - Возвращает:
- Ненулевой экземпляр
LdapContext. - Выбрасывает:
-
NamingException— если при создании нового экземпляра произошла ошибка. - См. также:
reconnect
public void reconnect(Control[] connCtls) throws NamingException
LdapContextЭтот метод позволяет явно инициировать операцию LDAP «bind». Например, его можно использовать для задания управляющих элементов запроса для операции LDAP «bind» или для явного подключения к серверу, чтобы получить управляющие элементы ответа, возвращенные операцией LDAP «bind».
Этот метод устанавливает connCtls этого контекста в качестве новых управляющих элементов запроса на подключение. Управляющие элементы запроса контекста не изменяются. После вызова этого метода все последующие неявные повторные подключения будут выполняться с использованием connCtls. connCtls также используются как управляющие элементы запроса на подключение для новых экземпляров контекста, созданных на основе этого контекста. Эти управляющие элементы запроса на подключение не изменяются при вызове setRequestControls().
Разработчикам поставщиков служб следует ознакомиться с разделом «Поставщик служб» в описании класса, где приведены сведения о реализации.
- Определено в:
-
reconnectв интерфейсеLdapContext - Параметры:
-
connCtls— возможно, null-массив управляющих элементов, которые следует использовать. Если значение null, управляющие элементы не используются. - Выбрасывает:
-
NamingException— если при повторном подключении произошла ошибка. - См. также:
getConnectControls
public Control[] getConnectControls() throws NamingException
LdapContext- Определено в:
-
getConnectControlsв интерфейсеLdapContext - Возвращает:
- Возможно, null-массив управляющих элементов. Значение null означает, что для этого контекста не заданы управляющие элементы подключения.
- Выбрасывает:
-
NamingException— если при получении управляющих элементов запроса произошла ошибка.
setRequestControls
public void setRequestControls(Control[] requestControls) throws NamingException
LdapContext Этот метод удаляет все ранее заданные управляющие элементы запроса и добавляет requestControls для использования последующими методами, вызываемыми для этого контекста. Он не влияет на управляющие элементы запроса на подключение этого контекста.
Обратите внимание: requestControls будут действовать до следующего вызова setRequestControls(). Если вы больше не хотите, чтобы они влияли на методы контекста, необходимо явно вызвать setRequestControls() с аргументом null или пустым массивом, чтобы очистить управляющие элементы. Чтобы проверить, какие управляющие элементы запроса действуют для этого контекста, используйте getRequestControls().
- Определено в:
-
setRequestControlsв интерфейсеLdapContext - Параметры:
-
requestControls— возможно, null-массив управляющих элементов, которые следует использовать. Если значение null, управляющие элементы не используются. - Выбрасывает:
-
NamingException— если при задании управляющих элементов запроса произошла ошибка. - См. также:
getRequestControls
public Control[] getRequestControls() throws NamingException
LdapContext- Определено в:
-
getRequestControlsв интерфейсеLdapContext - Возвращает:
- Возможно, null-массив управляющих элементов. Значение null означает, что для этого контекста не заданы управляющие элементы запроса.
- Выбрасывает:
-
NamingException— если при получении управляющих элементов запроса произошла ошибка. - См. также:
getResponseControls
public Control[] getResponseControls() throws NamingException
LdapContextЭти управляющие элементы ответа могли быть созданы в результате успешной или неудачной операции.
При вызове метода контекста, который может возвращать управляющие элементы ответа, управляющие элементы, полученные при предыдущем вызове метода, очищаются. getResponseControls() возвращает все управляющие элементы ответа, созданные операциями LDAP, использованными методом контекста, в порядке их получения от сервера LDAP. Вызов getResponseControls() не очищает управляющие элементы ответа. Его можно вызывать многократно (получая те же управляющие элементы) до вызова следующего метода контекста, который может возвращать управляющие элементы.
- Определено в:
-
getResponseControlsв интерфейсеLdapContext - Возвращает:
- Возможно, null-массив управляющих элементов. Значение null означает, что предыдущий вызов метода для этого контекста не создал управляющих элементов.
- Выбрасывает:
-
NamingException— если при получении управляющих элементов ответа произошла ошибка.
© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.