您可以编写调解处理程序、对它添加调解功能以及使它作好准备以安装在应用程序服务器上。
开始之前
您应该能够访问 Java™
编程环境和组装工具(例如,
IBM® Rational® Application Developer)。
关于此任务
可以部署调解处理程序。每个调解处理程序都会在运行时执行一些特定的消息处理,例如,变换消息格式或者将消息路由至特定目标。调解处理程序是 Java
程序框架,您可以对它添加执行调解功能的代码。
可以在 Java
项目或 EJB 项目中定义调解处理程序类(部署工件需要该类)。可以将编程工件与部署工件分开放在不同项目中。以下步骤适用于 EJB 项目,但是,如果要创建 Java 项目,那么步骤非常相似,这是因为您将为 Java 项目或 EJB 项目定义目标服务器,并且服务器运行时插件会正确设置类路径。
过程
- 创建新的 EJB 项目:
- 切换到 Java EE 透视图以处理 Java EE 项目。单击窗口 > 打开透视图 > 其他 > Java EE。
- 从“文件”菜单中,选择新建 > 项目。
- 展开 Java EE 文件夹并选择“企业应用程序项目”。单击下一步。
- 可选: 如果已创建 Java 项目而不是 EJB 项目,请右键单击上下文菜单的 Java 项目文件夹图标,并选择“属性”。显示“属性”面板时,请选择“服务器属性”并将系统的适当服务器设置为该项目的目标,如下一个步骤所示。
- 输入项目的名称并将系统的适当服务器设置为该项目的目标。(如果这是第一次将此服务器设置为目标,请单击新建...。)单击下一步以进入“EAR 模块项目”窗口。
- 单击新建模块...。
- 通过选中 EJB 项目旁边的复选框并输入调解处理程序的名称,创建新的模块项目。
- 单击完成。 将返回到“EAR 模块项目”窗口。
- 单击完成以创建新的项目。
- 通过实现 com.ibm.websphere.sib.mediation.handler.MediationHandler 接口来创建调解处理程序类。
- 从“文件”菜单中,选择新建 > Java 类。
- 指定调解 EAR 项目的源文件夹。
- 指定调解处理程序的名称。
- 选择超类 java.lang.Object。
- 选择接口 com.ibm.websphere.sib.mediation.handler.MediationHandler。
- 选中继承的抽取方法复选框。
- 单击完成以创建新的调解处理程序类。
- 使用 IBM Rational Application Developer
将变换或路由消息的功能代码添加到调解处理程序。有关更多信息,请参阅将调解功能添加到处理程序代码中。注意,由该工具箱创建的句柄方法的缺省返回值是
false,这会导致废弃消息。必须将返回值更改为
true 才能保留消息。
- 根据调解处理程序类来生成 EAR 文件。遵循 IBM Rational Application Developer 文档中的指示信息执行操作。
下一步做什么
下一步,准备将包含调解处理程序的 EAR 文件安装到应用程序服务器中。