javax.naming
인터페이스 NamingEnumeration

모든 슈퍼 인터페이스:

Enumeration

public interface NamingEnumeration

extends Enumeration

이 인터페이스는 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()를 사용하면(자), 이러한 메소드는 예외를 슬로우 할 수 없기 때문에, 예외는 슬로우 되지 않습니다. 대신에, 전의 예로, n 번째의 결과가 nextElement()에 의해 돌려주어진 후에 hasMoreElements()를 호출하면(자) false 가 돌려주어집니다.

또, 열거내에 요소가 남지 않은 경우는 프로그램으로 next() 또는 nextElement()를 호출하면(자) NoSuchElementException 가 슬로우 됩니다. 프로그램에서는 열거의 끝나에 도달했는지 어떠했는지를 확인하는 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 () 열거내에 다른 요소가 있을지 어떨지를 판정합니다.
Object	next () 열거내의 다음의 요소를 검색합니다.

인터페이스 java.util. Enumeration 에서 상속받은 메소드

hasMoreElements , nextElement

메소드의 상세

next

public Object  next()
            throws NamingException 

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

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

반환값:

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

예외:

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

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

관련 항목:

Enumeration.nextElement()

hasMore

public boolean hasMore()
                throws NamingException 

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

반환값:

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

예외:

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

관련 항목:

Enumeration.hasMoreElements()

close

public void close()
           throws NamingException 

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

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

예외:

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

도입된 버젼:

1.3