Класс LdapReferralException

java.lang.Object
- java.lang.Throwable
- - java.lang.Exception
  - - javax.naming.NamingException
    - - javax.naming.ReferralException
      - 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

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

Модификатор	Конструктор и описание
`protected`	`LdapReferralException()` Создает новый экземпляр LdapReferralException.
`protected`	`LdapReferralException(String explanation)` Создает новый экземпляр 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.
См. также:: Throwable.getMessage()

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);

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

getReferralContext

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

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

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

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

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

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

© 1993, 2020, 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.