ロジックプラグインの作成と追加（非推奨）

タスク	目的	例
ルート変更	ビジネスメッセージの受信側のリストを変更する。受信側による会話およびコラボレーションアグリーメントの検証を条件とする。この機能は、WebLogic Integration B2B システムプラグインおよびカスタムプラグインによって提供される。	「コンピュータチップについて 100 万ドルを超える額の注文を受けたら、NewChipCo を受信側に含めること」「2002 年 1 月 1 日以降、OldChipCo. へは注文を送信しないこと」
検査	ビジネスメッセージの内容を調べ、その結果に基づいて特定のアクションを起こす。この機能はカスタムプラグインによって提供される。注意: 検査されるビジネスメッセージの大多数は、暗号化された内容を含みません。	「請求処理の目的でメッセージの送信側をすべて記録する」「特定の型のメッセージについて、会話のバージョン 1 とバージョン 2 の比率は?」

タスク

目的

例

ルート変更

ビジネスメッセージの受信側のリストを変更する。受信側による会話およびコラボレーションアグリーメントの検証を条件とする。この機能は、WebLogic Integration B2B システムプラグインおよびカスタムプラグインによって提供される。

「コンピュータチップについて 100 万ドルを超える額の注文を受けたら、NewChipCo を受信側に含めること」

「2002 年 1 月 1 日以降、OldChipCo. へは注文を送信しないこと」

検査

ビジネスメッセージの内容を調べ、その結果に基づいて特定のアクションを起こす。この機能はカスタムプラグインによって提供される。

注意: 検査されるビジネスメッセージの大多数は、暗号化された内容を含みません。

「請求処理の目的でメッセージの送信側をすべて記録する」

「特定の型のメッセージについて、会話のバージョン 1 とバージョン 2 の比率は?」

ロジックプラグイン	説明
XOCP ルータ	システムロジックプラグイン。WebLogic Integration によってこのロジックプラグインが提供される。リポジトリでコンフィグレーションされている XPath ルータ式に基づいて XOCP ビジネスメッセージの受信側リストを変更できる。このロジックプラグインは、XOCP ルータチェーンの先頭になければならない。
XOCP-MessageTracker	カスタムロジックプラグイン。WebLogic Integration のオーナまたはトレーディングパートナは、こうしたカスタムロジックプラグインを用意して、各トレーディングパートナから請求処理の目的で送信されるビジネスメッセージの数をトラッキングできる。
XOCP-MessageInspector	カスタムロジックプラグイン。WebLogic Integration のオーナまたはトレーディングパートナは、こうしたカスタムロジックプラグインを用意して、B2B エンジンを通じて交換されている各種のビジネスドキュメント（たとえば発注書、インボイスなど）の統計を検査および保持できる。
XOCP ルータエンキュー	システムロジックプラグイン。WebLogic Integration によってこのロジックプラグインが提供される。内部の WebLogic Integration B2B ルータメッセージキューに XOCP ビジネスメッセージを追加する。このロジックプラグインは、XOCP ルータチェーンの末尾になければならない。

ロジックプラグイン

説明

XOCP ルータ

システムロジックプラグイン。WebLogic Integration によってこのロジックプラグインが提供される。リポジトリでコンフィグレーションされている XPath ルータ式に基づいて XOCP ビジネスメッセージの受信側リストを変更できる。このロジックプラグインは、XOCP ルータチェーンの先頭になければならない。

XOCP-MessageTracker

カスタムロジックプラグイン。WebLogic Integration のオーナまたはトレーディングパートナは、こうしたカスタムロジックプラグインを用意して、各トレーディングパートナから請求処理の目的で送信されるビジネスメッセージの数をトラッキングできる。

XOCP-MessageInspector

カスタムロジックプラグイン。WebLogic Integration のオーナまたはトレーディングパートナは、こうしたカスタムロジックプラグインを用意して、B2B エンジンを通じて交換されている各種のビジネスドキュメント（たとえば発注書、インボイスなど）の統計を検査および保持できる。

XOCP ルータエンキュー

システムロジックプラグイン。WebLogic Integration によってこのロジックプラグインが提供される。内部の WebLogic Integration B2B ルータメッセージキューに XOCP ビジネスメッセージを追加する。このロジックプラグインは、XOCP ルータチェーンの末尾になければならない。

