Class LdapReferralException

public abstract class LdapReferralException
extends ReferralException

이 추상 클래스는 LDAP referral(참조) 예외를 나타내는 데 사용돼요. 요청 제어(request controls)를 받아들이는 getReferralContext() 메서드를 제공함으로써 기본 ReferralException을 확장해요. LdapReferralException은 추상 클래스예요. 그 구체적 구현이 동기화·직렬화 속성을 결정해요. getReferralContext() 메서드에 매개변수로 전달되는 Control[] 배열은 호출자가 소유해요. 서비스 공급자는 배열을 수정하거나 참조를 유지하지 않지만, 배열 안의 개별 Control 객체들에 대한 참조는 유지할 수 있어요.

LdapReferralException

protected LdapReferralException(String explanation)

제공된 설명(explanation)을 사용해 LdapReferralException의 새 인스턴스를 생성해요. 다른 모든 필드는 null로 설정돼요.

Parameters: explanation - 이 예외에 대한 추가 세부 정보. null일 수 있음
See Also: Throwable.getMessage()

LdapReferralException

protected LdapReferralException()

LdapReferralException의 새 인스턴스를 생성해요. 모든 필드는 null로 설정돼요.

getReferralContext

public abstract Context getReferralContext()
                                    throws NamingException

getReferralContext(ctx.getEnvironment(), null);

컨텍스트의 환경과 제어 없이 메서드를 계속할 컨텍스트를 가져와요. referral 컨텍스트는 ReferralException을 던진 컨텍스트의 환경 속성과 제어 없이 만들어져요. 이 메서드는 ctx가 ReferralException을 던진 컨텍스트일 때 getReferralContext(ctx.getEnvironment(), null);과 동등해요. 이 메서드는 문서화 목적으로만 이 클래스에서 재정의돼요. 사용법은 ReferralException을 참조하세요.

Specified by: ReferralException 클래스의 getReferralContext
Returns: 메서드를 계속할, null이 아닌 컨텍스트
Throws: NamingException - 네이밍 예외가 발생했을 때. referral 처리를 계속하려면 retryReferral() 또는 skipReferral()을 호출하세요

getReferralContext

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

getReferralContext(env, null);

환경 속성과 제어 없이 메서드를 계속할 컨텍스트를 가져와요. referral 컨텍스트는 env를 환경 속성으로, 제어 없이 만들어져요. 이 메서드는 getReferralContext(env, null);과 동등해요. 문서화 목적으로만 이 클래스에서 재정의돼요. 사용법은 ReferralException을 참조하세요.

Specified by: ReferralException 클래스의 getReferralContext
Parameters: env - referral 컨텍스트를 가져올 때 사용할, null일 수 있는 환경. null이면 어떤 환경 속성도 사용되지 않아요
Returns: 메서드를 계속할, null이 아닌 컨텍스트
Throws: NamingException - 네이밍 예외가 발생했을 때. referral 처리를 계속하려면 retryReferral() 또는 skipReferral()을 호출하세요

getReferralContext

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

요청 제어와 환경 속성을 사용해 메서드를 계속할 컨텍스트를 가져와요. referral이 컨텍스트 연산 중에 직접 만나든, 검색 열거 중에 간접적으로 만나든, referral 예외는 연산을 계속할 컨텍스트를 제공해야 해요. 연산을 계속하려면 클라이언트 프로그램은 원래 호출과 같은 인자로 메서드를 다시 호출해야 해요. reqCtls는 참조된 서버에 대한 연결을 만들 때 사용돼요. 이 제어들은 컨텍스트와 그 컨텍스트에서 파생된 컨텍스트 인스턴스의 연결 요청 제어로 사용될 거예요. reqCtls는 이후 컨텍스트 연산에 대한 컨텍스트의 요청 제어이기도 해요. 자세한 내용은 LdapContext 클래스 설명을 참조하세요. 호출자가 referral 컨텍스트를 만들기 위해 요청 제어를 공급해야 할 때는 다른 두 오버로드 형태 대신 이 메서드가 사용되어야 해요. 예를 들어 인증과 관련된 특수 제어를 공급해야 할 때 그렇게 해야 할 수 있어요. 서비스 공급자 구현자는 구현 세부 내용에 대해 LdapContext 클래스 설명의 "서비스 공급자(Service Provider)" 섹션을 읽어야 해요.

Parameters: env - 새 컨텍스트에 사용할, null일 수 있는 환경 속성. null이면 컨텍스트는 환경 속성 없이 초기화돼요
Returns: 메서드를 계속할, null이 아닌 컨텍스트
Throws: NamingException - 네이밍 예외가 발생했을 때. referral 처리를 계속하려면 retryReferral() 또는 skipReferral()을 호출하세요