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

Modifier and Type	Field and Description
private int	index The current index in the list of referrals
private List<String>	refs The list of referrals
private Dn	remainingDn The remaining Dn
private Object	resolvedObject The resolved Object
(package private) static long	serialVersionUID The serial version UUID

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() Not yet implemented
Context	getReferralContext(Map<?,?> arg) Not yet implemented
String	getReferralInfo()
Dn	getRemainingDn()
Object	getResolvedObject()
ResultCodeEnum	getResultCode() Always returns ResultCodeEnum.REFERRAL
void	retryReferral() Retry.
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

Field Detail

serialVersionUID

static final long serialVersionUID

The serial version UUID

See Also:

Constant Field Values

refs

private final List<String> refs

The list of referrals

index

private int index

The current index in the list of referrals

remainingDn

private Dn remainingDn

The remaining Dn

resolvedObject

private Object resolvedObject

The resolved Object

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 ResultCode

getReferralInfo

public String getReferralInfo()

Returns:

The current Referral

getReferralContext

public Context getReferralContext()
                           throws NamingException

Not yet implemented

Overrides:

getReferralContext in class AbstractLdapReferralException

Returns:

The Referral Context

Throws:

NamingException - If the operation failed

getReferralContext

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

Not yet implemented

Overrides:

getReferralContext in class AbstractLdapReferralException

Parameters:

arg - The arguments

Returns:

The referral context

Throws:

NamingException - If the operation failed

skipReferral

public boolean skipReferral()

Move to the next referral

Returns:

true if there is some next referral

retryReferral

public void retryReferral()

Retry. Not yet implemented

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