要使用定制策略复审 API 来编写策略,您必须首先创建策略管理器。要添加定制策略,策略管理器必须包含对各定制策略的引用。设置策略管理器类和策略实现,然后将策略管理器添加到存储库。
开始之前
- 设置工作空间。
- 确保工作空间的 Java 版本与服务器上的 Java 版本匹配。例如,IBM® WebSphere® Application Server V7.0 使用 Java 5。如果策略使用 Java 6 编译,那么它无效。
过程
- 设置项目:
- 为定制策略创建 Java 项目。 可以使用样本策略管理器和 SampleGovernor.jar 文件中的策略来入门,方法是将它们导入到项目并对其进行修改以创建定制策略。
- 通过右键单击项目并选择导入来将样本策略管理器导入到项目的 /src 子目录。
- 选择归档文件并单击下一步。
- 单击浏览并选择 SampleGovernor 归档文件。
- 单击完成。 此时内容已添加到您的新项目。
- 将依赖性添加到构建路径: 您必须在类路径中逐个指定 RAM Java API(在 ramclient.zip 文件中)随附的每个 JAR 文件。类路径中 JAR 文件的名称必须包括全名,例如:org.eclipse.emf.ecore.xmi_2.4.1.v200902171115.jar。
- 要从 ramclient 归档导入文件,您可以从“扩展”页面下载该归档。要打开该页面,请单击帮助图标,然后单击扩展。
- 解压缩 ram.client 归档内容以将所需文件添加到新项目。
- 右键单击项目并选择。
- 浏览至您解压缩 ramclient.zip 文件的位置,然后选择所有 com.ibm.ram.common、ramclient、jaxb 和 org.eclipse JAR 文件。 您必须包含以下 JAR 文件:
com.ibm.ram.common
ramclient
jaxb-api
jaxb-impl
org.eclipse.emf.common
org.eclipse.emf.ecore.xmi
org.eclipse.emf.ecore
org.eclipse.equinox.common
org.eclipse.osgi
在 V7.5 和更早版本中,您必须将以下 JAR 文件添加到类路径:
- 编写策略:
- 您可以通过扩展提供的策略之一(如 MyPolicy)来创建策略,也可以不进行扩展而创建策略。您可以使用提供的策略文件中的方法并更改这些方法。例如,在 test() 方法中,您可以根据管理模型的一组特定资产类型详细信息来核准或否决资产策略测试。
有关您在编写定制策略时可以使用哪些 API 的信息,请参阅用于定制策略的 API
注: 您可以在映射中存储策略,并按标识获取策略;例如,private Map
policies;。要从映射中检索策略,请在 getPolicies().get(id) 方法中输入策略标识。
- 在 Governor 类中,添加对每个新策略的引用。
您的 Governor 类必须包含对策略管理器中每个定制策略的引用。 例如,对于 MyPolicy,以下行将添加到 MyGovernor 类(在 MyGovernor.java 中):
//My XML Policy
Policy policy = new MyPolicy(this);
policies.put(policy.getID(), policy);
您可以使用 Rational Asset Manager Java API 来处理定制策略内的当前资产和其他资产。例如,有关如何使用 Java API 的示例,请参阅:使用 Rational Asset Manager Java API。有关您可以使用的 API 的示例和其他信息在 jazz.net 上的定制策略 wiki 页面上
- 安装策略。 打包您的定制策略,方法是将项目导出为 JAR 文件,然后将其添加为新的策略扩展。
- 将项目导出为 JAR 文件。
将您的软件包保存为 Eclipse 项目时,您还必须包含以下 JAR 文件,在策略中使用 Rational Asset Manager
Java API 时需要这些文件:
- 在 WebSphere Application Server 上:
- axis.jar
- jaxrpc.jar
- ramclient.jar
- saaj.jar
- wsdl47-1.5.1.jar
- 在 Tomcat 上:
- ramclient.jar
- org.eclipse.equinox.common(对于 IProgressMonitor)
在 V7.5.0.1 和更高版本中,在上载策略时,您可以将多个 JAR 文件(如 ramclient.jar 和策略 JAR)包含在一个 .zip 文件中。
- 以存储库管理员身份登录产品。
- 在“管理”页面上,单击定制扩展。
- 添加新策略扩展。
- 输入策略管理器的标准类名(包和类)。
- 浏览至步骤 4a 中导出的 JAR 文件。
您的策略可供在生命周期或策略过程中使用。
有关如何添加管理器的其他指示信息,请参阅定义外部策略管理器。
下一步做什么
测试和调试策略。有关指示信息,请参阅
测试和调试策略。