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 

이 추상 클래스는, 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 , getCause , getExplanation , getRemainingName , getResolvedName , getResolvedObj , getRootCause , initCause , setRemainingName , setResolvedName , setResolvedObj , setRootCause , toString , toString

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

fillInStackTrace , getLocalizedMessage , getMessage , getStackTrace , printStackTrace , printStackTrace , printStackTrace , 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 를 throw 한 문맥의 환경 프로퍼티을 사용해, 컨트롤을 사용하지 않고 작성됩니다.

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

 getReferralContext(ctx.getEnvironment(), null);

ctx 는 ReferralException 를 throw 한 문맥입니다.

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

정의:

클래스 ReferralException 내의 getReferralContext

반환값:

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

예외:

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

getReferralContext

public abstract Context  getReferralContext(Hashtable <?,?> env)
                                    throws NamingException 

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

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

 getReferralContext(ctx.getEnvironment(), 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 또는 빈 상태(empty)의 배열의 경우는, 요구 컨트롤을 사용하고 있지 않는 것을 나타내는

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

반환값:

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

예외:

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