概念: カスタム アセンブリ エレメント
Workday Studio では、以下の 5 種類のカスタム アセンブリ エレメントを作成できます。
カスタム エレメント | 手順 |
|---|---|
メディエーション コンポーネント | "Palette" の "コンポーネント" カテゴリから "custom-mediation" コンポーネントを追加します。 |
メディエーション ステップ | "Palette" の "その他" カテゴリから "カスタム" ステップを追加します。 |
出力トランスポート | "Palette" の "Out Transports" カテゴリから "custom-out" トランスポートを追加します。 |
エラー ハンドラー | "Palette" の "Error Handlers" カテゴリから "custom-error-handler" コンポーネントを追加します。 |
ルーティング ストラテジー | "Route" コンポーネントのコンテキスト ツールバーから "Create custom-strategy" を選択します。 |
いずれの場合も、カスタム エレメントは以下の 3 つの部分で構成されます。
- エレメントで使用されるクラスとメソッドを定義する基礎となる Java 実装。
- Java クラスのインスタンスの作成方法を Workday に指示する、Spring Bean 設定。
- グラフィカルなアセンブリ ビューにカスタム エレメントを配置する、アセンブリ コンポーネントの設定。カスタム アセンブリ エレメントは、受信データを処理する際に通常の方法でメッセージ部分にアクセスできます。また、カスタム エレメントの出力を送信する必要のあるメッセージ部分を指定することもできます。
カスタム エレメントを共有するには、Java パッケージをバイナリ JAR としてエクスポートします。その後、他の開発者はその JAR をプロジェクトのクラスパスに追加できます。
カスタム ステップ
カスタム
ステップの Java 実装を作成する際は、以下の点を考慮してください。- メソッドを宣言する必要がありますpublicクラス外から呼び出すことができるようにするため。
- メソッドは非静的である必要があります。
- 各メソッドには一意の名称を付ける必要がある。
- パラメータ リストは、サポートされている組み合わせと一致している必要がある。
- メソッドは、あらゆるタイプの例外をスローする可能性がある。
- メソッド名を指定しない場合、サポートされている署名方法に一致するパラメータ リストを持つ任意の公開メソッドが選択される (ゲッターとセッターは無視されます)。あいまいな点がある場合は、デプロイ中にエラーが報告されます。このエラーは、メソッド名を指定することで解決できます。
"カスタム"
ステップでは、以下のいずれかの署名に準拠した方法を提供する必要があります。
署名 | 用途 | 例 |
|---|---|---|
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
タイプまたはヌル値の場合、メディアのメッセージは変更されません。