Интерфейс ObjectFactory

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

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

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

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

Фабрика контекста URL - это специальная ObjectFactory, которая создаёт контексты для разрешения 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() вернёт контекст, именованный по отличительному имени "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 относится к стандартному начальному контексту. Если имя не указывается, параметр name должен быть null. Если фабрика использует nameCtx, она должна синхронизировать его использование против одновременного доступа, так как реализации контекста не гарантируют потокобезопасность.