javax.naming

Соедините интерфейсом с NamingEnumeration <T>

Все Суперинтерфейсы:

Перечисление <T>

public interface NamingEnumeration<T>
extends Enumeration<T>

Этот интерфейс для того, чтобы перечислить списки, возвращенные методами в javax.naming и javax.naming.directory пакетах. Это расширяет Перечисление, чтобы позволить как исключения быть брошенным во время перечисления.

Когда метод, такой как список (), listBindings (), или поиск () возвращает NamingEnumeration, любые исключения, с которыми встречаются, резервируются, пока все результаты не были возвращены. В конце перечисления исключение выдается (hasMore ());

Например, если бы список () дает только частичный ответ, соответствующее исключение было бы списком PartialResultException (), сначала возвратит NamingEnumeration. Когда последний из результатов был возвращен следующим NamingEnumeration (), вызывая hasMore () приведет к бросаемому PartialResultException.

В другом примере, если поиск () метод был вызван с указанным пределом размера 'n'. Если бы ответ состоит из больше чем результатов 'n', поиск () сначала возвратил бы NamingEnumeration. Когда результат n'th был возвращен, вызывая затем () на NamingEnumeration, SizeLimitExceedException будет тогда брошенный, когда hasMore () вызывается.

Отметьте, что, если программа использует hasMoreElements () и nextElement () вместо этого, чтобы выполнить итерации через NamingEnumeration, потому что эти методы не могут выдать исключения, никакое исключение не будет выдано. Вместо этого в предыдущем примере, после того, как результат n'th был возвращен nextElement (), вызывая hasMoreElements () возвратит false.

Отметьте также, что NoSuchElementException бросается, если программа вызывает затем () или nextElement (), когда нет никаких элементов, оставленных в перечислении. Программа может всегда избегать этого исключения при использовании hasMore () и hasMoreElements (), чтобы проверить, был ли конец перечисления достигнут.

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

С тех пор:

1.3

См. Также:

Context.list(javax.naming.Name), Context.listBindings(javax.naming.Name), DirContext.search(javax.naming.Name, javax.naming.directory.Attributes, java.lang.String[]), Attributes.getAll(), Attributes.getIDs(), Attribute.getAll()

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	close() Завершения это перечисление.
boolean	hasMore() Определяет, есть ли больше элементы в перечислении.
T	next() Получает следующий элемент в перечислении.

Методы, наследованные от интерфейса java.util. Перечисление

hasMoreElements, nextElement

Деталь метода

затем

T next()
       throws NamingException

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

Отметьте, что next() может также бросить исключение на этапе выполнения NoSuchElementException, чтобы указать, что вызывающая сторона пытается перечислить вне конца перечисления. Это отличается от NamingException, который указывает, что была проблема в получении следующего элемента, например, из-за отсылки или недоступности сервера, и т.д.

Возвраты:

Возможно нулевой элемент в перечислении. нуль только допустим для перечислений, которые могут возвратить нуль (например. Attribute.getAll () возвращает перечисление значений атрибута, и значение атрибута может быть нулем).

Броски:

NamingException - Если с исключением именования встречаются, пытаясь получить следующий элемент. См. NamingException и его подклассы для возможных исключений именования.

NoSuchElementException - Пытаясь получить следующий элемент, когда ни один не доступен.

См. Также:

Enumeration.nextElement()

hasMore

boolean hasMore()
                throws NamingException

Определяет, есть ли больше элементы в перечислении. Этот метод позволяет называть исключения встреченными, определяя, есть ли больше элементов, которое будет поймано и обработано приложением.

Возвраты:

истина, если есть больше в перечислении; ложь иначе.

Броски:

NamingException - Если с исключением именования встречаются, пытаясь определить, есть ли другой элемент в перечислении. См. NamingException и его подклассы для возможных исключений именования.

См. Также:

Enumeration.hasMoreElements()

близко

void close()
           throws NamingException

Завершения это перечисление. После того, как этот метод был вызван на это перечисление, перечисление становится недопустимым и последующим вызовом любого из его методов, приведет к неопределенным результатам. Этот метод предназначается для того, чтобы прервать перечисление к свободному ресурсы. Если перечисление продолжится до конца - то есть, пока hasMoreElements() или hasMore() не возвратит false - то ресурсы будут освобождены автоматически и нет никакой потребности явно вызвать close().

Этот метод указывает поставщику услуг, что это свободно высвободить средства, связанные с перечислением, и может уведомить серверы, чтобы отменить любые выдающиеся запросы. Метод close() является подсказкой к реализациям для того, чтобы управлять их ресурсами. Реализации поощряются использовать соответствующие алгоритмы, чтобы управлять их ресурсами, когда клиент опускает вызовы close().

Броски:

NamingException - Если с исключением именования встречаются, закрывая перечисление.

С тех пор:

1.3