패키지 javax.naming.directory

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

참조처:
설명

인터페이스의 개요

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

클래스의 개요

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

예외의 개요

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

패키지 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 를 지원하는 것이 있습니다.

패키지의 스펙

JNDI API 스펙과 관련 문서에 대해서는, 「JNDI 의 문서」를 참조해 주세요.

도입된 버젼:

1.3