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