Класс NamingManager

public static final String CPE

Константа, хранящая имя свойства среды, в которое getContinuationContext() сохраняет значение своего параметра CannotProceedException. Это свойство наследуется контекстом продолжения и может использоваться поставщиком услуг этого контекста для проверки полей исключения.

Значение этой константы — "java.naming.spi.CannotProceedException".

public static void setObjectFactoryBuilder(ObjectFactoryBuilder builder) throws NamingException

ObjectFactoryBuilder определяет политику, используемую при попытке загрузить фабрики объектов. См. getObjectInstance() и класс ObjectFactory для описания политики по умолчанию. setObjectFactoryBuilder() переопределяет эту политику по умолчанию, установив ObjectFactoryBuilder. Последующие фабрики объектов будут загружены и созданы с использованием установленного билдера.

Билдер может быть установлен только в том случае, если выполняющейся нити разрешено (методом checkSetFactory() менеджера безопасности) сделать это. После установки билдер не может быть заменен.

public static Object getObjectInstance(Object refInfo, Name name, Context nameCtx, Hashtable<?,?> environment) throws Exception

Создает экземпляр объекта для указанного объекта и среды.

Если был установлен билдер фабрики объектов, он используется для создания фабрики, создающей объект. В противном случае используются следующие правила для создания объекта:

1. Если refInfo является Reference или Referenceable, содержащим имя класса фабрики, используйте указанную фабрику для создания объекта. Верните refInfo если фабрика не может быть создана. В JDK 1.1, если класс фабрики должен быть загружен из местоположения, указанного в ссылке, должен быть установлен SecurityManager, иначе создание фабрики завершится ошибкой. Если при создании фабрики возникает исключение, оно передается вызывающему методу.
2. Если refInfo является Reference или Referenceable без имени класса фабрики, и адрес(ы) являются StringRefAddr с типом адреса "URL", попробуйте фабрику контекста URL, соответствующую идентификатору схемы каждого URL, для создания объекта (см. getURLContext()). Если это не сработает, переходите к следующему шагу.
3. Используйте фабрики объектов, указанные в свойстве Context.OBJECT_FACTORIES среды и файла ресурсов поставщика, связанного с nameCtx, в таком порядке. Значение этого свойства — список имён классов фабрик, разделённых двоеточиями, которые проверяются в порядке следования, и первая успешно создавшая объект фабрика используется. Если ни одна из фабрик не может быть загружена, верните refInfo. Если при создании объекта возникает исключение, оно передаётся вызывающему методу.

Поставщики услуг, реализующие интерфейс DirContext, должны использовать DirectoryManager.getObjectInstance(), а не этот метод. Поставщики услуг, реализующие только интерфейс Context должны использовать этот метод.

Обратите внимание, что фабрика объектов (объект, реализующий интерфейс ObjectFactory) должна быть публичной и иметь публичный конструктор без аргументов. В случаях, когда фабрика находится в именованном модуле, она должна находиться в пакете, экспортированном этим модулем в модуль java.naming.

Параметры name и nameCtx могут необязательно использоваться для указания имени создаваемого объекта. name — имя объекта, относительно контекста nameCtx. Эта информация может быть полезна фабрике объектов или реализации объекта. Если существует несколько возможных контекстов, из которых объект может быть назван (как часто бывает), вызывающий метод должен выбрать один. Хорошее правило — выбрать «самый глубокий» доступный контекст. Если nameCtx равно null, name относится к контексту по умолчанию.

public static Context getURLContext(String scheme, Hashtable<?,?> environment) throws NamingException

Создаёт контекст для указанной схемы URL.

Полученный контекст предназначен для обработки URL-адресов схемы scheme. Полученный контекст не привязан к конкретному URL. Он может обрабатывать произвольные URL-адреса с указанной схемой.

Имя класса фабрики, создающей полученный контекст, имеет имя в формате scheme-idURLContextFactory (например, "ftpURLContextFactory" для схемы "ftp"), в пакете, указанном следующим образом. Свойство среды Context.URL_PKG_PREFIXES (которое может содержать значения, взятые из системных свойств или файлов ресурсов приложения) содержит список префиксов пакетов, разделённых двоеточиями. Каждый префикс пакета в свойстве используется в указанном порядке для загрузки класса фабрики. Префикс пакета по умолчанию — "com.sun.jndi.url" (если ни один из указанных пакетов не работает, используется этот по умолчанию). Полное имя пакета строится путём конкатенации префикса пакета с идентификатором схемы.

Например, если идентификатор схемы — "ldap", а свойство Context.URL_PKG_PREFIXES содержит "com.widget:com.wiz.jndi", менеджер именования попытается загрузить следующие классы, пока не один из них не будет успешно создан:

