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

Билдер может быть установлен только в том случае, если выполняющейся нити разрешено (методом security manager's 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) должна быть общедоступной и должна иметь общедоступный конструктор без аргументов.

Параметры 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() на фабрике контекста URL LDAP вернёт контекст, способный разрешать URL-адреса LDAP (например, "ldap://ldap.wiz.com/o=wiz,c=us", "ldap://ldap.umich.edu/o=umich,c=us", ...).

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

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

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

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

public static void setInitialContextFactoryBuilder(InitialContextFactoryBuilder builder)
                                            throws NamingException

Устанавливает билдер 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) должна быть публичной и иметь публичный конструктор, принимающий на вход ноль аргументов.

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

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