Интерфейс ObjectFactory

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

Создает объект, используя указанную информацию о расположении или ссылке.

Специальные требования к этому объекту предоставляются с помощью environment. Примером такой свойства среды является информация об идентификации пользователя.

NamingManager.getObjectInstance() последовательно загружает фабрики объектов и вызывает этот метод у них, пока один из них не вернет не null ответ. Когда исключение выбрасывается фабрикой объектов, исключение передается вызывающему методу NamingManager.getObjectInstance() (и не производится поиск других фабрик, которые могут вернуть не null ответ). Фабрика объектов должна выбрасывать исключение только если она уверена, что является единственной целевой фабрикой и что другие фабрики объектов не должны быть проверены. Если эта фабрика не может создать объект, используя предоставленные аргументы, она должна вернуть null.

Фабрика контекста URL — это специальная фабрика объектов, которая создает контексты для разрешения URL-адресов или объектов, чьи местоположения заданы URL-адресами. Метод getObjectInstance() фабрики контекста URL будет подчиняться следующим правилам.

1. Если obj равно null, создается контекст для разрешения URL-адресов схемы, связанной с этой фабрикой. Результирующий контекст не привязан к конкретному URL-адресу: он может обрабатывать произвольные URL-адреса с идентификатором схемы этой фабрики. Например, вызов getObjectInstance() с obj, установленным в null для фабрики контекста LDAP URL, вернет контекст, который может разрешать URL-адреса LDAP, такие как "ldap://ldap.wiz.com/o=wiz,c=us" и "ldap://ldap.umich.edu/o=umich,c=us".
2. Если obj является строкой URL, создается объект (обычно контекст), идентифицированный URL-адресом. Например, предположим, что это фабрика контекста LDAP URL. Если obj равно "ldap://ldap.wiz.com/o=wiz,c=us", getObjectInstance() вернет контекст, именованный по имени DN "o=wiz, c=us" на LDAP-сервере ldap.wiz.com. Этот контекст затем может использоваться для разрешения LDAP имен (таких как "cn=George") относительно этого контекста.
3. Если obj представляет собой массив строк URL, предполагается, что URL-адреса эквивалентны в терминах контекста, к которому они относятся. Проверка того, являются ли URL-адреса эквивалентными или нуждаются в эквивалентности, зависит от реализации фабрики контекста. Порядок URL-адресов в массиве несущественен. Возвращаемый объектом getObjectInstance() объект аналогичен случаю с одним URL-адресом. Это объект, названный URL-адресами.
4. Если obj является каким-либо другим типом, поведение getObjectInstance() определяется реализацией фабрики контекста.

Параметры name и environment принадлежат вызывающему методу. Реализация не будет модифицировать эти объекты или сохранять ссылки на них, хотя она может сохранять ссылки на клоны или копии.

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