ロジックプラグイン	説明
XOCP ルータ（XOCP router）	リポジトリでコンフィグレーションされている XPATH ルータ式に基づいて XOCP ビジネスメッセージの受信側のリストを変更する。このシステムロジックプラグインは、ルータロジックプラグインチェーンの先頭である必要がある。先頭にあれば、受信側のリストが既知になるので、カスタムロジックプラグインがビジネスメッセージを処理できる。
XOCP ルータエンキュー	WebLogic Integration B2B ルータメッセージキューに XOCP ビジネスメッセージを追加する。このシステムロジックプラグインは、XOCP ルータロジックプラグインチェーンの末尾になければならない。
XOCP フィルタ（XOCP filter）	リポジトリでコンフィグレーションされている XPATH フィルタ式に基づいて、特定のトレーディングパートナへ XOCP ビジネスメッセージを送信するかどうかを決定する。このシステムロジックプラグインは、XOCP フィルタロジックプラグインチェーンの末尾になければならない。
RosettaNet ルータエンキュー	WebLogic Integration B2B ルータメッセージキューに RosettaNet ビジネスメッセージを追加する。このシステムロジックプラグインは、RosettaNet ルータロジックプラグインチェーンの末尾になければならない。
RosettaNet フィルタ（RosettaNet filter）	RosettaNet ビジネスメッセージを特定のトレーディングパートナへ送信するかどうかを決定する。このシステムロジックプラグインは、RosettaNet フィルタロジックプラグインチェーンの末尾になければならない。

ロジックプラグイン

説明

XOCP ルータ（XOCP router）

リポジトリでコンフィグレーションされている XPATH ルータ式に基づいて XOCP ビジネスメッセージの受信側のリストを変更する。このシステムロジックプラグインは、ルータロジックプラグインチェーンの先頭である必要がある。先頭にあれば、受信側のリストが既知になるので、カスタムロジックプラグインがビジネスメッセージを処理できる。

XOCP ルータエンキュー

WebLogic Integration B2B ルータメッセージキューに XOCP ビジネスメッセージを追加する。このシステムロジックプラグインは、XOCP ルータロジックプラグインチェーンの末尾になければならない。

XOCP フィルタ（XOCP filter）

リポジトリでコンフィグレーションされている XPATH フィルタ式に基づいて、特定のトレーディングパートナへ XOCP ビジネスメッセージを送信するかどうかを決定する。このシステムロジックプラグインは、XOCP フィルタロジックプラグインチェーンの末尾になければならない。

RosettaNet ルータエンキュー

WebLogic Integration B2B ルータメッセージキューに RosettaNet ビジネスメッセージを追加する。このシステムロジックプラグインは、RosettaNet ルータロジックプラグインチェーンの末尾になければならない。

RosettaNet フィルタ（RosettaNet filter）

RosettaNet ビジネスメッセージを特定のトレーディングパートナへ送信するかどうかを決定する。このシステムロジックプラグインは、RosettaNet フィルタロジックプラグインチェーンの末尾になければならない。

表3-4 ロジックプラグイン API

クラス/インタフェース	説明
com.bea.b2b.protocol.PlugIn	汎用のロジックプラグインを表すタグ付けインタフェース。つまり、実行するためにルータまたはフィルタに挿入できるコード。
com.bea.b2b.protocol.PlugInException	ロジックプラグインの実行中にエラーが発生すると送出される例外クラス。
com.bea.b2b.protocol.messaging. MessageEnvelope	ビジネスメッセージのコンテナ（エンベロープ）を表す。MessageEnvelope には、実際のビジネスメッセージに加えて、関連するルーティングおよび処理の高度な情報が含まれている。たとえば、送信側 URL、および 1 名の受信側のための URL （受信側の各自に 1 つずつメッセージエンベロープがある）などである。ネイティブなメッセージへのアクセスが必要な場合に備えて、 Java の InputStream も利用可能である（ただし、メッセージ内容の変更は不可なので、OutputStream は一切提供されない）。
com.bea.b2b.protocol.messaging. メッセージ	Message インタフェースには、WebLogic Integration B2B エンジンでビジネスメッセージを処理するために必要なすべての情報が含まれている。Message インタフェースによって、トレーディングパートナ間でメッセージを適切にルーティングするために使用される情報が提供される。また、Message インタフェースには、ビジネスメッセージに使用されている特定のビジネスプロトコルに固有の情報も含まれている。使用されるプロトコルに応じて、通常 Message クラスはメッセージに関するプロトコル固有の追加情報を提供するためのサブクラスを含んでいる。
com.bea.b2b.protocol.messaging. PayloadPart	メッセージペイロードのコンポーネントを表す。この情報を実装する特定のクラスは、ビジネスメッセージの各部ごとに提供されている。たとえば XML 部分と非 XML 部分などである。つまり、ビジネスプロトコル固有の情報へのアクセスを補助するために提供されている。
com.bea.b2b.protocol.conversation. ConversationType	特定の会話定義の中で 1 つのロールを表す。ConversationType クラスには、会話名、会話バージョン、およびトレーディングパートナロールなどの情報が含まれる。
com.bea.b2b.tpa.CAInstance	コラボレーションアグリーメントのインスタンスを表す。利用可能なメソッドによって、コラボレーションアグリーメントに関するさまざまな情報を取得できる。この API でコラボレーションアグリーメントを変更することは許可されていないので、取得および検証のためのメソッドのみが提供されている。
com.bea.b2b.tpa.PartyInstance	コラボレーションアグリーメントのパーティを表す。利用可能なメソッドによって、コラボレーションアグリーメントのパーティに関する情報を検証または取得できる。たとえば、コラボレーションアグリーメントのパーティによって使用されている配信チャネルなどである。
com.bea.b2b.tpa. TradingPartnerInstance	実行時のトレーディングパートナのインスタンスを表す。このクラスは PartyInstance とともに使用されるか、ルータまたはフィルタとともにスタンドアロンモードで使用される。

