javax.naming.spi
클래스 DirectoryManager

java.lang.Object 
  javax.naming.spi.NamingManager 
      javax.naming.spi.DirectoryManager

public class DirectoryManager
extends NamingManager 

이 클래스에는,DirContext 구현을 지원하는 메소드가 포함됩니다.

이 클래스는 NamingManager 를 확장한 것입니다. 서비스 프로바이더가 객체 팩토리 및 상태 팩토리에 액세스 할 때, 및 연합을 지원하는 계속 문맥을 취득할 경우에 사용하는 메소드를 포함합니다.

DirectoryManager 는, 복수의 thread에 의한 병행 액세스에서도 시큐리티 우에야스전입니다.

별도 주석이 있는 경우를 제외해,Name,Attributes, 또는 메소드에게 건네지는 환경 파라미터는, 호출측이 소유합니다. 구현은 객체를 변경하지 않고, 그 객체에 대한 참조도 보관 유지합니다만, 그 복제 또는 카피에 대한 참조를 보관 유지하는 일이 있습니다.

도입된 버젼:

1.3

관련 항목:

DirObjectFactory , DirStateFactory

필드의 개요

클래스 javax.naming.spi. NamingManager 로부터 상속된 필드

CPE

메소드의 개요

static DirContext	getContinuationDirContext (CannotProceedException cpe) DirContext 조작을 계속하는 문맥을 생성합니다.
static Object	getObjectInstance (Object refInfo, Name name, Context nameCtx, Hashtable <?,?> environment, Attributes attrs) 지정된 객체, 속성, 및 환경에 객체의 인스턴스를 생성합니다.
static DirStateFactory.Result	getStateToBind (Object obj, Name name, Context nameCtx, Hashtable <?,?> environment, Attributes attrs) 원의 객체 및 그 속성이 지정되었을 때에, 객체의 바인딩 상태를 가져옵니다.

클래스 javax.naming.spi. NamingManager 로부터 상속된 메소드

getContinuationContext , getInitialContext , getObjectInstance , getStateToBind , getURLContext , hasInitialContextFactoryBuilder , setInitialContextFactoryBuilder , setObjectFactoryBuilder

클래스 java.lang. Object 로부터 상속된 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

메소드의 상세

getContinuationDirContext

public static DirContext  getContinuationDirContext(CannotProceedException  cpe)
                                            throws NamingException 

DirContext 조작을 계속하는 문맥을 생성합니다. NamingManager.getContinuationContext() 와 같이 동작합니다. 반환되는 계속 문맥은 DirContext 뿐입니다.

파라미터:

cpe - 이 계속을 트리거한 null 이외의 예외

반환값:

조작을 계속하는 null 이외의 DirContext 객체

예외:

NamingException - 네이밍 예외가 발생했을 경우

관련 항목:

NamingManager.getContinuationContext(CannotProceedException)

getObjectInstance

public static Object  getObjectInstance(Object  refInfo,
                                       Name  name,
                                       Context  nameCtx,
                                       Hashtable <?,?> environment,
                                       Attributes  attrs)
                                throws Exception 

지정된 객체, 속성, 및 환경에 객체의 인스턴스를 생성합니다.

이 메소드는 NamingManager.getObjectInstance 와 거의 같습니다만, 이하의 점이 다릅니다.

• 객체에 관련한 속성을 포함한 Attributes 파라미터를 받아들인다. DirObjectFactory 는 이러한 속성을 사용해, 디렉토리로부터 이러한 속성을 검색하는 수고를 생략한다
• 시행하는 객체 팩토리는,ObjectFactory 또는 DirObjectFactory 를 구현할 필요가 있다. DirObjectFactory 를 구현하고 있는 경우는 DirObjectFactory.getObjectInstance() 가 사용된다. 그 외의 경우는 ObjectFactory.getObjectInstance() 가 사용된다

NamingManager.getObjectInstance() 인터페이스는 아니고 DirContext 인터페이스를 구현하고 있는 서비스 프로바이더가 이 메소드를 사용합니다.

