javax.naming.ldap
클래스 LdapReferralException

java.lang.Object 
  |
  +--java.lang.Throwable 
        |
        +--java.lang.Exception 
              |
              +--javax.naming.NamingException 
                    |
                    +--javax.naming.ReferralException 
                          |
                          +--javax.naming.ldap.LdapReferralException

모든 구현 인터페이스:

Serializable

public abstract class LdapReferralException

extends ReferralException

이 abstract 클래스는 LDAP 참조 예외를 나타내기 위해서(때문에) 사용됩니다. 요구 컨트롤을 받는 getReferralContext() 메소드에 대응해, 기저가 되는 ReferralException 을 확장합니다. LdapReferralException 는 abstract 클래스입니다. LdapReferralException 의 고정 구현에 의해, 그 클래스의 동기 및 직렬화 프로퍼티가 결정됩니다.

getReferralContext() 메소드에 파라미터로서 건네받는 Control[] 배열은 호출측이 소유합니다. 서비스 프로바이더는 배열을 변경하지 않고 그 배열에 대한 참조도 보관 유지합니다만, 배열내의 개별의 Control 오브젝트에 대한 참조를 보관 유지하는 일이 있습니다.

도입된 버젼:

1.3

관련 항목:

직렬화 된 형식

필드의 개요

클래스 javax.naming. NamingException 에서 상속받은 필드

remainingName , resolvedName , resolvedObj , rootException

생성자의 개요

protected	LdapReferralException () LdapReferralException 의 인스턴스를 새롭게 구축합니다.
protected	LdapReferralException (String explanation) 지정된 설명을 사용해, LdapReferralException 의 인스턴스를 새롭게 구축합니다.

메소드의 개요

abstract Context	getReferralContext () 컨트롤은 사용하지 않고 , 문맥의 환경을 사용해 메소드를 계속하는 시점의 문맥을 검출합니다.
abstract Context	getReferralContext (Hashtable env) 컨트롤은 사용하지 않고 , 환경 프로퍼티를 사용해 메소드를 계속하는 시점의 문맥을 검출합니다.
abstract Context	getReferralContext (Hashtable env, Control [] reqCtls) 요구 컨트롤 및 환경 프로퍼티를 사용해, 메소드를 계속하는 시점의 문맥을 꺼냅니다.

클래스 javax.naming. ReferralException 에서 상속받은 메소드

getReferralInfo , retryReferral , skipReferral

클래스 javax.naming. NamingException 에서 상속받은 메소드

appendRemainingComponent , appendRemainingName , getExplanation , getRemainingName , getResolvedName , getResolvedObj , getRootCause , printStackTrace , printStackTrace , printStackTrace , setRemainingName , setResolvedName , setResolvedObj , setRootCause , toString , toString

클래스 java.lang. Throwable 에서 상속받은 메소드

fillInStackTrace , getCause , getLocalizedMessage , getMessage , getStackTrace , initCause , setStackTrace

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

LdapReferralException

protected LdapReferralException(String  explanation)

지정된 설명을 사용해, LdapReferralException 의 인스턴스를 새롭게 구축합니다. 다른 필드는 모두 null 로 설정됩니다.

파라미터:

explanation - 이 예외에 관한 추가 상세. null 를 지정할 수 있는

관련 항목:

Throwable.getMessage()

LdapReferralException

protected LdapReferralException()

LdapReferralException 의 인스턴스를 새롭게 구축합니다. 모든 필드는 null 로 설정됩니다.

메소드의 상세

getReferralContext

public abstract Context  getReferralContext()
                                    throws NamingException 

컨트롤은 사용하지 않고 , 문맥의 환경을 사용해 메소드를 계속하는 시점의 문맥을 검출합니다. 참조 문맥은 ReferralException 를 슬로우 한 문맥의 환경 프로퍼티를 사용해, 컨트롤을 사용하지 않고 작성됩니다.

이 메소드는 다음과 동등합니다.

 getReferralContext(ctx.getEnvironment(), null);

ctx 가 ReferralException 를 슬로우 한 문맥의 경우