import java.util.Hashtable;
import com.bea.b2b.protocol.*;
import com.bea.b2b.protocol.messaging.*;
import com.bea.eci.logging.*;
import javax.naming.*;
import javax.sql.DataSource;

// このパッケージは DB プールへのアクセスに必要
import java.sql.*;

クラス/インタフェース	説明
EXCEPTION_CONTINUE	PlugInException が送出されても、処理を停止しないようにする。処理は、チェーン内の次のロジックプラグインまで継続される。このオプションは、ロジックプラグインの実行中にエラーが発生した場合でもビジネスメッセージの処理を継続できるようにするために使用する。
EXCEPTION_STOP	PlugInException が送出されたら、現在のロジックプラグインで処理が停止されるようにする。ビジネスメッセージは、チェーン内の次のロジックプラグインへ進まない。このオプションは、メッセージの処理をキャンセルして以後の処理を回避するために使用する。たとえば、ビジネスドキュメントを検証しているロジックプラグインは、不十分または不正なデータがあるドキュメントを拒絶することができる。
EXCEPTION_UNWIND	PlugInExcepton が送出されたら処理を後戻りさせる。ビジネスメッセージは、チェーン内の次のロジックプラグインへ進まない。このオプションを使用して、メッセージの拒絶、B2B エンジンでの以後の処理の回避、およびプラグインによるすべての変更の破棄（チェーン内で先の順番にあるプラグインによるすべての変更も含む）ができる。例外が送出された場合に、このモデルが例外処理モデルであれば、チェーンで現在よりも前にあるすべてのプラグイン（ただし現在のロジックプラグインは除く）で unwind メソッドが呼び出される。呼び出しの順番は、チェーンをさかのぼる形になる。結果的に、チェーンによるすべての変更が後戻りによってキャンセルされる。たとえば、ロジックプラグインによってデータベーステーブルに 1 行が挿入されている場合は、ロジックプラグインの unwind メソッドでその行が削除される。注意: この例外処理モデルを使用するには、チェーン内のすべてのロジックプラグインが unwind メソッドを実装している必要がある。たとえ何もしないメソッドとしてでも、このメソッドの実装が必要です。

クラス/インタフェース

説明

EXCEPTION_CONTINUE

PlugInException が送出されても、処理を停止しないようにする。処理は、チェーン内の次のロジックプラグインまで継続される。

このオプションは、ロジックプラグインの実行中にエラーが発生した場合でもビジネスメッセージの処理を継続できるようにするために使用する。

EXCEPTION_STOP

PlugInException が送出されたら、現在のロジックプラグインで処理が停止されるようにする。ビジネスメッセージは、チェーン内の次のロジックプラグインへ進まない。

このオプションは、メッセージの処理をキャンセルして以後の処理を回避するために使用する。たとえば、ビジネスドキュメントを検証しているロジックプラグインは、不十分または不正なデータがあるドキュメントを拒絶することができる。

EXCEPTION_UNWIND

PlugInExcepton が送出されたら処理を後戻りさせる。ビジネスメッセージは、チェーン内の次のロジックプラグインへ進まない。

このオプションを使用して、メッセージの拒絶、B2B エンジンでの以後の処理の回避、およびプラグインによるすべての変更の破棄（チェーン内で先の順番にあるプラグインによるすべての変更も含む）ができる。例外が送出された場合に、このモデルが例外処理モデルであれば、チェーンで現在よりも前にあるすべてのプラグイン（ただし現在のロジックプラグインは除く）で unwind メソッドが呼び出される。呼び出しの順番は、チェーンをさかのぼる形になる。結果的に、チェーンによるすべての変更が後戻りによってキャンセルされる。

たとえば、ロジックプラグインによってデータベーステーブルに 1 行が挿入されている場合は、ロジックプラグインの unwind メソッドでその行が削除される。

注意: この例外処理モデルを使用するには、チェーン内のすべてのロジックプラグインが unwind メソッドを実装している必要がある。たとえ何もしないメソッドとしてでも、このメソッドの実装が必要です。

public void process(MessageEnvelope mEnv) throws PlugInException
{

String sender, conversation;
String tRecipient;
Connection conn = null;
Statement stmt = null;
Message bMsg = null;
...
}