概念:自定义程序集元素
在 Workday Studio 中,您可以创建 5 种类型的自定义程序集元素:
自定义元素 | 程序 |
|---|---|
中介构成 | 通过“Palette”的“Components”种类添加“custom-mediation”构件。 |
中介步骤 | 通过“Palette”的“Other”种类添加“custom”步骤。 |
出站传输 | 通过“Palette”的“Out Transports”种类添加“custom-out”传输。 |
错误处理程序 | 通过“Palette”的“Error Handlers”种类添加“custom-error-handler”构成。 |
路由策略 | 通过“Route”构成的上下文工具栏,选择“Create custom-strategy”。 |
在每种情况下,自定义元素均包含 3 个部分:
- 基础 Java 实现,定义了元素所用的类和方法。
- Spring Bean 配置,用于向 Workday 说明如何创建 Java 类实例。
- 程序集构成配置,用于将您的自定义元素置于图形化程序集视图中。在处理传入数据时,自定义程序集元素可按常规方式访问消息部分。您还可以指定 Workday 应将自定义元素的输出定向到消息的哪个部分。
要共享自定义元素,请将 Java 包导出为二进制 JAR 文件。然后,其他开发者可将该 JAR 添加到其项目的类路径中。
自定义步骤
在为
自定义
步骤编写 Java 实施时,请参考以下几点:- 必须声明该方法public这样就可以从类的外部调用该函数。
- 方法必须是非静态方法。
- 每个方法的名称都必须唯一。
- 参数列表必须与所支持的组合匹配。
- 方法可引发任何类型的异常。
- 如果您未提供方法名称,Workday 会选择其参数列表与受支持的方法签名匹配的任何公共方法(忽略 getter 和 setter)。如果有任何不清晰之处,Workday 会在部署期间报告错误,您可以通过指定方法名称来解决该错误。
“custom”步骤必须提供符合以下某个签名的方法:
签字 | 用途 | 示例 |
|---|---|---|
public
return type method(input parameter type input) [throws
any Exception ] | 定义方法的返回类型和输入参数。 | public String addTimestamp(byte[] messageContent) throws
IOException {
|
public void method(
input parameter type input,
output parameter type output) [throws any
Exception ] | 定义受支持的输入和输出参数。 | public void addTimestamp(byte[] messageContent,
OutputStream out) throws IOException {
|
自定义
步骤支持以下输入、返回和输出参数类型:
输入类型 | 返回类型 | 输出参数类型 |
|---|---|---|
|
|
|
如果
自定义
步骤返回 void
类型或 null 值,则此设置不会更改中介消息。