Класс ReferralException

protected ReferralException(String explanation)

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

protected ReferralException()

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

public abstract Object getReferralInfo()

Возвращает сведения (например, URL-адреса), связанные с этим перенаправлением. Программа может изучить или показать пользователю эти сведения, чтобы определить, следует ли продолжать перенаправление, либо определить, какие дополнительные сведения необходимо предоставить для его продолжения.

public abstract Context getReferralContext() throws NamingException

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

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

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

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

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

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

public abstract boolean skipReferral()

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

 } catch (ReferralException e) {
     if (!shallIFollow(e.getReferralInfo())) {
         if (!e.skipReferral()) {
             return;
         }
     }
     ctx = e.getReferralContext();
 }

public abstract void retryReferral()

Повторно обрабатывает текущее перенаправление. После вызова этого метода следует вызвать getReferralContext, чтобы повторить текущее перенаправление. В следующем фрагменте кода показан типичный пример использования.

 } catch (ReferralException e) {
     while (true) {
         try {
             ctx = e.getReferralContext(env);
             break;
         } catch (NamingException ne) {
             if (! shallIRetry()) {
                 return;
             }
             // modify environment properties (env), if necessary
             e.retryReferral();
         }
     }
 }