Класс 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();
         }
     }
 }