compact3

javax.naming.ldap

Класс LdapReferralException

java.lang. Объект

java.lang. Throwable

java.lang. Исключение

javax.naming. NamingException

javax.naming. ReferralException

javax.naming.ldap. LdapReferralException

Все Реализованные Интерфейсы:

Сериализуемый

public abstract class LdapReferralException
extends ReferralException

Этот абстрактный class используется, чтобы представить исключение отсылки LDAP. Это расширяет основной ReferralException, обеспечивая метод getReferralContext(), который принимает средства управления запросом. LdapReferralException является абстрактный class. Конкретные реализации этого определяют его свойства синхронизации и сериализации.

Массив Control[], который передают в качестве параметра к методу getReferralContext(), принадлежит вызывающей стороне. Поставщик услуг не будет изменять массив или сохранять ссылку на него, хотя он может сохранить ссылки на отдельные объекты Control в массиве.

С тех пор:

1.3

См. Также:

Сериализированная Форма

Полевая Сводка

Поля, наследованные от class javax.naming. NamingException

remainingName, resolvedName, resolvedObj, rootException

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
protected	LdapReferralException() Создает новый экземпляр LdapReferralException.
protected	LdapReferralException(String explanation) Создает новый экземпляр LdapReferralException, используя предоставленное объяснение.

Сводка метода

Модификатор и Тип	Метод и Описание
abstract Context	getReferralContext() Получает контекст, в котором можно продолжать метод, используя среду контекста и никакие средства управления.
abstract Context	getReferralContext(Hashtable<?,?> env) Получает контекст, в котором можно продолжать метод, используя свойства среды и никакие средства управления.
abstract Context	getReferralContext(Hashtable<?,?> env, Control[] reqCtls) Получает контекст, в котором можно продолжать метод, используя средства управления запросом и свойства среды.

Методы, наследованные от class javax.naming. ReferralException

getReferralInfo, retryReferral, skipReferral

Методы, наследованные от class javax.naming. NamingException

appendRemainingComponent, appendRemainingName, getCause, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, initCause, setRemainingName, setResolvedName, setResolvedObj, setRootCause, toString, toString

Методы, наследованные от class java.lang. Throwable

addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Методы, наследованные от class java.lang. Объект

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

Деталь конструктора

LdapReferralException

protected LdapReferralException(String explanation)

Создает новый экземпляр LdapReferralException, используя предоставленное объяснение. Все другие поля, устанавливают в NULL.

Параметры:

explanation - Дополнительная деталь об этом исключении. Может быть нуль.

См. Также:

Throwable.getMessage()

LdapReferralException

protected LdapReferralException()

Создает новый экземпляр LdapReferralException. Все поля, устанавливают в NULL.

Деталь метода

getReferralContext

public abstract Context getReferralContext()
                                    throws NamingException

Получает контекст, в котором можно продолжать метод, используя среду контекста и никакие средства управления. Контекст отсылки создается, используя свойства среды контекста, который бросил ReferralException и никакие средства управления.

Этот метод эквивалентен

 getReferralContext(ctx.getEnvironment(), null);

где ctx является контекстом, который бросил ReferralException.

Это переопределяется в этом class в целях документации только. См. ReferralException для того, как использовать этот метод.

Определенный:

getReferralContext в class ReferralException

Возвраты:

Ненулевой контекст, в котором можно продолжать метод.

Броски:

NamingException - Если с исключением именования встретились. Вызов или retryReferral() или skipReferral(), чтобы продолжать обрабатывать отсылки.

getReferralContext

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

Получает контекст, в котором можно продолжать метод, используя свойства среды и никакие средства управления. Контекст отсылки создается, используя env в качестве его свойств среды и никаких средств управления.

Этот метод эквивалентен

 getReferralContext(env, null);

Это переопределяется в этом class в целях документации только. См. ReferralException для того, как использовать этот метод.

Определенный:

getReferralContext в class ReferralException

Параметры:

env - Возможно нулевая среда, чтобы использовать, получая контекст отсылки. Если ноль, никакие свойства среды не будут использоваться.

Возвраты:

Ненулевой контекст, в котором можно продолжать метод.

Броски:

NamingException - Если с исключением именования встретились. Вызов или retryReferral() или skipReferral(), чтобы продолжать обрабатывать отсылки.

getReferralContext

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

Получает контекст, в котором можно продолжать метод, используя средства управления запросом и свойства среды. Независимо от того, встречаются ли с отсылкой непосредственно во время работы контекста, или косвенно, например, во время перечисления поиска, исключение отсылки должно обеспечить контекст, в котором можно продолжать работу. Чтобы продолжать работу, клиентская программа должна повторно вызвать метод, используя те же самые параметры в качестве исходного вызова.

reqCtls используется, создавая соединение с отнесенным сервером. Эти средства управления будут использоваться в качестве средств управления запросом соединения для контекста и экземпляров контекста, полученных из контекста. reqCtls также будет средствами управления запросом контекста для последующих операций контекста. См. LdapContext описание class для деталей.

Этот метод должен использоваться вместо других двух перегруженных форм, когда вызывающая сторона должна предоставить средства управления запросом для того, чтобы создать контекст отсылки. Это, возможно, должно было бы сделать это, например, когда это должно предоставить специальные средства управления, касающиеся аутентификации.

Конструкторы поставщика услуг должны считать раздел "Поставщика услуг" в LdapContext описание class для деталей реализации.

Параметры:

reqCtls - Возможно нуль запрашивают средства управления использовать для нового контекста. Если нуль или пустые средства массива не используют средств управления запросом.

env - Возможно нулевые свойства среды, чтобы использовать, когда для нового контекста. Если ноль, контекст инициализируется без свойств среды.

Возвраты:

Ненулевой контекст, в котором можно продолжать метод.

Броски:

NamingException - Если с исключением именования встретились. Вызов или retryReferral() или skipReferral(), чтобы продолжать обрабатывать отсылки.