Spec-Zone.ru › OpenJDK 24

Модуль java.naming

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

Общие стандартные свойства среды JNDI, которые могут поддерживаться поставщиками JNDI, определены и задокументированы в Context. Конкретные реализации поставщиков JNDI также могут поддерживать другие свойства среды или системы, специфичные для их реализации.

Примечание реализации:
Следующие свойства среды, специфичные для реализации, поддерживаются реализацией поставщика LDAP Naming Service по умолчанию в 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-unique" Тип привязки канала TLS указан в RFC-5929, но не поддерживается.
    Если это свойство не указано, клиент не отправляет информацию о привязке канала серверу.

Следующие свойства системы, специфичные для реализации, поддерживаются реализацией поставщика LDAP Naming Service по умолчанию в JDK:

  • com.sun.jndi.ldap.object.trustSerialData:
    Значение этого системного свойства — строковое представление булевого значения, которое управляет десериализацией объектов Java из атрибута javaSerializedData LDAP, реконструкцией ссылок RMI из атрибута javaRemoteLocation LDAP и реконструкцией бинарных адресов ссылок из атрибута javaReferenceAddress LDAP. Для разрешения десериализации или реконструкции объектов Java из атрибутов javaSerializedData, javaRemoteLocation или javaReferenceAddress значение системного свойства можно установить на true (регистр не учитывается).
    Если свойство не указано, десериализация объектов Java из атрибутов javaSerializedData, javaRemoteLocation или javaReferenceAddress не разрешена.
  • jdk.jndi.object.factoriesFilter:
    Значение этого системного свойства определяет фильтр, используемый реализацией JNDI runtime для управления набором классов фабрик объектов, которым будет разрешено создавать объекты из ссылок на объекты, возвращаемые системами именования/каталога. Класс фабрики, указанный в ссылке экземпляра, будет сопоставлен с этим фильтром. Свойство фильтра поддерживает синтаксис фильтра на основе шаблонов с тем же форматом, что и 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, как определено в Lightweight Directory Access Protocol (v3): Extension for Transport Layer Security Идентификатор объекта для 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://download.java.net/java/early_access/jdk24/docs/api/java.naming/module-summary.html

Spec-Zone.ru

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