Java Naming and Directory Interface
此功能部件允许使用 Java 命名和目录接口 (JNDI) 访问服务器配置资源,例如,数据源或 JMS 连接工厂。它还允许访问服务器中配置的 Java 基本类型,例如,jndiEntry。
启用此功能部件
要启用 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 布尔型 false 是将 jar: URL 还是将 wsjar: URL 用于引用归档中的文件 - jndiEntry
- JNDI 缺省名称空间中的单个条目。
属性名称 数据类型 缺省值 描述 id 字符串 唯一配置标识。 jndiName string 要用于此条目的 JNDI 名称。 value string 要与名称相关联的 JNDI 值。 - jndiObjectFactory
- 要由 JNDI 引用条目使用的 ObjectFactory。
属性名称 数据类型 缺省值 描述 className string ObjectFactory 实现类名。 id 字符串 唯一配置标识。 libraryRef 对顶级 library 元素的引用(字符串)。 包含工厂实现类的库。 objectClassName string java.lang.Object 从工厂返回的对象类型。 - jndiObjectFactory > library
描述: 包含工厂实现类的库。必需: false数据类型: 属性名称 数据类型 缺省值 描述 apiTypeVisibility string spec,ibm-api,api 此库的类装入器将能够看到的 API 包的类型,其格式为下列项的任何组合的逗号分隔列表:规范、ibm-api、api 和第三方。 description string 管理员的共享库的描述 filesetRef 对顶级 fileset 元素的引用的列表(以逗号分隔的字符串)。 所引用文件集的标识 name string 管理员的共享库的名称 - jndiObjectFactory > library > file
描述: 所引用文件的标识必需: false数据类型: 属性名称 数据类型 缺省值 描述 id 字符串 唯一配置标识。 name 文件路径 标准文件名
- jndiObjectFactory > library > fileset
描述: 所引用文件集的标识必需: false数据类型: 属性名称 数据类型 缺省值 描述 caseSensitive 布尔型 true 指示搜索是否应区分大小写的布尔值(缺省值:true)。 dir 目录路径 ${server.config.dir} 用于搜索文件的基本目录。 excludes string 要排除在搜索结果以外的文件名模式的逗号或空格分隔列表,缺省情况下不排除任何文件。 id 字符串 唯一配置标识。 includes string * 要包含在搜索结果中的文件名模式的逗号或空格分隔列表(缺省值:*)。 scanInterval 具有毫秒精度的时间段 0 检查文件集更改的扫描时间间隔,格式为长整形加上时间单位后缀(h 表示小时、m 表示分钟、s 表示秒、ms 表示毫秒),例如,2ms 或 5s。缺省情况下为禁用 (scanInterval=0)。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
- jndiReferenceEntry
- JNDI 缺省名称空间中的引用条目。
属性名称 数据类型 缺省值 描述 factoryRef 对顶级 jndiObjectFactory 元素的引用(字符串)。 引用条目的对象工厂。 id 字符串 唯一配置标识。 jndiName string 引用条目的 JNDI 名称。 - jndiReferenceEntry > factory
描述: 引用条目的对象工厂。必需: false数据类型: 属性名称 数据类型 缺省值 描述 className string ObjectFactory 实现类名。 libraryRef 对顶级 library 元素的引用(字符串)。 包含工厂实现类的库。 objectClassName string java.lang.Object 从工厂返回的对象类型。 - jndiReferenceEntry > factory > library
描述: 包含工厂实现类的库。必需: false数据类型: 属性名称 数据类型 缺省值 描述 apiTypeVisibility string spec,ibm-api,api 此库的类装入器将能够看到的 API 包的类型,其格式为下列项的任何组合的逗号分隔列表:规范、ibm-api、api 和第三方。 description string 管理员的共享库的描述 filesetRef 对顶级 fileset 元素的引用的列表(以逗号分隔的字符串)。 所引用文件集的标识 name string 管理员的共享库的名称 - jndiReferenceEntry > factory > library > file
描述: 所引用文件的标识必需: false数据类型: 属性名称 数据类型 缺省值 描述 id 字符串 唯一配置标识。 name 文件路径 标准文件名
- jndiReferenceEntry > factory > library > fileset
描述: 所引用文件集的标识必需: false数据类型: 属性名称 数据类型 缺省值 描述 caseSensitive 布尔型 true 指示搜索是否应区分大小写的布尔值(缺省值:true)。 dir 目录路径 ${server.config.dir} 用于搜索文件的基本目录。 excludes string 要排除在搜索结果以外的文件名模式的逗号或空格分隔列表,缺省情况下不排除任何文件。 id 字符串 唯一配置标识。 includes string * 要包含在搜索结果中的文件名模式的逗号或空格分隔列表(缺省值:*)。 scanInterval 具有毫秒精度的时间段 0 检查文件集更改的扫描时间间隔,格式为长整形加上时间单位后缀(h 表示小时、m 表示分钟、s 表示秒、ms 表示毫秒),例如,2ms 或 5s。缺省情况下为禁用 (scanInterval=0)。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
- jndiURLEntry
- JNDI 缺省名称空间中的单个条目,用于绑定 java.net.URL 条目。
属性名称 数据类型 缺省值 描述 id 字符串 唯一配置标识。 jndiName string 要用于此条目的 JNDI 名称。 value string 要与该名称相关联的 JNDI URL 值。 - library
- 共享库
属性名称 数据类型 缺省值 描述 apiTypeVisibility string spec,ibm-api,api 此库的类装入器将能够看到的 API 包的类型,其格式为下列项的任何组合的逗号分隔列表:规范、ibm-api、api 和第三方。 description string 管理员的共享库的描述 filesetRef 对顶级 fileset 元素的引用的列表(以逗号分隔的字符串)。 所引用文件集的标识 id 字符串 唯一配置标识。 name string 管理员的共享库的名称 - library > fileset
描述: 所引用文件集的标识必需: false数据类型: 属性名称 数据类型 缺省值 描述 caseSensitive 布尔型 true 指示搜索是否应区分大小写的布尔值(缺省值:true)。 dir 目录路径 ${server.config.dir} 用于搜索文件的基本目录。 excludes string 要排除在搜索结果以外的文件名模式的逗号或空格分隔列表,缺省情况下不排除任何文件。 id 字符串 唯一配置标识。 includes string * 要包含在搜索结果中的文件名模式的逗号或空格分隔列表(缺省值:*)。 scanInterval 具有毫秒精度的时间段 0 检查文件集更改的扫描时间间隔,格式为长整形加上时间单位后缀(h 表示小时、m 表示分钟、s 表示秒、ms 表示毫秒),例如,2ms 或 5s。缺省情况下为禁用 (scanInterval=0)。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。