Класс 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. Последующие фабрики объектов будут загружаться и создаваться с помощью установленного построителя.

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

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

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

1. Если refInfo — это Reference или Referenceable, содержащий имя класса фабрики, используйте указанную фабрику для создания объекта. Верните refInfo, если фабрику создать не удалось. Загрузка класса фабрики из местоположения, указанного в ссылке, может поддерживаться пользовательской реализацией ObjectFactoryBuilder. Если указан адрес расположения класса фабрики, он игнорируется. Если требуется другая политика, можно использовать пользовательский ObjectFactoryBuilder. Если при создании фабрики возникает исключение, оно передаётся вызывающему коду.
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 задаётся относительно исходного контекста по умолчанию. Если имя не указано, параметр name должен иметь значение null.

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

Создаёт контекст для указанного идентификатора схемы URL.

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

Имя класса фабрики, создающей полученный контекст, должно соответствовать соглашению об именовании идентификатор-схемыURLContextFactory (например, "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(), показанный выше, для фабрики контекстов LDAP URL вернёт контекст, способный разрешать 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

Устанавливает builder в качестве построителя InitialContextFactory.

public static boolean hasInitialContextFactoryBuilder()

Определяет, задан ли построитель фабрики исходного контекста.

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()) и сохранить вместо него.