| This exception is raised when a referral to an alternative context
is encountered.
An LdapReferralException object contains one or more referrals.
Each referral is an alternative location for the same target entry.
For example, a referral may be an LDAP URL.
The referrals are attempted in sequence until one is successful or
all have failed. In the case of the latter then the exception generated
by the final referral is recorded and presented later.
A referral may be skipped or may be retried. For example, in the case
of an authentication error, a referral may be retried with different
environment properties.
An LdapReferralException object may also contain a reference
to a chain of unprocessed LdapReferralException objects.
Once the current set of referrals have been exhausted and unprocessed
LdapReferralException objects remain, then the
LdapReferralException object referenced by the current
object is thrown and the cycle continues.
If new LdapReferralException objects are generated while
following an existing referral then these new objects are appended
to the end of the chain of unprocessed LdapReferralException
objects.
If an exception was recorded while processing a chain of
LdapReferralException objects then is is throw once
processing has completed.
author:
Vincent Ryan | 