javax.naming.spi
인터페이스 DirStateFactory

모든 슈퍼 인터페이스:

StateFactory

public interface DirStateFactory
extends StateFactory 

이 인터페이스는 객체와 해당 속성과의 바인딩 상태를 얻는 팩토리를 나타냅니다.

JNDI 체제에서는 객체 팩토리를 사용해 객체 구현을 동적으로 로드할 수 있습니다. DirStateFactory는 StateFactory를 확장해, getStateToBind() 메서드가 Attributes 인스턴스를 지정해 돌려줄 수가 있도록 합니다. DirStateFactory 구현은 DirContext 서비스 프로바이더가 사용하는 것입니다. 호출측이 DirContext.bind()를 사용해 객체를 바인드 할 때, 속성세트도 그 객체에 바인드 되도록 지정할 수 있습니다. 바인드 되는 객체와 속성은 팩토리의 getStateToBind() 메서드에게 건네집니다. 팩토리는 객체와 속성을 처리하는 경우는 바인드 되는 객체와 속성의 해당 페어를 리턴합니다. 객체를 처리하지 않는 경우, 팩토리는 null을 돌려줄 필요가 있습니다.

예를 들어 호출측이 프린터 객체를 프린터 관련의 속성과 바인드 하는 일이 있습니다.

 ctx.rebind("inky", printer, printerAttrs);

ctx LDAP 서비스 프로바이더는 (DirectoryManager.getStateToBind()를 사용해 간접적으로) DirStateFactory를 사용해, DirStateFactory에 printer 및 printerAttrs를 지정합니다. LDAP 디렉토리의 팩토리는 printer를 속성세트로 바꾸어 그것을 printerAttrs와 머지 합니다. 계속되어 서비스 프로바이더가 그 속성을 사용해 LDAP 엔트리를 생성해, 디렉토리를 갱신합니다.

DirStateFactory는 StateFactory를 확장하므로 2개의 getStateToBind() 메서드를 가집니다. 이 2개의 메서드는 속성 인수가 다릅니다. DirectoryManager.getStateToBind()는 속성 인수를 받아들이는 형식만을 사용해, NamingManager.getStateToBind()는 속성 인수를 받아들이지 않는 형식만을 사용합니다.

DirStateFactory getStateToBind() 메서드의 어느 쪽인가의 형식이, 다른 파라미터를 사용해 여러 차례 호출되는 일이 있습니다. 구현은 thread에 대해서 안전합니다.

도입된 버전 :

1.3

관련 항목:

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

중첩(Nested) 클래스 개요

static class

DirStateFactory.Result DirStateFactory.getStateToBind()의 결과를 돌려주는 객체와 속성의 페어입니다.

메서드 개요

DirStateFactory.Result

getStateToBind (Object obj, Name name, Context nameCtx, Hashtable <?,?> environment, Attributes inAttrs) 변환 대상의 객체 및 속성을 바인딩 하기 위해서 객체 상태를 취득합니다.

인터페이스 javax.naming.spi. StateFactory 로부터 상속된 메서드

getStateToBind

메서드의 상세

getStateToBind

DirStateFactory.Result  getStateToBind(Object  obj,
                                      Name  name,
                                      Context  nameCtx,
                                      Hashtable <?,?> environment,
                                      Attributes  inAttrs)
                                      throws NamingException 

변환 대상의 객체 및 속성을 바인딩 하기 위해서 객체 상태를 취득합니다.

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

팩토리가 예외를 Throw 하면, 그 예외는 DirectoryManager.getStateToBind() 호출 측에 건네받습니다. null 이외의 답을 생성할 가능성이 있는 다른 팩토리의 검색은 정지합니다. 팩토리는 그것이 목적의 유일한 팩토리이며 다른 팩토리를 검색할 필요가 없는 것이 확실한 경우에 한정해, 예외를 Throw 하도록 합니다. 이 팩토리가 지정된 인수로 객체를 생성할 수 없는 경우는 null을 돌려주도록 합니다. name 파라미터 및 nameCtx 파라미터를 임의에 사용해, 생성중의 객체의 이름을 지정할 수 있습니다. 자세한 내용은 ObjectFactory.getObjectInstance() 「이름 파라미터와 컨텍스트 파라미터」의 설명을 참조하십시오. 팩토리가 nameCtx를 사용하는 경우는 그 사용을 병행 액세스와 동기화하도록 합니다. 컨텍스트 구현은 thread에 대해서 안전하다라고 하는 것이 보증되어 있지 않기 때문입니다.

name, inAttrs 및 environment 각 파라미터는 호출측이 소유합니다. 구현은 이러한 객체를 변경하지 않고, 그것들에의 참조도 보관 유지합니다만, 복제 또는 카피에의 참조를 보관 유지하는 일이 있습니다. 이 메서드가 돌려주는 객체는 호출해 옆이 소유합니다. 구현은 계속되어 이것을 변경하지 않습니다. 구현에는 호출측이 소유하는 것과 같은 새로운 Attributes 객체인가 혹은 원의 inAttrs 파라미터에의 참조가 포함됩니다.

파라미터:

obj - 상태를 얻는, null 가능성이 있는 객체

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

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

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

inAttrs - 객체에 바인드 되는 null 가능성이 있는 속성. 팩토리는 inAttrs를 변경할 수 없다

반환값:

객체의 바인딩 상태 및 바인드 되는 해당의 속성을 포함한 Result. 객체가 이 팩토리를 사용하지 않는 경우는 null

예외:

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

관련 항목:

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