패키지 javax.naming.directory

javax.naming 패키지를 확장해, 디렉토리 서비스에 액세스 하는 기능을 제공합니다.

참조:
설명

인터페이스의 개요

Attribute	이 인터페이스는 지정한 오브젝트에 관련지을 수 있었던 속성을 나타냅니다.
Attributes	이 인터페이스는 속성의 콜렉션을 나타냅니다.
DirContext	디렉토리 서비스 인터페이스로, 오브젝트에 관련지을 수 있었던 속성의 체크 및 변경의 메소드, 및 디렉토리 검색의 메소드를 포함합니다.

클래스의 개요

BasicAttribute	이 클래스는 Attribute 인터페이스의 기본적인 구현을 제공합니다.
BasicAttributes	이 클래스는 Attributes 인터페이스의 기본적인 구현을 제공합니다.
InitialDirContext	이 클래스는 디렉토리 조작을 실행하기 위한 개시 문맥입니다.
ModificationItem	이 클래스는 변경 항목을 나타냅니다.
SearchControls	이 클래스는 검색의 범위를 결정하는 요인, 및 검색의 결과로서 돌려주어진 것을 캡슐화합니다.
SearchResult	이 클래스는 DirContext.search() 메소드의 결과로서 돌려주어진 NamingEnumeration 의 항목을 나타냅니다.

예외의 개요

AttributeInUseException	이 예외는 벌써 존재하는 속성을 추가하려고 하면(자) 슬로우 됩니다.
AttributeModificationException	이 예외는 속성의 (schema) 정의나 속성 상태와 모순되는 속성, 그 식별자, 또는 그 값의 추가, 삭제, 또는 변경을 실행하려고 하면(자) 슬로우 됩니다.
InvalidAttributeIdentifierException	이 예외는 무효인 속성 식별자를 사용해 속성을 추가 또는 작성하려고 했을 경우에 슬로우 됩니다.
InvalidAttributesException	이 예외는 불완전하게 또는 부정하게 지정된 속성 세트를 추가 또는 변경하려고 했을 경우에 슬로우 됩니다.
InvalidAttributeValueException	이 클래스는 속성의 schema의 정의와 모순되는 값을 속성에 추가하려고 했을 경우에 슬로우 됩니다.
InvalidSearchControlsException	이 예외는 검색 조작을 위한 SearchControls 의 지정이 무효인 경우에 슬로우 됩니다.
InvalidSearchFilterException	이 예외는 검색 필터의 지정이 무효인 경우에 슬로우 됩니다.
NoSuchAttributeException	이 예외는 존재하지 않는 속성에 액세스 하려고 했을 경우에 슬로우 됩니다.
SchemaViolationException	이 예외는 메소드가 어떠한 형태로 schema에 위반했을 경우에 슬로우 됩니다.

패키지 javax.naming.directory 의 설명

javax.naming 패키지를 확장해, 디렉토리 서비스에 액세스 하는 기능을 제공합니다.

이 패키지는 Java Naming and Directory Interface^TM (JNDI)의 디렉토리 조작을 정의합니다. JNDI 는 Java 프로그램 언어로 작성된 어플리케이션에 네이밍 기능 및 디렉토리 기능을 제공합니다. JNDI 는 특정의 네이밍 서비스 또는 디렉토리 서비스의 구현과는 별도로 설계되고 있습니다. 이 때문에, 새로운 벌써 배치되고 있는 여러가지 서비스에, 공통의 방법으로 액세스 할 수 있습니다.

이 패키지에 의해 어플리케이션은 디렉토리에 저장되고 있는 오브젝트에 관련지을 수 있고 있는 속성을 검색 및 변경하는 것, 및 지정된 속성을 사용해 오브젝트를 검색할 수 있습니다.

디렉토리 문맥

DirContext 인터페이스는 directory context 를 나타냅니다. 이 인터페이스는 directory object, 혹은 경우에 의해 불려 가는 것이 있는 directory entry 에 관련지을 수 있었던 속성의 체크 및 변경을 위한 메소드를 정의합니다.

getAttributes() 를 사용해, 지정한 이름의 디렉토리 오브젝트에 관련지을 수 있었던 속성을 검색합니다. 속성은 modifyAttributes() 를 사용해 변경됩니다. 이 조작을 사용해, 속성 또는 그 값, 혹은 그 양쪽 모두를 추가, 치환, 또는 삭제할 수 있습니다.

javax.naming 패키지의 Context 인터페이스를 확장하면(자),DirContext 는 네이밍 문맥으로서의 역할도 합니다. 즉, 어느 디렉토리 오브젝트도 또, 네이밍 문맥을 제공할 수 있다고 하는 것입니다. 예를 들어 개인의 디렉토리 오브젝트는 그 개인의 속성을 포함해, 동시에, 프린터나 홈 디렉토리 등 그 개인에게 관련하는 네이밍 오브젝트의 문맥을 제공할 수 있습니다.

검색

DirContext 는 디렉토리의 내용 베이스의 검색을 실행하는 메소드를 포함하고 있습니다. 가장 단순하고 일반적인 사용법에서는 일치하는 속성세트, 및 경우에 따라서는 특정의 값을 어플리케이션이 지정해, 그 속성 세트를 search() 메소드에게 전합니다. search() 를 overload 하는 형식으로서 그 밖에, 보다 고도의 search filters 를 서포트하는 것이 있습니다.

패키지의 사양

Java technology web 사이트에서는 다음의 문서를 참조할 수 있습니다.

• 「JNDI API Document」(Postscript)
• 「JNDI API Document」(PDF)

관련 항목

튜토리얼, 예, 및 개요에 대해서는 다음을 참조해 주세요.

• 「The JNDI Tutorial」
• 「Examples」
• 「Executive Summary」(Postscript)
• 「Executive Summary」(PDF)

도입된 버젼:

1.3