Spec-Zone.ru › OpenJDK 25

Модуль java.naming

module java.naming
Определяет API Java Naming and Directory Interface (JNDI).

Общие стандартные свойства среды 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 из атрибута LDAP javaSerializedData, восстановлением ссылок RMI из атрибута LDAP javaRemoteLocation и восстановлением двоичных адресов ссылок из атрибута LDAP javaReferenceAddress. Чтобы разрешить десериализацию или восстановление объектов 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 не задан.

Другие поставщики могут определять дополнительные свойства в описании своего модуля:

  • Поставщик именования DNS
  • Поставщик именования RMI
Граф модулей:
Module graph for java.namingModule graph for java.naming
Начиная с версии:
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; значение расширенного ответа не определено.

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее дочерних компаний в США и других странах.
Авторское право © 1993, 2025, Oracle и/или ее дочерние компании, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API