javax.naming.spi
인터페이스 DirObjectFactory

모든 슈퍼 인터페이스:

ObjectFactory

public interface DirObjectFactory

extends ObjectFactory

이 인터페이스는 그 오브젝트에 관한 오브젝트와 속성이 지정된 오브젝트를 생성하는 팩토리를 나타냅니다.

JNDI 체제에서는 오브젝트 팩토리를 사용해 오브젝트 구현을 동적으로 로드할 수 있습니다. 자세한 것은 ObjectFactory 를 참조해 주세요.

DirObjectFactory 는 ObjectFactory 를 확장해,getObjectInstance() 메소드에 Attributes 인스턴스를 지정할 수 있게 합니다. DirObjectFactory 구현은 DirContext 서비스 프로바이더가 사용하는 것입니다. 서비스 프로바이더는 디렉토리로부터 오브젝트를 읽어들일 뿐만 아니라, 오브젝트 팩토리가 오브젝트를 처리할 필요가 있을지 어떨지를 그 팩토리가 조사하는데 도움이 되는 속성을 미리 가져 둘 수가 있습니다. 예를 들어 LDAP 스타일의 서비스 프로바이더는 오브젝트의 「objectclass」를 읽어들여 둘 수가 있습니다. CORBA 오브젝트 팩토리는 「objectclass=corbaObject」라고 하는 LDAP 엔트리만을 대상으로 하고 있다고 합니다. LDAP 서비스 프로바이더에 의해 지정된 속성을 사용해, CORBA 오브젝트 팩토리는 관계가 없는 오브젝트를 재빠르게 배제할 수 있어 CORBA 이외의 오브젝트 팩토리는 CORBA 관련의 LDAP 엔트리를 재빠르게 배제할 수 있습니다.

도입된 버젼:

1.3

관련 항목:

NamingManager.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable) , DirectoryManager.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable, javax.naming.directory.Attributes) , ObjectFactory

메소드의 개요

Object

getObjectInstance (Object obj, Name name, Context nameCtx, Hashtable environment, Attributes attrs) 위치 정보 또는 참조 정보, 및 지정된 속성을 사용해, 오브젝트를 생성합니다.

인터페이스 javax.naming.spi. ObjectFactory 에서 상속받은 메소드

getObjectInstance

메소드의 상세

getObjectInstance

public Object  getObjectInstance(Object  obj,
                                Name  name,
                                Context  nameCtx,
                                Hashtable  environment,
                                Attributes  attrs)
                         throws Exception 

위치 정보 또는 참조 정보, 및 지정된 속성을 사용해, 오브젝트를 생성합니다.

이 오브젝트의 특수 요건은 environment 를 사용해 지정됩니다. 이러한 환경 프로퍼티의 일례로서는 유저 식별 정보가 있습니다.

DirectoryManager.getObjectInstance() 는 오브젝트 팩토리에 연속적으로 로드합니다. DirObjectFactory 를 검출하면(자),DirectoryManager.getObjectInstance() 는 DirObjectFactory.getObjectInstance() 를 호출합니다. 그렇지 않은 경우는 ObjectFactory.getObjectInstance() 를 호출합니다. 팩토리가 null 이외의 답을 생성할 때까지 DirectoryManager.getObjectInstance() 는 이것을 계속합니다.

오브젝트 팩토리가 예외를 슬로우 하면(자), 그 예외는 DirectoryManager.getObjectInstance() 의 호출 측에 건네받습니다. null 이외의 답을 생성할 가능성이 있는 다른 팩토리의 검색은 정지합니다. 오브젝트 팩토리는 그것이 목적의 유일한 팩토리이며 다른 오브젝트 팩토리를 검색할 필요가 없는 것이 확실한 경우에 한정해, 예외를 슬로우 하도록(듯이) 합니다. 이 팩토리가 지정된 인수로 오브젝트를 생성할 수 없는 경우는 null 를 돌려주도록(듯이) 합니다.

DirObjectFactory 는 ObjectFactory 를 확장하므로,ObjectFactory 는 결과적으로 2 개의 getObjectInstance() 메소드를 가집니다. 이 2 개의 메소드는 속성 인수가 다릅니다. DirObjectFactory 를 구현하는 팩토리를 지정하면(자),DirectoryManager.getObjectInstance() 는 속성 인수를 받아들이는 메소드만을 사용해,NamingManager.getObjectInstance() 는 속성 인수를 받아들이지 않는 메소드만을 사용합니다.

DirObjectFactory 에 똑같이 적용되는 URL 문맥 팩토리 및 오브젝트 팩토리의 다른 프로퍼티의 설명에 대해서는 ObjectFactory 를 참조해 주세요.

name,attrs, 및 environment 의 각 파라미터는 호출측이 소유합니다. 구현은 이러한 오브젝트를 변경하지 않고 그 오브젝트에 대한 참조도 보관 유지합니다만, 복제 또는 카피에 대한 참조를 보관 유지하는 일이 있습니다.

파라미터:

obj - 오브젝트의 생성에 사용할 수 있는 위치 정보 또는 참조 정보를 저장하는 null 의 가능성이 있는 오브젝트

name - nameCtx 에 관련하는 이 오브젝트의 이름, 또는 이름이 지정되지 않는 경우는 null

nameCtx - name 파라미터의 지정에 관련하는 문맥, 또는 name 가 디폴트의 초기 문맥에 관련하는 경우는 null

environment - null 의 가능성이 있는 오브젝트의 생성에 사용되는 환경

attrs - null 의 가능성이 있는 obj 의 속성을 얼마인가 포함한 속성. attrs 는 반드시 obj 의 속성을 모두 가질 필요는 없다. 오브젝트 팩토리가 한층 더 속성을 필요로 하는 경우, 팩토리는 obj 인가, 혹은 name 와 nameCtx 를 사용해 속성을 취득할 필요가 있다. 팩토리는 attrs 를 변경할 수 없다

반환값:

생성된 오브젝트. 오브젝트를 생성할 수 없는 경우는 null

예외:

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

관련 항목:

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