Класс 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 можно использовать для указания имени создаваемого объекта. Подробности см. в описании раздела «Параметры Name и Context» в ObjectFactory.getObjectInstance().

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