Интерфейс ObjectFactory

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

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

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

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

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

1. Если obj равно null, создается контекст для разрешения URL схемы, связанной с этой фабрикой. Полученный контекст не привязан к конкретному URL: он может обрабатывать произвольные URL с идентификатором схемы этой фабрики. Например, вызов getObjectInstance() со значением obj, равным null, у фабрики контекстов URL LDAP вернет контекст, который может разрешать URL LDAP, такие как "ldap://ldap.wiz.com/o=wiz,c=us" и "ldap://ldap.umich.edu/o=umich,c=us".
2. Если obj — это строка URL, создается объект (обычно контекст), указанный в URL. Например, предположим, что это фабрика контекстов URL LDAP. Если 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 и Context. Параметры name и nameCtx можно использовать для указания имени создаваемого объекта. name — это имя объекта относительно контекста nameCtx. Если существует несколько контекстов, относительно которых можно указать имя объекта (что часто бывает), выбрать один из них должен вызывающий код. Как правило, следует выбирать наиболее «глубокий» из доступных контекстов. Если nameCtx равно null, name является относительным к исходному контексту по умолчанию. Если имя не указано, параметр name должен иметь значение null. Если фабрика использует nameCtx, она должна синхронизировать его использование для защиты от конкурентного доступа, поскольку потокобезопасность реализаций контекстов не гарантируется.