파라미터:

refInfo - 객체 생성 대상의, null 의 가능성이 있는 객체

name - nameCtx 에 관련하는 이 객체의 이름. 생략 하는 경우,name 는 null name 파라미터의 지정에 관련하는 문맥.

nameCtx - null 의 경우,name 는 디폴트의 초기 문맥에 관련한다 null 의 경우,name 디폴트의 초기 문맥에 관련하는

environment - 객체 팩토리 및 객체의 생성에 사용되는, null 의 가능성이 있는 환경

attrs - null 의 가능성이 있는, refInfo 에 관련한 속성 이것은 refInfo 의 완전 속성 세트가 아닌 경우가 있다. 디렉토리로부터 한층 더 속성을 읽어들일 수 있는 일이 있다

반환값:

refInfo 및 attrs 를 사용해 생성된 속성, 또는 팩토리가 객체를 생성할 수 없는 경우는 refInfo

예외:

NamingException - URL 문맥을 취득할 경우에 네이밍 예외가 발견되었을 경우, 또는 액세스 한 팩토리의 1 개가 NamingException 를 throw 했을 경우

Exception - 액세스 된 팩토리의 1 개가 예외를 throw 했을 경우, 또는 팩토리 및 객체 클래스의 로드 및 인스턴스화중에 에러가 발견되었을 경우 팩토리는, 객체 생성에 다른 팩토리를 사용할 필요가 없는 경우에 한정해 예외를 throw 하도록(듯이) 한다. DirObjectFactory.getObjectInstance() 를 참조

도입된 버젼:

1.3

관련 항목:

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

getStateToBind

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

원의 객체 및 그 속성이 지정되었을 때에, 객체의 바인딩 상태를 가져옵니다.

이 메소드는 NamingManager.getStateToBind 를 닮아 있습니다만, 이하의 점이 다릅니다.

• DirContext.bind() 메소드에게 건네진 속성을 포함한 Attributes 파라미터를 받아들인다
• 바인드 되는 객체를 포함한 null 이외의 DirStateFactory.Result 인스턴스, 및 바인딩에 따라 오는 속성을 돌려준다. 객체 또는 속성의 어느 쪽인지가 null 이라도 좋다
• 시행하는 상태 팩토리는 각각,StateFactory 또는 DirStateFactory 를 구현할 필요가 있다. DirStateFactory 를 구현하고 있는 경우는 DirStateFactory.getStateToBind() 가 불려 간다. 그 외의 경우는 StateFactory.getStateToBind() 가 불려 간다

NamingManager.getStateToBind() 인터페이스는 아니고 DirContext 인터페이스를 구현하고 있는 서비스 프로바이더를 이 메소드에 사용합니다.

시행하는 상태 팩토리의 리스트를 결정하는 방법의 설명에 대해서는, NamingManager.getStateToBind()를 참조해 주세요.

이 메소드가 돌려주는 객체는 호출해 옆이 소유합니다. 구현은 계속되어 이것을 변경하지 않습니다. 구현은, 호출측이 소유하는 것과 같은 새로운 Attributes 객체인가, 원의 attrs 파라미터에의 참조의 어느 쪽인지를 포함합니다.

파라미터:

obj - 바인드 하는 상태의 취득 대상이 되는 null 이외의 객체

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

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

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

attrs - null 의 가능성이 있는, 객체에 바인드 되는 Attribute

반환값:

null 이외의 DirStateFactory. 결과에는 바인드 되는 객체 및 속성을 포함한다 null 이외의 답을 돌려주는 상태 팩토리가 없는 경우, 결과는 객체 (obj) 자체를 원의 속성과 함께 포함한다

예외:

NamingException - 팩토리를 사용중에 네이밍 예외가 발견되었을 경우 팩토리는, 객체 생성에 다른 팩토리를 사용하고 싶지 않은 경우에 한정해 예외를 throw 하도록(듯이) 한다. DirStateFactory.getStateToBind() 를 참조

도입된 버젼:

1.3

관련 항목:

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