要在 Web 应用程序中创建和使用资源环境提供程序,您需要:
- 创建共享库
- 创建资源环境提供程序
- 创建可引用的对象。
- 创建资源环境项。
- 创建自定义属性。
- 在 Web 模块中创建资源环境引用。
在接下来的部分中将阐述这些步骤。
1. 创建共享库
创建简单的共享库,以便将类用于服务器上承载的所有应用程序。Websphere Application Server 提供执行以下操作的向导:
-
编译两个类:Config.java 和 ConfigFactory.java,并创建名为reelib.jar的 JAR 文件。
-
将 JAR 文件复制到您选择的位置,如 C:temp。
-
从 Websphere Application Server 管理控制台,展开 Environment => Shared Libraries。
-
将库范围设置为 Cell,然后选择 New(图 1)。
图 1. 设置共享库范围 -
输入库的名称:ree_lib。
-
输入库的文本描述和类路径名称,然后选择 Apply(图 2)。
图 2. 定义共享库保存更改,完成库的创建。将列出新库,如图 3 所示
图 3. 可用的共享库列表
2. 创建资源环境提供程序 -
要创建资源环境提供程序,请执行以下操作:
从管理控制台选择 References => Resource Environment => Resource Environment Providers(图 4)。
图 4. 创建资源环境提供程序 - 将范围级别设置为 Cell,然后选择 New(图 5)。
图 5. 创建新的资源环境提供程序 - 将资源环境提供程序命名为MyResourceEnvironmentProvider,为资源输入描述,然后单击 OK(图 6)。
-
图 6. 定义资源环境提供程序
单击 Save 保存更改。
完成后,新创建的资源环境提供程序将在显示内容中列出(图 7)。
图 7. 可用的资源环境提供程序
3. 创建可引用的对象
“可引用的”对象是定义工厂类和保存自定义属性的类之间关系的对象。要创建可引用的对象,请执行以下操作:
-
从管理控制台展开 Resources => Resource References => Resource Environment Providers。
-
从资源环境提供程序面板(图 8)选择您刚才创建的提供程序 MyResourceEnvironmentProvider。
-
图 8. 选择资源环境提供程序 -
选择 Referenceables(图 9)。
图 9. 资源环境提供程序详细信息 -
单击 New。
-
使用前面定义的类 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 所示。
-
图 10. 定义可引用的对象
图 11. 定义的可引用对象 -
单击 Save 保存更改。
4. 创建资源环境项
|
资源环境项可以通过 JNDI 查询来访问引用的资源。要定义资源环境项,请执行以下操作:
-
从管理控制台展开 Resources => Resource Environment => Resource Environment Providers => MyResourceEnvironmentProvider。
-
选择 Resource environment entries(图 12)。
图 12. 资源环境提供程序详细信息 -
在下一个对话框中选择 New(图 13)。
图 13. 创建新的资源环境项 -
在 Configuration 对话框(图 14)中,输入 Name (MyResourceReference) 和 JNDI name (rep/dev/app1/MyResourceReference) 的值。在应用程序部署资源引用映射的过程中使用此 JNDI 名称。
图 14. 配置资源环境项 -
单击 OK,然后保存更改。
图 15. 定义的资源环境项
5. 创建自定义属性
要定义在应用程序中使用的自定义属性,请执行以下操作:
-
从管理控制台,展开并导航至 Resources => Resource Environment => Resource Environment Providers => MyResourceEnvironmentProvider => Resource Environment Entries => MyResourceReference。
-
选择 Custom properties(图 16)。
图 16. 选择自定义属性 -
选择 New。(图 17)
- 图 17. 创建新的自定义属性
-
输入 Name (MyVariable)、Description、Type 和 Value 字段的值,然后单击 OK。(图 18)
图 18. 定义自定义属性
图 19. 定义的自定义属性 -
您定义的自定义属性将出现在自定义属性列表中(图 19)。重复步骤 d 以添加其他变量。
注意,尽管 Websphere Application Server 提供的向导缺省为 false,但是它不提供指定所需属性的选项。通过 Websphere 管理脚本,您可以为所需属性指定值。如果您运行的是独立应用服务器,或者该应用服务器是集群中的成员,那么您定义的新资源将在重新启动应用服务器后可用。