javax.naming.spi
인터페이스 ObjectFactory

알려진 서브 인터페이스 목록 :

DirObjectFactory

public interface ObjectFactory

이 인터페이스는 객체를 생성하는 팩토리를 나타냅니다.

JNDI 체제에서는 「객체 팩토리」를 사용해 객체 구현을 동적으로 로드하는 것이 가능합니다. 예를 들어 이름 공간에 바인드 된 프린터를 검색하는 경우, 인쇄 서비스가 프린터명을 Reference에 바인드 하면, 프린터 Reference를 사용해 프린터 객체를 생성해, 룩 업의 호출측이 룩 업 후 직접 프린터 객체로 조작할 수 있습니다.

ObjectFactory는 특정의 타입의 객체의 생성을 실시합니다. 상기의 예에서는 Printer 객체의 생성에 PrinterObjectFactory를 사용할 수 있습니다.

객체 팩토리는 ObjectFactory 인터페이스를 구현할 필요가 있습니다. 또 팩토리 클래스는 public 인 것이 필요해, 한편 파라미터를 잡히지 않는 public 생성자를 가질 필요가 있습니다.

객체 팩토리의 getObjectInstance() 메서드는 다른 파라미터를 사용해 여러 차례 호출되는 일이 있습니다. 구현은 thread 세이프입니다.

이 클래스의 문서의 URL 기재는 RFC 1738 및 그 관련 RFC 로 정의되고 있는 URL 캐릭터 라인을 적용하고 있습니다. 문서의 URL는 RFC 1738 등으로 진술되고 있는 구문에 따르는 캐릭터 라인이며, 반드시 java.net.URL 클래스 또는 Web 브라우저에 해당하는 지원가 있는 것은 아닙니다.

도입된 버전 :

1.3

관련 항목:

NamingManager.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable), NamingManager.getURLContext(java.lang.String, java.util.Hashtable), ObjectFactoryBuilder, StateFactory

메서드 개요

Object

getObjectInstance (Object obj, Name name, Context nameCtx, Hashtable <?,?> environment) 지정된 위치 정보 또는 참조 정보를 사용해, 객체를 생성합니다.

메서드의 상세

getObjectInstance

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

지정된 위치 정보 또는 참조 정보를 사용해, 객체를 생성합니다.

이 객체의 특수 요건은, environment를 사용해 지정됩니다. 이러한 환경 프로퍼티의 일례로서는 사용자 식별 정보가 있습니다.

NamingManager.getObjectInstance()는 객체 팩토리에 연속적으로 로드해, 1개이 null 이외의 대답을 생성할 때까지 객체 팩토리상에서 이 메서드를 계속 호출합니다. 객체 팩토리가 예외를 Throw 하면, 그 예외는 NamingManager.getObjectInstance() 호출 측에 인도해져 null 이외의 대답을 생성할 가능성이 있는 다른 팩토리의 검색은 행해지지 않습니다. 객체 팩토리는 그것이 목적의 유일한 팩토리이며, 다른 객체 팩토리를 검색할 필요가 없는 것이 확실한 경우에 한정해, 예외를 Throw 하도록 합니다. 이 팩토리가 지정된 인수로 객체를 생성할 수 없는 경우는 null을 리턴합니다.

「URL 컨텍스트 팩토리」는 특수한 ObjectFactory 로 URL 또는 URL가 위치를 지정하는 객체를 해결하는 컨텍스트를 생성합니다. URL 컨텍스트 팩토리의 getObjectInstance() 메서드는 아래의 규칙에 따릅니다.

1. obj가 null인 경우, 이 팩토리에 관련한 schema의 URL를 해결하는 컨텍스트를 생성합니다. 그 컨텍스트은 특정의 URL와는 연결시킬 수 없습니다. 이 컨텍스트은 이 팩토리의 schema ID를 사용해 임의의 URL를 처리할 수 있습니다. 예를 들어 LDAP URL 컨텍스트 팩토리로 null 로 설정된 obj를 가지는 getObjectInstance()를 호출하면, ldap://ldap.wiz.com/o=wiz, c=us, ldap://ldap.umich.edu/o=umich, c=us 등의 LDAP URL를 해결할 수 있는 컨텍스트이 리턴됩니다 .
2. obj가 URL 캐릭터 라인인 경우, URL에 의해 식별된 객체 (일반적으로 컨텍스트)를 생성합니다. 예를 들어 그것이 LDAP URL 컨텍스트 팩토리이다고 합니다. obj가 ldap://ldap.wiz.com/o=wiz, c=us인 경우, getObjectInstance()는 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를 사용하는 경우는 병행 액세스에 대비해 그 사용을 동기화하도록 합니다. 컨텍스트 구현은 thread 세이프인 것을 보증되어 있지 않기 때문입니다.

파라미터:

obj - 객체의 생성에 사용할 수 있는 위치 정보 또는 참조 정보를 포함하는 null 가능성이 있는 객체

name - nameCtx에 관련된 이 객체의 이름, 또는 이름이 지정되지 않는 경우는 null

nameCtx - name 파라미터의 지정에 관련된 컨텍스트, 또는 name가 디폴트의 초기 컨텍스트에 관련된 경우는 null

environment - null 가능성이 있는 객체의 생성에 사용되는 환경

반환값:

생성된 객체. 객체를 생성할 수 없는 경우는 null

예외:

Exception - 객체의 생성중에 이 객체 팩토리가 예외를 검출해, 다른 객체 팩토리가 시행되지 않는 경우

관련 항목:

NamingManager.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable), NamingManager.getURLContext(java.lang.String, java.util.Hashtable)