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

LdapReferralException(Collection<String> refs)
Creates a new instance of LdapReferralException.

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

Method Summary

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

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, 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