軟體套件 javax.naming.directory

擴展 javax.naming 套件以提供存取目錄服務的功能。

請參見：
描述

介面摘要

Attribute	此介面表示與命名物件關聯的屬性。
Attributes	此介面表示屬性的集合。
DirContext	目錄服務介面，包含一些用於檢查和更新與物件關聯的屬性以及搜尋目錄的方法。

類別摘要

BasicAttribute	此類別提供 Attribute 介面的基本實作。
BasicAttributes	此類別提供 Attributes 介面的基本實作。
InitialDirContext	此類別是執行目錄操作的初始上下文。
ModificationItem	此類別表示修改項。
SearchControls	此類別封裝確定搜尋範圍和搜尋返回結果的因子。
SearchResult	此類別表示作為 DirContext.search() 方法的結果返回的 NamingEnumeration 中的一項。

異常摘要

AttributeInUseException	當操作試圖添加已經存在的屬性時拋出此異常。
AttributeModificationException	當試圖添加、移除或修改與屬性的（網要）定義或屬性的狀態有衝突的屬性、屬性標識符或屬性值時拋出此異常。
InvalidAttributeIdentifierException	在試圖用無效的屬性標識符創建屬性時，拋出此異常。
InvalidAttributesException	在嘗試添加或修改不完全或不正確地指定的屬性集時，拋出此異常。
InvalidAttributeValueException	在嘗試添加一個與屬性的網要定義有衝突的屬性時，拋出此類別。
InvalidSearchControlsException	在為搜尋操作指定的 SearchControls 無效時，拋出此異常。
InvalidSearchFilterException	當指定的搜尋過濾器無效時，拋出此異常。
NoSuchAttributeException	嘗試存取不存在的屬性時，拋出此異常。
SchemaViolationException	當方法在某些方面違反網要時，拋出此異常。

軟體套件 javax.naming.directory 的描述

擴展 javax.naming 套件以提供存取目錄服務的功能。

此套件定義 Java Naming and Directory Interface^TM (JNDI) 的目錄操作。 JNDI 向使用 Java 程式語言編寫的應用程序提供命名和目錄功能。它被設計成與任何特定的命名或目錄服務實作無關。因此可以使用共同的方式對多種服務（新的、新出現的及已經部署的服務）進行存取。

此套件允許應用程序檢索和更新與存儲在目錄中的物件關聯的屬性，以及使用指定屬性搜尋物件。

目錄上下文

DirContext 介面表示目錄上下文。該介面定義了一些方法來檢驗和更新與目錄物件（有時稱為目錄項）關聯的屬性。

可以使用 getAttributes() 檢索與目錄物件（為其提供名稱）關聯的屬性。使用 modifyAttributes() 修改屬性。使用此操作可以添加、替換或移除屬性和/或屬性值。

通過擴展 javax.naming 套件中的 Context 介面，DirContext 還可以用作命名上下文。這意味著所有目錄對象也都可以提供命名上下文。例如，某個人的目錄對象可能包含該人的屬性，同時提供與該人相關的命名物件（如他的印表機和住宅目錄）的上下文。

搜尋

DirContext 套件含一些對目錄執行基於內容的搜尋的方法。最簡單和最普通的用法是，應用程序指定一屬性集（可能帶有特定值）來比對 search() 方法，並將此屬性集提交給該方法。也有其他重載形式的 search()，可支持更複雜的搜尋過濾器。

套件規範

JNDI API 規範及相關文檔可在 JNDI documentation 中找到。

從以下版本開始：

1.3