Интерфейс 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, на фабрике контекста LDAP URL вернёт контекст, который может разрешить LDAP URL-адреса, такие как "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, она должна синхронизировать своё использование с учётом одновременного доступа, так как реализации контекста не гарантируют потокобезопасность.