配置 Java EE 缺省资源

可使用管理控制台或 wsadmin 命令来为 Java™ Platform Enterprise Edition (Java EE) 缺省资源配置绑定。

关于此任务

新功能部件 新功能部件:
Java EE 规范定义 6 个缺省资源,产品在其缺省配置中提供这些资源。通过将缺省资源的 Java 命名和目录接口 (JNDI) 名称绑定至所配置资源的 JNDI 名称来配置 Java EE 缺省资源提供程序。例如,可将 java:comp/DefaultDataSource 绑定至产品中配置的数据源。newfeat
表 1. Java EE 缺省资源. 每个缺省资源具有类名和 JNDI 名称。必须将资源绑定至对应 WebSphere 资源类型。
资源类 Java EE JNDI 名称 WebSphere 资源类型
javax.sql.DataSource java:comp/DefaultDataSource JDBC 数据源
javax.enterprise.concurrent.ContextService java:comp/DefaultContextService 工作管理器
javax.enterprise.concurrent.ManagedExecutorService java:comp/DefaultManagedExecutorService 工作管理器
javax.enterprise.concurrent.ManagedScheduledExecutorService java:comp/DefaultManagedScheduledExecutorService 工作管理器
javax.enterprise.concurrent.ManagedThreadFactory java:comp/DefaultManagedThreadFactory 工作管理器
javax.jms.ConnectionFactory java:comp/DefaultJMSConnectionFactory JMS 连接工厂

过程

  1. 在管理控制台中,单击资源 > Java EE 缺省资源并转至Java EE 缺省资源设置页面。
  2. 指定范围。

    此范围指示资源配置文件的位置。每个 Java EE 缺省资源在每个单元、节点和服务器范围具有可配置绑定。缺省情况下,绑定是专门针对单元范围的每个缺省资源设置的。可在所有可配置范围、某些可配置范围配置缺省资源绑定,也可不在任何可配置范围配置缺省资源绑定。

    如果缺省资源有多个绑定,那么该产品会按以下优先级解析绑定:
    • 1. 服务器范围
    • 2. 节点范围
    • 3. 单元范围
    例如,如果缺省数据源绑定至 jdbc/myCellDataSource(在单元范围)和 jdbc/myServerDataSource(在 server1 服务器的服务器范围),那么在 server1 上对 java:comp/DefaultDataSource 的任何查找将解析为 jdbc/myServerDataSource。如果单元中有另一服务器 server2 并且在节点范围或服务器范围没有绑定,那么对 java:comp/DefaultDataSource 的查找将解析为 jdbc/myCellDataSource
  3. 将 Java EE 缺省资源绑定至所配置资源。

    例如,要将缺省数据源绑定至所配置 Java 数据库连接 (JDBC) 数据源,请从缺省数据源列表中选择数据源。缺省情况下,每个 java:comp/Defaultxxx 绑定引用产品提供的对应内置资源。

    配置资源提供程序时,考虑以下信息:

    缺省数据源
    缺省配置中的缺省数据源为 Derby 嵌入式数据源,它在生产环境中不受支持。
    避免故障 避免故障: 要在生产环境中使用受支持的缺省数据源,必须对缺省数据源重新配置绑定以引用受支持的数据源。gotcha
    并行缺省资源
    与缺省数据源和缺省 JMS 连接工厂不同,缺省并行资源与 WebSphere 配置中的资源类型不存在一对一的对应关系。反而工作管理器资源将实现全部 4 个并行资源。缺省情况下,全部 4 个 EE 并行缺省资源绑定至具有 wm/default JNDI 名称的单个内置工作管理器资源。可将这些缺省资源绑定至不同工作管理器资源。
    JMS 缺省资源
    缺省 JMS 连接工厂仅在单元范围可用,并引用名为 defaultBus 的 SIBus。要使用缺省 JMS 连接工厂,请创建名为 defaultBus 的服务集成总线,或在管理控制台中修改缺省 JMS 连接工厂总线名称属性以引用预期 SIBus。在任一情况下,必须向该总线添加成员(应用程序服务器),并选择用于存储的消息存储的类型(文件存储或数据存储)以获取消息传递引擎运行时。
  4. 单击确定

    完成这些步骤后,应用程序可通过执行查找(使用其对应 java:comp/Defaultxxx JNDI 名称)来查找该 Java EE 缺省资源。示例部分显示应用程序可用于查找资源的代码。

示例

以下代码示例显示应用程序如何查找缺省资源。

  • 使用 @Resource 注入的查找
    @Resource(lookup = "java:comp/DefaultDataSource")
    DataSource defaultDatasource;
  • JNDI 查找
    DataSource defaultDs = (DataSource) new InitialContext().lookup("java:comp/DefaultDataSource");
  • 不带查找的 @Resource 注释,缺省为 Java EE 规范定义的对应 JNDI 名称
    @Resource
    DataSource defaultDatasource;

下一步做什么

可配置 Java EE 缺省资源绑定至的资源的属性。例如,假定 java:comp/DefaultDataSource 绑定至 jdbc/myDatasource 并且您想要将 java:comp/DefaultDataSource 的最大池大小设置为 10。为此,将 jdbc/myDataSource 的最大池大小设置为 10。有关如何修改各种资源的属性的信息,请参阅相关链接。


指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_jeedefaultres
文件名:tdat_jeedefaultres.html