이 메소드는 문서를 목적으로 했을 경우에 한정해, 이 클래스에서 오버라이드(override) 됩니다. 이 메소드를 사용 방법에 대해서는 ReferralException 를 참조해 주세요.

정의:

클래스 ReferralException 내의 getReferralContext

반환값:

메소드를 계속하는 시점의 null 이외의 문맥

예외:

NamingException - 네이밍 예외가 발생했을 경우. retryReferral() 또는 skipReferral() 의 어느 쪽인지를 호출해, 참조의 처리를 계속합니다.

getReferralContext

public abstract Context  getReferralContext(Hashtable  env)
                                    throws NamingException 

컨트롤은 사용하지 않고 , 환경 프로퍼티를 사용해 메소드를 계속하는 시점의 문맥을 검출합니다. 참조 문맥은 env 를 환경 프로퍼티로서 사용해, 컨트롤을 사용하지 않고 작성됩니다.

이 메소드는 다음과 동등합니다.

 getReferralContext(env, null);

이 메소드는 문서를 목적으로 했을 경우에 한정해, 이 클래스에서 오버라이드(override) 됩니다. 이 메소드를 사용 방법에 대해서는 ReferralException 를 참조해 주세요.

정의:

클래스 ReferralException 내의 getReferralContext

파라미터:

env - null 의 가능성이 있는 참조 문맥을 꺼낼 때 사용하는 환경. null 의 경우는 환경 프로퍼티는 사용되지 않습니다.

반환값:

메소드를 계속하는 시점의 null 이외의 문맥

예외:

NamingException - 네이밍 예외가 발생했을 경우. retryReferral() 또는 skipReferral() 의 어느 쪽인지를 호출해, 참조의 처리를 계속합니다.

getReferralContext

public abstract Context  getReferralContext(Hashtable  env,
                                           Control [] reqCtls)
                                    throws NamingException 

요구 컨트롤 및 환경 프로퍼티를 사용해, 메소드를 계속하는 시점의 문맥을 꺼냅니다. 참조의 발생이, 문맥의 조작중에 직접이어도, 또는 검색 열거중 등 간접적이어도, 참조 예외는 조작을 계속하는 시점의 문맥을 제공합니다. 조작을 계속하려면 , 클라이언트 프로그램으로, 원의 호출과 같은 인수를 사용하는 메소드를 재차 호출합니다.

참조원서버에 접속할 때는 reqCtls 가 사용됩니다. 이러한 컨트롤은 문맥, 및 그 문맥으로부터 파생한 문맥 인스턴스에 대한 접속 요구 컨트롤로서 사용됩니다. reqCtls 는 후속의 문맥 조작의 요구 컨트롤로서도 사용됩니다. 상세한 것에 대하여는 LdapContext 클래스 설명을 참조해 주세요.

호출측이 참조 문맥 작성을 위해서(때문에) 요구 컨트롤을 지정할 필요가 있을 때는 overload 된 것 외의 2 개의 형식은 아니고, 이 메소드를 사용합니다. 인증에 관한 특정의 컨트롤을 지정해야 하는 경우 등에 사용합니다.

구현의 상세한 것에 대하여는 구현측인 서비스 프로바이더는 LdapContext 클래스의 「서비스 프로바이더」섹션을 숙독해 주세요.

파라미터:

reqCtls - 새로운 문맥에 사용하는 null 의 가능성이 있는 요구 컨트롤. null 또는 하늘의 배열의 경우는 요구 컨트롤을 사용하고 있지 않는 것을 나타내는

env - 새로운 문맥의 경우에 사용하는 null 의 가능성이 있는 환경 프로퍼티. null 의 경우는 문맥이 환경 프로퍼티를 사용해 초기화되어 있지 않다

반환값:

메소드를 계속하는 시점의 null 이외의 문맥

예외:

NamingException - 네이밍 예외가 발생했을 경우. retryReferral() 또는 skipReferral() 의 어느 쪽인지를 호출해, 참조의 처리를 계속합니다.