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

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

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

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

반환값:

refInfo 및 attrs 를 사용해 생성된 속성, 또는 팩토리가 오브젝트를 생성할 수 없는 경우는 refInfo

예외:

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

Exception - 액세스 한 팩토리의 1 개가 예외를 슬로우 했을 경우, 또는 팩토리 및 오브젝트 클래스의 로드 및 인스턴스화중에 에러가 발견되었을 경우. 팩토리는 오브젝트 생성에 다른 팩토리를 사용하고 싶지 않은 경우에 한정해 예외를 슬로우 하도록(듯이) 한다. 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 - 팩토리를 사용중에 네이밍 예외가 발견되었을 경우. 팩토리는 오브젝트 생성에 다른 팩토리를 사용하고 싶지 않은 경우에 한정해 예외를 슬로우 하도록(듯이) 한다. 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)