Java Naming and Directory Interface
這個特性會啟用「Java 命名和目錄介面 (JNDI)」來存取 DataSource 或 JMS Connection Factory 之類的伺服器配置資源。另外,它也容許以 jndiEntry 的方式來存取伺服器中所配置的 Java 初始類型。
啟用這項特性
如果要啟用「Java 命名和目錄介面」特性,請在 server.xml 檔的 featureManager 元素內,新增下列的元素宣告:
<feature>jndi-1.0</feature>
支援的 Java™ 版本
- JavaSE-1.6
- JavaSE-1.7
- JavaSE-1.8
開發相依於這項特性的特性
如果您要開發的特性相依於「Java 命名和目錄介面」特性,請將下列項目包含在您新特性的特性資訊清單檔 Subsystem-Content 標頭中:
com.ibm.websphere.appserver.jndi-1.0; type="osgi.subsystem.feature"
啟用這項特性的特性
- Distributed Map interface for Dynamic Caching
- Enterprise JavaBeans Lite 3.1
- Enterprise JavaBeans Lite 3.2
- Java Database Connectivity 4.0
- Java Persistence API 2.0
- Java Persistence API 2.1
- Java EE Managed Bean 1.0
- OSGi Java Persistence API
- Database Session Persistence
- Java EE Web Profile 6.0
- Java EE Web Profile 7.0
特性配置元素
您可以在 server.xml 檔中使用下列元素,來配置「Java 命名和目錄介面」特性:
- classloading
- 廣域類別載入
屬性名稱 資料類型 預設值 說明 useJarUrls boolean false 要使用 jar: 或 wsjar: URL 來參照保存檔中的檔案 - jndiEntry
- JNDI 預設名稱空間中的單一項目。
屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。 jndiName string 要用於此項目的 JNDI 名稱。 value string 要與此名稱建立關聯的 JNDI 值。 - jndiObjectFactory
- JNDI 參照項目要使用的 ObjectFactory。
屬性名稱 資料類型 預設值 說明 className string ObjectFactory 實作類別名稱。 id string 唯一的配置 ID。 libraryRef 最上層 library 元素的參照(字串)。 含有 Factory 實作類別的程式庫。 objectClassName string java.lang.Object Factory 傳回的物件類型。 - jndiObjectFactory > library
說明: 含有 Factory 實作類別的程式庫。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 apiTypeVisibility string spec,ibm-api,api 這個程式庫的類別載入器將能夠看到的 API 套件類型,方式為下列項目之任何組合的逗點區隔清單:spec、ibm-api、api、third-party。 description string 管理者的共用程式庫說明 filesetRef 最上層 fileset 元素的參照清單(逗點區隔的字串)。 參照的檔案集 ID name string 管理者的共用程式庫名稱 - jndiObjectFactory > library > file
說明: 參照的檔案 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。 name 檔案的路徑 完整檔名
- jndiObjectFactory > library > fileset
說明: 參照的檔案集 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 caseSensitive boolean true 指出搜尋是否應該區分大小寫的布林值(預設值:true)。 dir 目錄的路徑 ${server.config.dir} 搜尋檔案的基本目錄。 excludes string 要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。 id string 唯一的配置 ID。 includes string * 要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。 scanInterval 精準度是毫秒的時間量 0 用以檢查檔案集之變更的掃描間隔,以時間單位字尾 h-小時、m-分鐘、s-秒、ms-毫秒的長整數來表示(例如 2ms 或 5s)。預設為已停用 (scanInterval=0)。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
- jndiReferenceEntry
- JNDI 預設名稱空間中的參照項目。
屬性名稱 資料類型 預設值 說明 factoryRef 最上層 jndiObjectFactory 元素的參照(字串)。 參照項目的物件 Factory。 id string 唯一的配置 ID。 jndiName string 參照項目的 JNDI 名稱。 - jndiReferenceEntry > factory
說明: 參照項目的物件 Factory。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 className string ObjectFactory 實作類別名稱。 libraryRef 最上層 library 元素的參照(字串)。 含有 Factory 實作類別的程式庫。 objectClassName string java.lang.Object Factory 傳回的物件類型。 - jndiReferenceEntry > factory > library
說明: 含有 Factory 實作類別的程式庫。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 apiTypeVisibility string spec,ibm-api,api 這個程式庫的類別載入器將能夠看到的 API 套件類型,方式為下列項目之任何組合的逗點區隔清單:spec、ibm-api、api、third-party。 description string 管理者的共用程式庫說明 filesetRef 最上層 fileset 元素的參照清單(逗點區隔的字串)。 參照的檔案集 ID name string 管理者的共用程式庫名稱 - jndiReferenceEntry > factory > library > file
說明: 參照的檔案 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。 name 檔案的路徑 完整檔名
- jndiReferenceEntry > factory > library > fileset
說明: 參照的檔案集 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 caseSensitive boolean true 指出搜尋是否應該區分大小寫的布林值(預設值:true)。 dir 目錄的路徑 ${server.config.dir} 搜尋檔案的基本目錄。 excludes string 要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。 id string 唯一的配置 ID。 includes string * 要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。 scanInterval 精準度是毫秒的時間量 0 用以檢查檔案集之變更的掃描間隔,以時間單位字尾 h-小時、m-分鐘、s-秒、ms-毫秒的長整數來表示(例如 2ms 或 5s)。預設為已停用 (scanInterval=0)。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
- jndiURLEntry
- JNDI 預設名稱空間中的單一項目,用來連結 java.net.URL 項目。
屬性名稱 資料類型 預設值 說明 id string 唯一的配置 ID。 jndiName string 要用於此項目的 JNDI 名稱。 value string 要與此名稱產生關聯的 JNDI URL 值。 - library
- 共用程式庫
屬性名稱 資料類型 預設值 說明 apiTypeVisibility string spec,ibm-api,api 這個程式庫的類別載入器將能夠看到的 API 套件類型,方式為下列項目之任何組合的逗點區隔清單:spec、ibm-api、api、third-party。 description string 管理者的共用程式庫說明 filesetRef 最上層 fileset 元素的參照清單(逗點區隔的字串)。 參照的檔案集 ID id string 唯一的配置 ID。 name string 管理者的共用程式庫名稱 - library > fileset
說明: 參照的檔案集 ID必要: false資料類型: 屬性名稱 資料類型 預設值 說明 caseSensitive boolean true 指出搜尋是否應該區分大小寫的布林值(預設值:true)。 dir 目錄的路徑 ${server.config.dir} 搜尋檔案的基本目錄。 excludes string 要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。 id string 唯一的配置 ID。 includes string * 要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。 scanInterval 精準度是毫秒的時間量 0 用以檢查檔案集之變更的掃描間隔,以時間單位字尾 h-小時、m-分鐘、s-秒、ms-毫秒的長整數來表示(例如 2ms 或 5s)。預設為已停用 (scanInterval=0)。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。