패키지 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 하는 형식으로서 그 밖에 보다 고도의 「검색 필터」를 지원하는 것이 있습니다.

패키지의 사양

Java 테크놀러지의 Web 사이트에서는 다음의 문서를 참조할 수 있습니다.

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

관련 문서

튜토리얼, 예 및 개요에 대해서는 다음을 참조하십시오.

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

도입된 버전 :

1.3