在 WebSphere Application Server 中使用资源环境提供程序2

要在 Web 应用程序中建立和使用资源环境提供程序，您须要：

1. 建立共享库
2. 建立资源环境提供程序
3. 建立可引用的对象。
4. 建立资源环境项。
5. 建立自定义属性。
6. 在 Web 模块中建立资源环境引用。

在接下来的部分中将阐述这些步骤。

1. 建立共享库

建立简单的共享库，以便将类用于服务器上承载的全部应用程序。Websphere Application Server 提供执行如下操做的向导：

1. 编译两个类：Config.java 和 ConfigFactory.java，并建立名为reelib.jar的 JAR 文件。

2. 将 JAR 文件复制到您选择的位置，如 C:temp。

3. 从 Websphere Application Server 管理控制台，展开 Environment => Shared Libraries。

4. 将库范围设置为 Cell，而后选择 New（图 1）。

   
   
   图 1. 设置共享库范围
   
   
   

5. 输入库的名称：ree_lib。

6. 输入库的文本描述和类路径名称，而后选择 Apply（图 2）。

   
   
   图 2. 定义共享库
   

   保存更改，完成库的建立。将列出新库，如图 3 所示

   
   
   图 3. 可用的共享库列表
    
   2. 建立资源环境提供程序

7. 要建立资源环境提供程序，请执行如下操做：

   从管理控制台选择 References => Resource Environment => Resource Environment Providers（图 4）。

   
   
   图 4. 建立资源环境提供程序
   
8. 将范围级别设置为 Cell，而后选择 New（图 5）。
   
   图 5. 建立新的资源环境提供程序
   
9. 将资源环境提供程序命名为MyResourceEnvironmentProvider，为资源输入描述，而后单击 OK（图 6）。           
   1. 
      
      图 6. 定义资源环境提供程序
      
      
      

   2. 单击 Save 保存更改。

   完成后，新建立的资源环境提供程序将在显示内容中列出（图 7）。

   
   图 7. 可用的资源环境提供程序
   

   3. 建立可引用的对象

   “可引用的”对象是定义工厂类和保存自定义属性的类之间关系的对象。要建立可引用的对象，请执行如下操做：

   1. 从管理控制台展开 Resources => Resource References => Resource Environment Providers。

   2. 从资源环境提供程序面板（图 8）选择您刚才建立的提供程序 MyResourceEnvironmentProvider。

   1. 
      
      图 8. 选择资源环境提供程序
      
      
      

   2. 选择 Referenceables（图 9）。

      
      
      图 9. 资源环境提供程序详细信息
      
      
      

   3. 单击 New。

   4. 使用前面定义的类 com.ibm.acme.ree.lib.ConfigFactory 和 com.ibm.acme.ree.lib.Config 建立可引用的对象。在 Referenceables 对话框（图 10）中，输入工厂类 (com.ibm.acme.ree.lib.ConfigFactory) 和类名 (com.ibm.acme.ree.lib.Config) 的彻底限定类名，而后选择 OK。而后将显示定义的可引用对象，如图 11 所示。

   1. 
      图 10. 定义可引用的对象
      
      
      
      
      图 11. 定义的可引用对象
      
      
      

   2. 单击 Save 保存更改。

   4. 建立资源环境项

   
   

   关于变量名 若是您使用其余名称定义这些示例中使用以外的某些元素，则确保记录它们并在这些说明中的适当位置替代它们。

   资源环境项能够经过 JNDI 查询来访问引用的资源。要定义资源环境项，请执行如下操做：

   1. 从管理控制台展开 Resources => Resource Environment => Resource Environment Providers => MyResourceEnvironmentProvider。

   2. 选择 Resource environment entries（图 12）。

      
      
      图 12. 资源环境提供程序详细信息
      
      
      

   3. 在下一个对话框中选择 New（图 13）。

      
      
      图 13. 建立新的资源环境项
      
      
      

   4. 在 Configuration 对话框（图 14）中，输入 Name (MyResourceReference) 和 JNDI name (rep/dev/app1/MyResourceReference) 的值。在应用程序部署资源引用映射的过程当中使用此 JNDI 名称。

      
      
      图 14. 配置资源环境项
      
      
      

   5. 单击 OK，而后保存更改。

      
      
      图 15. 定义的资源环境项
      
      
      

   5. 建立自定义属性

   要定义在应用程序中使用的自定义属性，请执行如下操做：

   1. 从管理控制台，展开并导航至 Resources => Resource Environment => Resource Environment Providers => MyResourceEnvironmentProvider => Resource Environment Entries => MyResourceReference。

   2. 选择 Custom properties（图 16）。

      
      
      图 16. 选择自定义属性
      
      
      

   3. 选择 New。（图 17）

   1. 图 17. 建立新的自定义属性
      
      
      

   2. 输入 Name (MyVariable)、Description、Type 和 Value 字段的值，而后单击 OK。（图 18）

      
      
      图 18. 定义自定义属性
      
      
      
      
      图 19. 定义的自定义属性
      
      
      

   3. 您定义的自定义属性将出如今自定义属性列表中（图 19）。重复步骤 d 以添加其余变量。

   注意，尽管 Websphere Application Server 提供的向导缺省为 false，可是它不提供指定所需属性的选项。经过 Websphere 管理脚本，您能够为所需属性指定值。若是您运行的是独立应用服务器，或者该应用服务器是集群中的成员，那么您定义的新资源将在从新启动应用服务器后可用。