Класс LdapReferralException

javax.naming.ldap.LdapReferralException

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

public abstract class LdapReferralException extends ReferralException

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

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

Начиная с:

1.3

См. также:

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

Поля, объявленные в классе 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)`	Возвращает контекст, в котором следует продолжить выполнение метода, используя управляющие элементы запроса и свойства среды.

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

getReferralInfo, retryReferral, skipReferral

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

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

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

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

Методы, объявленные в классе 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://docs.oracle.com/en/java/javase/25/docs/api/java.naming/javax/naming/ldap/LdapReferralException.html