Класс 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
Возвращает:: Не-null контекст, в котором следует продолжить метод.
Исключения:: NamingException - Если было встречено исключение имени. Вызовите либо retryReferral() либо skipReferral(), чтобы продолжить обработку переадресаций.

getReferralContext

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

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

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

 getReferralContext(env, null);

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

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

© 1993, 2023, 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/21/docs/api/java.naming/javax/naming/ldap/LdapReferralException.html