Класс LdapReferralException

javax.naming.ldap.LdapReferralException

Все реализуемые интерфейсы:: Serializable

public abstract class LdapReferralException extends ReferralException

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

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

С момента:

1.3

См. также:

Краткое описание полей

Поля, объявленные в классе javax.naming.NamingException

remainingName, resolvedName, resolvedObj, rootException

Краткое описание конструкторов

LdapReferralException()

LdapReferralException(String explanation)

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

Краткое описание методов

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

Методы, объявленные в классе javax.naming.ReferralException

getReferralInfo, retryReferral, skipReferral

Методы, объявленные в классе javax.naming.NamingException

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

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

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

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

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

Подробное описание конструкторов

LdapReferralException

protected LdapReferralException(String explanation)

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

Параметры:

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

См. также:

LdapReferralException

protected LdapReferralException()

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

Подробное описание методов

getReferralContext

public abstract Context getReferralContext() throws NamingException

Возвращает контекст, в котором следует продолжить метод, используя среду контекста и без управляющих элементов. Контекст перенаправления создается с использованием свойств среды контекста, который выбросил ReferralException, и без управляющих элементов.

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

 getReferralContext(ctx.getEnvironment(), null);

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

Он переопределен в этом классе только для целей документации. См. ReferralException, чтобы узнать, как использовать этот метод.

Определено в:: getReferralContext в классе ReferralException
Возвращает:: Не нулевой контекст, в котором следует продолжить метод.
Исключения:: NamingException - Если возникло исключение именования. Вызовите либо retryReferral(), либо skipReferral() для продолжения обработки перенаправлений.

getReferralContext

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

Возвращает контекст, в котором следует продолжить метод, используя свойства среды и без управляющих элементов. Контекст перенаправления создается с использованием env в качестве своих свойств среды и без управляющих элементов.

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

 getReferralContext(env, null);

Определено в:: getReferralContext в классе ReferralException
Параметры:: env - Возможные null свойства среды для использования при получении контекста перенаправления. Если null, не будут использоваться свойства среды.
Возвращает:: Не нулевой контекст, в котором следует продолжить метод.
Исключения:: NamingException - Если возникло исключение именования. Вызовите либо retryReferral(), либо skipReferral() для продолжения обработки перенаправлений.

getReferralContext

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

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

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

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

Реализаторы поставщиков услуг должны прочитать раздел «Поставщик услуг» в описании класса LdapContext для получения подробностей реализации.

Параметры:: env - Возможные null свойства среды для использования для нового контекста. Если null, контекст инициализируется без свойств среды.; reqCtls - Возможные null управляющие элементы запроса для использования для нового контекста. Если null или пустой массив, не используются управляющие элементы запроса.
Возвращает:: Не нулевой контекст, в котором следует продолжить метод.
Исключения:: NamingException - Если возникло исключение именования. Вызовите либо retryReferral(), либо skipReferral() для продолжения обработки перенаправлений.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.naming/javax/naming/ldap/LdapReferralException.html