Интерфейс ObjectFactory

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

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

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

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

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