• com.widget.ldap.ldapURLContextFactory
• com.wiz.jndi.ldap.ldapURLContextFactory
• com.sun.jndi.url.ldap.ldapURLContextFactory

Если ни один из префиксов пакетов не сработает, возвращается null.

Если фабрика инициализирована, она вызывается с последующими параметрами для получения конечного контекста.

factory.getObjectInstance(null, environment);

Например, вызов getObjectInstance() как показано выше на фабрике контекста URL LDAP вернёт контекст, который может обрабатывать URL-адреса LDAP (например, "ldap://ldap.wiz.com/o=wiz,c=us", "ldap://ldap.umich.edu/o=umich,c=us", ...).

Обратите внимание, что фабрика объектов (объект, реализующий интерфейс ObjectFactory) должна быть публичной и иметь публичный конструктор без аргументов. В случаях, когда фабрика находится в именованном модуле, она должна находиться в пакете, экспортированном этим модулем в модуль java.naming.

public static Context getInitialContext(Hashtable<?,?> env) throws NamingException

Создаёт начальный контекст, используя указанные свойства среды.

Это выполняется следующим образом:

• Если установлен InitialContextFactoryBuilder, он используется для создания фабрики для создания начального контекста
• В противном случае используется класс, указанный в Context.INITIAL_CONTEXT_FACTORY свойстве среды
  • Сначала механизм ServiceLoader пытается найти поставщика InitialContextFactory с помощью контекстного класса загрузчика текущей нити
  • В случае неудачи, данная реализация пытается найти подходящий InitialContextFactory с помощью встроенного механизма
    (Обратите внимание, что фабрика начального контекста (объект, реализующий интерфейс InitialContextFactory) должна быть публичной и должна иметь публичный конструктор, не принимающий аргументов. В тех случаях, когда фабрика находится в именованном модуле, она должна находиться в пакете, экспортированном данным модулем в модуль java.naming.)

public static void setInitialContextFactoryBuilder(InitialContextFactoryBuilder builder) throws NamingException

Устанавливает InitialContextFactory builder в builder.

Builder может быть установлен только в том случае, если выполняющаяся нить разрешена менеджером безопасности для этого. После установки builder не может быть заменён.

public static boolean hasInitialContextFactoryBuilder()

Определяет, установлен ли initial context factory builder.

public static Context getContinuationContext(CannotProceedException cpe) throws NamingException

Создаёт контекст для продолжения операции контекста.

При выполнении операции с именем, охватывающим несколько пространств имён, контекст одной системы именования может передать операцию следующей системе именования. Реализация контекста делает это, сначала создавая CannotProceedException, содержащий информацию о том, насколько далеко она продвинулась. Затем она получает контекст продолжения из JNDI, вызвав getContinuationContext. Затем реализация контекста должна возобновить операцию контекста, вызвав ту же операцию в контексте продолжения, используя оставшуюся часть имени, которая ещё не была разрешена.

Перед использованием параметра cpe, этот метод обновляет среду, связанную с этим объектом, установив значение свойства CPE в cpe. Это свойство будет унаследовано контекстом продолжения и может быть использовано поставщиком услуг этого контекста для проверки полей этой ошибки.

public static Object getStateToBind(Object obj, Name name, Context nameCtx, Hashtable<?,?> environment) throws NamingException

Получает состояние объекта для привязки.

Поставщики услуг, реализующие интерфейс DirContext, должны использовать DirectoryManager.getStateToBind(), а не этот метод. Поставщики услуг, реализующие только интерфейс Context, должны использовать этот метод.

Этот метод использует указанные фабрики состояний в свойстве Context.STATE_FACTORIES из свойств среды и из файла ресурсов поставщика, связанного с nameCtx, в этом порядке. Значение этого свойства — список фабрик классов, разделённых двоеточием, которые перебираются в порядке очереди, и первая из них, которая успешно вернёт состояние объекта, используется. Если состояние объекта не может быть получено таким образом, возвращается сам объект. Если при получении состояния возникает ошибка, ошибка передаётся вызывающему методу.

Обратите внимание, что фабрика состояния (объект, реализующий интерфейс StateFactory) должна быть публичной и должна иметь публичный конструктор, не принимающий аргументов. В тех случаях, когда фабрика находится в именованном модуле, она должна находиться в пакете, который экспортируется этим модулем в модуль java.naming.

Параметры name и nameCtx могут быть необязательно использованы для указания имени создаваемого объекта. См. описание "Параметры имени и контекста" в ObjectFactory.getObjectInstance() для получения подробной информации.

Этот метод может вернуть объект Referenceable. Поставщик услуг, получающий этот объект, может выбрать хранение его напрямую или извлечение его ссылки (используя Referenceable.getReference()) и хранение этого вместо этого.