org.apache.directory.api.ldap.model.exception

Class LdapReferralException

java.lang.Object

java.lang.Throwable

java.lang.Exception

org.apache.directory.api.ldap.model.exception.LdapException

org.apache.directory.api.ldap.model.exception.LdapOperationException

org.apache.directory.api.ldap.model.exception.AbstractLdapReferralException

org.apache.directory.api.ldap.model.exception.LdapReferralException

All Implemented Interfaces:

Serializable

public class LdapReferralException
extends AbstractLdapReferralException

A LdapOperationException which associates a resultCode namely the ResultCodeEnum.REFERRAL resultCode with the exception.

Author:

Apache Directory Project

See Also:

Serialized Form

Field Summary

Fields inherited from class org.apache.directory.api.ldap.model.exception.LdapOperationException

resolvedDn, resultCode

Constructor Summary

Constructors

Constructor and Description
LdapReferralException(Collection<String> refs) Creates a new instance of LdapReferralException.
LdapReferralException(Collection<String> refs, String explanation) Creates a new instance of LdapReferralException.

Method Summary

Modifier and Type	Method and Description
Context	getReferralContext()
Context	getReferralContext(Hashtable<?,?> arg)
String	getReferralInfo()
Dn	getRemainingDn()
Object	getResolvedObject()
ResultCodeEnum	getResultCode() Always returns ResultCodeEnum.REFERRAL
void	retryReferral()
void	setRemainingDn(Dn remainingDn)
void	setResolvedObject(Object resolvedObject)
boolean	skipReferral() Move to the next referral

Methods inherited from class org.apache.directory.api.ldap.model.exception.LdapOperationException

getResolvedDn, setResolvedDn

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

LdapReferralException

public LdapReferralException(Collection<String> refs)

Creates a new instance of LdapReferralException.

Parameters:

refs - The list of referrals

LdapReferralException

public LdapReferralException(Collection<String> refs,
                             String explanation)

Creates a new instance of LdapReferralException.

Parameters:

refs - The list of referrals

explanation - The associated error message

Method Detail

getResultCode

public ResultCodeEnum getResultCode()

Always returns ResultCodeEnum.REFERRAL

Overrides:

getResultCode in class AbstractLdapReferralException

Returns:

the LDAP result code corresponding to this exception type.

See Also:

LdapException#getResultCode()

getReferralInfo

public String getReferralInfo()

Returns:

The current Referral

getReferralContext

public Context getReferralContext()
                           throws NamingException

Overrides:

getReferralContext in class AbstractLdapReferralException

Throws:

NamingException

getReferralContext

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

Overrides:

getReferralContext in class AbstractLdapReferralException

Throws:

NamingException

skipReferral

public boolean skipReferral()

Move to the next referral

Returns:

true if there is some next referral

retryReferral

public void retryReferral()

Overrides:

retryReferral in class AbstractLdapReferralException

getRemainingDn

public Dn getRemainingDn()

Overrides:

getRemainingDn in class AbstractLdapReferralException

Returns:

the remainingDn

setRemainingDn

public void setRemainingDn(Dn remainingDn)

Overrides:

setRemainingDn in class AbstractLdapReferralException

Parameters:

remainingDn - the remainingName to set

getResolvedObject

public Object getResolvedObject()

Overrides:

getResolvedObject in class AbstractLdapReferralException

Returns:

the resolvedObject

setResolvedObject

public void setResolvedObject(Object resolvedObject)

Overrides:

setResolvedObject in class AbstractLdapReferralException

Parameters:

resolvedObject - the resolvedObject to set