javax.naming.spi
인터페이스 StateFactory

기존의 서브 인터페이스의 일람:

DirStateFactory

public interface StateFactory

이 인터페이스는 오브젝트의 바인딩 상태를 취득하는 팩토리를 나타냅니다.

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

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

역의 프로세스에서는 오브젝트가 이름 공간에 바인드 되고 있는 경우, JNDI 는 state factories 를 제공합니다. 여기에서도 프린터를 예를 들어, 프린터 오브젝트가 갱신되어 재차 바인드 되는 경우를 생각합니다.

 ctx.rebind("inky", printer);
 

ctx 의 서비스 프로바이더는 상태 팩토리를 사용해 printer 의 이름 공간에의 바인딩 상태를 취득합니다. Printer 타입 오브젝트 상태 팩토리는 네이밍 시스템에서의 기억을 위해서(때문에), 보다 컴팩트한 오브젝트를 돌려주는 일이 있습니다.

상태 팩토리는 StateFactory 인터페이스를 구현할 필요가 있습니다. 또 팩토리 클래스는 public 인 것이 필요해, 한편 파라미터를 잡히지 않는 public constructor를 가질 필요가 있습니다.

상태 팩토리의 getStateToBind() 메소드는 다른 파라미터를 사용해 여러 차례 불려 가는 일이 있습니다. 구현은 thread 세이프입니다.

StateFactory 는 Context 인터페이스만을 구현하고 있는 서비스 프로바이더 대상입니다. DirStateFactory 는 DirContext 인터페이스를 구현하고 있는 서비스 프로바이더 대상입니다.

도입된 버젼:

1.3

관련 항목:

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

메소드의 개요

Object

getStateToBind (Object obj, Name name, Context nameCtx, Hashtable environment) 오브젝트의 바인딩 상태를 취득합니다.

메소드의 상세

getStateToBind

public Object  getStateToBind(Object  obj,
                             Name  name,
                             Context  nameCtx,
                             Hashtable  environment)
                      throws NamingException 

오브젝트의 바인딩 상태를 취득합니다.

NamingManager.getStateToBind() 는 상태 팩토리에 연속적으로 로드해, 1 kr이 null 이외의 대답을 생성할 때까지 상태 팩토리상에서 이 메소드를 계속 호출합니다. DirectoryManager.getStateToBind() 는 상태 팩토리에 연속적으로 로드합니다. 팩토리가 DirStateFactory 를 구현하고 있으면,DirectoryManager 가 DirStateFactory.getStateToBind() 를 호출합니다. 그렇지 않은 경우는 StateFactory.getStateToBind() 를 호출합니다.

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

name 파라미터 및 nameCtx 파라미터를 임의에 사용해, 생성중의 오브젝트의 이름을 지정할 수 있습니다. 자세한 것은 ObjectFactory.getObjectInstance() 의 「이름 파라미터와 문맥 파라미터」의 설명을 참조해 주세요. 팩토리가 nameCtx 를 사용하는 경우는 그 사용을 병행 액세스와 동기화하도록(듯이) 합니다. 문맥 구현은 thread 세이프인 것이 프로텍션되어 있지 않기 때문입니다.

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

파라미터:

obj - 상태를 취득하는 null 이외의 오브젝트

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

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

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

반환값:

오브젝트의 바인딩 상태. 팩토리가 아무것도 변경을 돌려주지 않는 경우는 null

예외:

NamingException - 오브젝트 상태를 취득하려고 하고 있을 때 이 팩토리가 예외를 검출해, 다른 팩토리가 시행되지 않는 경우

관련 항목:

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