跳至主要内容
Administrator Guide
上次更新时间 :2023-06-23
概念:自定义程序集元素

概念:自定义程序集元素

在 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 {
自定义
步骤支持以下输入、返回和输出参数类型:
输入类型
返回类型
输出参数类型
  • java.lang.String
  • byte[]
  • java.io.InputStream
  • javax.activation.DataHandler
  • javax.activation.DataSource
  • org.w3c.dom.Element
  • org.w3c.dom.Document
  • javax.xml.transform.Source
  • javax.xml.transform.stream.StreamSource
  • javax.xml.transform.dom.DOMSource
  • void
  • boolean
    (仅限
    自定义
    步骤)
  • java.lang.String
  • byte[]
  • java.io.InputStream
  • javax.activation.DataHandler
  • javax.activation.DataSource
  • org.w3c.dom.Element
  • org.w3c.dom.Document
  • javax.xml.transform.Source
  • java.io.OutputStream
  • javax.xml.transform.Result
如果
自定义
步骤返回
void
类型或 null 值,则此设置不会更改中介消息。