Модуль java.naming
Общие стандартные свойства среды JNDI, которые могут поддерживаться поставщиками JNDI, определены и описаны в Context. Конкретные реализации поставщиков JNDI могут также поддерживать другие свойства среды или системы, специфичные для их реализации.
- Примечание по реализации:
- Следующие свойства среды, специфичные для реализации, поддерживаются реализацией поставщика службы именования LDAP по умолчанию в JDK:
-
java.naming.ldap.factory.socket:
Значение этого свойства среды задает полное имя класса фабрики сокетов, используемой поставщиком LDAP. Этот класс должен реализовывать абстрактный классSocketFactoryи предоставлять реализацию статического метода "getDefault()", возвращающего экземпляр фабрики сокетов. По умолчанию свойство среды не задано. -
com.sun.jndi.ldap.connect.timeout:
Значение этого свойства среды — строковое представление целого числа, задающего время ожидания подключения в миллисекундах. Если поставщик LDAP не может установить подключение за указанный период, он прерывает попытку подключения. Целое число должно быть больше нуля. Целое число, меньшее или равное нулю, означает использование значения времени ожидания сетевого протокола (т. е. TCP).
Если это свойство не задано, по умолчанию ожидание продолжается до установления подключения или истечения времени ожидания на нижележащем сетевом уровне.
Если пользовательская фабрика сокетов указана с помощью свойства средыjava.naming.ldap.factory.socketи неподключенные сокеты не поддерживаются, заданное время ожидания игнорируется, и поставщик ведет себя так, как если бы время ожидания подключения не было установлено. -
com.sun.jndi.ldap.read.timeout:
Значение этого свойства — строковое представление целого числа, задающего время ожидания чтения в миллисекундах для операций LDAP. Если поставщик LDAP не может получить ответ LDAP за указанный период, он прерывает попытку чтения. Целое число должно быть больше нуля. Целое число, меньшее или равное нулю, означает, что время ожидания чтения не задано, что эквивалентно бесконечному ожиданию получения ответа.
Если это свойство не задано, по умолчанию ожидание продолжается до получения ответа. -
com.sun.jndi.ldap.tls.cbtype:
Значение этого свойства — строка, задающая тип привязки канала TLS, необходимый для подключения LDAP через SSL/TLS. Возможное значение:- "tls-server-end-point" — данные привязки канала создаются на основе сертификата сервера TLS.
Тип привязки канала TLS "tls-unique" указан в RFC-5929, но не поддерживается.
Если это свойство не задано, клиент не отправляет серверу сведения о привязке канала.
Следующие системные свойства, специфичные для реализации, поддерживаются реализацией поставщика службы именования LDAP по умолчанию в JDK:
-
com.sun.jndi.ldap.object.trustSerialData:
Значение этого системного свойства — строковое представление логического значения, которое управляет десериализацией объектов Java из атрибута LDAPjavaSerializedData, восстановлением ссылок RMI из атрибута LDAPjavaRemoteLocationи восстановлением двоичных адресов ссылок из атрибута LDAPjavaReferenceAddress. Чтобы разрешить десериализацию или восстановление объектов Java из атрибутовjavaSerializedData,javaRemoteLocationилиjavaReferenceAddress, значение системного свойства можно установить вtrue(без учета регистра).
Если свойство не задано, десериализация объектов Java из атрибутовjavaSerializedData,javaRemoteLocationилиjavaReferenceAddressне разрешена. -
jdk.jndi.object.factoriesFilter:
Значение этого системного свойства задает фильтр, используемый средой выполнения JNDI для управления набором классов фабрик объектов, которым разрешено создавать объекты из ссылок на объекты, возвращаемых системами именования/каталогов. Класс фабрики, указанный экземпляром ссылки, проверяется на соответствие этому фильтру. Свойство фильтра поддерживает синтаксис фильтра на основе шаблонов в том же формате, что иjdk.serialFilter. Шаблоны ограничения, указанные в свойстве фильтра, не используются. Это свойство также можно задать как свойство безопасности. Это свойство также поддерживается поставщиком JNDI RMI по умолчанию.
Значение по умолчанию разрешает любому классу фабрики объектов, указанному экземпляром ссылки, повторно создать объект, на который ссылается ссылка. -
jdk.jndi.ldap.object.factoriesFilter:
Значение этого системного свойства задает фильтр, используемый реализацией поставщика LDAP в JDK для дополнительного ограничения набора классов фабрик объектов, которым разрешено создавать объекты из ссылок на объекты, возвращаемых системами LDAP. Сначала класс фабрики, указанный экземпляром ссылки, проверяется на соответствие этому специальному фильтру, а затем — глобальному фильтру. Класс фабрики отклоняется, если его отклоняет любой из этих двух фильтров или если ни один из них его не разрешает. Свойство фильтра поддерживает синтаксис фильтра на основе шаблонов в том же формате, что иjdk.serialFilter. Шаблоны ограничения, указанные в свойстве фильтра, не используются.
Значение по умолчанию разрешает любые классы фабрик объектов, предоставляемые реализацией поставщика LDAP в JDK.
Это системное свойство будет использоваться для фильтрации только специфичных для LDAP фабрик объектов, если глобальныйObjectFactoryBuilderне задан.
Другие поставщики могут определять дополнительные свойства в описании своего модуля:
-
- Граф модулей:
- Начиная с версии:
- 9
Пакеты
| Пакет | Описание |
|---|---|
| javax.naming | Предоставляет классы и интерфейсы для доступа к службам именования. |
| javax.naming.directory | Расширяет пакет javax.naming, предоставляя функции для доступа к службам каталогов. |
| javax.naming.event | Предоставляет поддержку уведомлений о событиях при доступе к службам именования и каталогов. |
| javax.naming.ldap | Предоставляет поддержку расширенных операций и элементов управления LDAPv3. |
| javax.naming.ldap.spi | Предоставляет интерфейс поставщика служб для поиска DNS при выполнении операций LDAP. |
| javax.naming.spi | Предоставляет средства для динамического подключения поддержки доступа к службам именования и каталогов через пакет javax.naming и связанные с ним пакеты. |
Службы
| Тип | Описание |
|---|---|
| Provider | Этот класс представляет «поставщика» API безопасности Java, реализующего некоторые или все компоненты системы безопасности Java. |
| Тип | Описание |
|---|---|
| InitialContextFactory | Этот интерфейс представляет фабрику, создающую начальный контекст. |
| LdapDnsProvider | Класс поставщика служб для поиска DNS при выполнении операций LDAP. |
| StartTlsResponse | Этот класс реализует расширенный ответ LDAPv3 для StartTLS, определенный в документе Облегченный протокол доступа к каталогам (v3): расширение для защиты транспортного уровня. Идентификатор объекта для StartTLS — 1.3.6.1.4.1.1466.20037; значение расширенного ответа не определено. |
© 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.naming/module-summary.html