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, 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 또는 비어있는 배열의 경우는 요구 컨트롤을 사용하고 있지 않는 것을 나타내는

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

반환값:

메서드를 계속하는 시점의 null 이외의 컨텍스트

예외:

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