javax.naming
인터페이스 NamingEnumeration<T>

모든 슈퍼 인터페이스:

Enumeration <T>

public interface NamingEnumeration<T>
extends Enumeration <T>

이 인터페이스는 javax.naming 및 javax.naming.directory 패키지내의 메서드에 의해 리턴된 리스트를 열거하기 위해서 사용됩니다. 이 인터페이스를 사용하면, 열거중에 Enumeration가 예외로서 발생 됩니다.

list(), listBindings(), search()등의 메서드가 NamingEnumeration를 돌려주면, 발생한 어느 예외도 모든 결과가 돌려주고질 때까지 보관 유지됩니다. 열거의 마지막에 예외가 (hasMore()에 해) 발생 됩니다.

예를 들어 list()가 부분적인 회답만을 돌려주고 있는 경우는 거기에 대응하는 예외는 PartialResultException가 됩니다. list()는 최초로 NamingEnumeration를 리턴합니다. 그 결과의 최후가 NamingEnumeration next()로 돌려주고졌을 때에 hasMore()를 호출하면 PartialResultException가 발생 됩니다.

다른 예로서 search() 메서드가 사이즈를 'n'에 제한 지정해 불려 갔다고 합니다. 회답이 'n'보다 많아졌을 경우, search()는 최초로 NamingEnumeration를 리턴합니다. n 번째의 결과가 NamingEnumeration 로 next()를 호출해 돌려주고졌을 때는 hasMore()를 호출하면 SizeLimitExceedException가 발생 됩니다.

프로그램으로 NamingEnumeration를 반복하지 않고, hasMoreElements() 및 nextElement()를 사용하면, 이러한 메서드는 예외를 Throw 할 수 없기 때문에 예외는 Throw 되지 않습니다. 대신에 전의 예로 n 번째의 결과가 nextElement()에 의해 리턴된 뒤에 hasMoreElements()를 호출하면 false가 리턴됩니다 .

또, 열거내에 요소가 남지 않은 경우는 프로그램으로 next() 또는 nextElement()를 호출하면 NoSuchElementException가 발생 됩니다. 프로그램에서는 열거의 끝나에 도달했는지 어떠했는지를 확인하는 hasMore() 및 hasMoreElements()를 사용해 이 예외를 항상 회피할 수 있습니다.

열거중에 예외가 Throw 되면, 열거는 무효가 됩니다. 열거상에서 어느 메서드를 다음에 호출해도, 결과는 보증되지 않습니다.

도입된 버전 :

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. Enumeration 로부터 상속된 메서드

hasMoreElements, nextElement

메서드의 상세

next

T  next()
       throws NamingException 

열거내의 다음의 요소를 검색합니다. 이 메서드에서는 어플리케이션에 의해 다음에 취득 및 처리되는 요소를 검색할 경우에 네이밍 예외를 검출할 수 있습니다.

또한, next()는 실행시 예외 NoSuchElementException을 Throw 해, 호출측이 열거의 최대값을 넘어 열거하려고 하고 있는 것을 표시할 수 있습니다. 이것은 참조나 서버의 사용 불가등을 때문에에 다음의 요소의 취득시에 문제가 발생한 것을 표시하는 NamingException와는 다릅니다.

반환값:

열거내의 요소 (null인 경우도 있다). null은 null을 돌려줄 수 있는 열거에 대해서만 유효 (예를 들어 Attribute.getAll()는 속성값의 열거를 돌려주지만, 속성값는 null인 경우도 있다)

예외:

NamingException - 다음의 요소의 검색중에 네이밍 예외가 발생하는 경우. 발생할 가능성이 있는 네이밍 예외에 대해서는 NamingException 및 그 서브 클래스를 참조

NoSuchElementException - 사용할 수 있는 요소가 없을 때에 다음의 요소를 취득하려고 하고 있는 경우

관련 항목:

Enumeration.nextElement()

hasMore

boolean hasMore()
                throws NamingException 

열거내에 다른 요소가 있을지 어떨지를 판정합니다. 이 메서드에서는 어플리케이션으로 취득 및 처리되는 그 외의 요소가 있을지 어떨지 판정하고 있는 동안에 네이밍 예외가 발생합니다.

반환값:

열거내에 다른 요소가 있는 경우는 true, 그렇지 않은 경우는 false

예외:

NamingException - 열거내에 다른 요소가 있을지 어떨지를 판정하고 있는 동안에 네이밍 예외가 발생하는 경우. 발생할 가능성이 있는 네이밍 예외에 대해서는 NamingException 및 그 서브 클래스를 참조

관련 항목:

Enumeration.hasMoreElements()

close

void close()
           throws NamingException 

이 열거를 닫습니다.이 열거로 이 메서드를 호출하면, 열거는 무효가 되어, 다음에 그 메서드의 어느쪽이든을 호출해도, 결과는 보증되지 않습니다. 이 메서드는 열거를 중지해 자원을 해방하기 위해서 사용됩니다. 열거가 종단 (즉 hasMoreElements() 또는 hasMore()가 false를 돌려줄 때까지)에 도달하면, 자원은 자동적으로 해방되어, 명시적으로 close()를 호출할 필요가 없어집니다.

이 메서드는 열거에 관련된 자원을 자유롭게 해방할 수 있는 것을 서비스 프로바이더에 나타내, 또 미처리 요구의 취소를 서버에 통지할 수 있습니다. close() 메서드는 그러한 자원을 관리하는 구현에의 힌트가 됩니다. 클라이언트가 close() 호출을 생략 했을 경우, 구현에서는 자원을 관리하는데 적절한 알고리즘을 사용하는 것을 추천합니다.

예외:

NamingException - 열거를 닫고 있는 동안에 네이밍 예외가 발생하는 경우

도입된 버전 :

1.3