Oracle WLIファイル・コントロールとOracle File Adapterの比較

Daniel Amadei、Heidi Buelow著

Oracle WLIユーザーのためのOracle SOA Suite基礎講座シリーズの今回の記事では、Oracle WebLogic Integration（Oracle WLI）のファイル・コントロール機能とOracle BPEL Process Manager（Oracle BPEL PM）の対応する機能を比較します。

2009年5月公開

関連するダウンロード・リンク Oracle SOA Suite

この記事は次のように構成されています。

• はじめに
• Oracle WLIファイル・コントロール
• Oracle File Adapter
• ユースケースの例
• Oracle BPEL Process Managerでのユースケースの実装
• Oracle BPELでのXMLの受信、CSV形式への変換、FTPを使用したファイルの書込み
• 主要なポイントと推 奨事項

[1ページ] [ 2ページ] [ 3ページ] [ 4ページ]

はじめに

理論的な説明のあと実習に移ります。実習では、両ツールを使用して3つのユースケースを実装します。 Oracle BPEL PMについて詳しくは、『 Oracle BPEL Process Manager』を参照してください。

Oracle WLIファイル・コントロール

ファイル・コントロールをプロセスへ追加したときに生成されるインタフェースは、 com.bea.control.FileControlか ら以下のメソッドを継承します（以下に示すのはその一部です。継承されるすべてのメソッドについては、 Oracle WLIのドキュメントと対応する javadocを 参照してください）。

• copy(String fileName)： 現在のファイルを指定されたファイル名にコピーします。
  
  
• delete()： 現在のファイルを削除します。
  
  
• rename(String fileName)： 現在のファイルの名前を指定されたファイル名に変更します。
  
  
• FileControlFileListDocument getFiles()： 指定したファイル・マスクに一致する、現行ディレクトリ内のFileオブジェクトのイテレータを返します。
  
  
• FileControlPropertiesDocument getProperties()： コントロールの動的プロパティを取得します。
  
  
• setProperties(FileControlPropertiesDocument xmlProp)： コントロールの動的プロパティを設定します。

最後の2つのメソッドでは、プロパティという概念を使用しています。 これらのプロパティはXMLBeansクラスのインスタンスであり、Oracle WLIに含まれているXSDから生成されます。 プロパティ・クラスを使用すると、コントロールの動作を実行時にカスタマイズできます。 たとえば、プロセスのインスタンス変数の値に基づいて、ファイルを格納するディレクトリを変更することができます。 コントロールの作成時に与えるカスタマイズ用パラメータ（とくにデータ型）に基づいて、以下のメソッドが作成され、Javaインタフェースに追加されま す。

• FileControlPropertiesDocument write(<Type of data>)： 選択したデータ型に基づいて、ファイルにコンテンツを書き込みます。
  
  
• <Type of data> read()： データ型に基づいて、ファイルからコンテンツを読み取ります。
  
  
• append(<Type of data>)： ファイルにコンテンツを追加します。データ型がXMLである場合は使用できません。

ここまでで説明した内容により、ファイル・コントロールを使用することで次のことが簡単になります。

1. ファイルに対するデータの書込み、読取り、追加
2. ファイルの操作：コピー、名前の変更、削除
3. ディレクトリの内容の一覧表示

ファイルに対して読取りおよび書込み可能なデータ型は次のとおりです。

• RawData（バイナリ）
• 文字列
• XML（XMLの読取りおよび書込みを実行することによって、ファイル・コントロールは、XML Beansバインディング・フレームワークを使用して、XMLコンテンツとJavaオブジェクト間の変換をおこないます）

ファイルとディレクトリには、次のようにしてアクセスできます。

• WindowsおよびUnixシステムではローカルにアクセス
• ネットワークを介す場合は、FTP、SFTP、またはUNC形式でアクセス

Oracle File Adapter

詳しくは、『 Oracle File Adapter ユーザーズ・ガイド』を参照してください。

ユースケースの例

これらのユースケースを実装するために必要なサンプル・ファイルとして、 CompareWLI_BPEL.zip（スキーマ、入力データなど）が 必要になります。 この記事では、全体をとおして、このサンプル・ファイル・フォルダを参照します。 このzipファイルには、以下の手順に従って作成されたプロジェクト・ファイルも含まれています。

Oracle WLIでユースケースを実装する

Oracle WLIを使用してファイルからプレーン文字列を読み取る

プロセス・アプリケーションを作成する

この記事に含まれるWLIサンプルを実行するには、まず、プロセス・アプリケーションを作成し、WLIドメインに配置する必要がありま す。 ドメインの作成手順については、『 ド メイン コンフィグレーション ウィザードの使用』を参照してください。

プロセス・アプリケーションを作成するには、以下の手順を実行します。

1. Oracle Workshop for WebLogicを 開きます。
2. Package Explorerの余白部分を右クリッ クして、「 New 」→「 Project 」を選択します。
3. New Projectウィンドウで、「 WebLogic Integration 」を開いて「 Process Application 」を選択します。
4. 「 Next 」をクリックします。
5. 次の値を入力します。
   • EAR Project Name： FCTLApp
   • Web Project Name： FCTLAppWeb
   • Utility Project Name： FCTLAppUtil
   • 「 Add Weblogic Integration System and Control Schemas to Utility Project 」チェック・ボックスをオンにしま す。
6. 「 Finish 」をクリックします。

ファイルのコンテンツを文字列として読み取る

最初に、ファイルのコンテンツを文字列として読み取り、そのまま標準出力に書き出します。

かならず プロセスの視点で作業してください。 「 FCTLAppWeb 」→「 src 」の順に開いて、「 process」パッケージを右ク リックします。 下図のように、「 New 」→「 Process 」を選択します。

白い四角形をダブルクリックして、先ほど作成したプロセスの開 始イベントを選択します。 次の画面が表示されます。 「 Invoked synchronously via a Client Request with Return 」を選択し、「 Close 」をクリックします。 これにより、プロセスは同期的に実行されるようになり、プロセスのコンシューマに強制的に情報が返されます。

プロセス・フローが更新されます。 新規グループを右クリックして、「 Open Return Builder 」を選択します。 次の画面が表示されます。 「 Select... 」ボタンをクリックします。

これで、プロセスの戻り値の設定を構成できるようになります。 Parameter NameにfileContentと入力します。これが、このプロセスの出力パラメータ名になります。 Type Nameで、 Stringを 返すように選択します。 「 Browse 」をクリックして自分で Stringクラスを見つけるか、「 Simple tab 」をク リックして、リストの最後にある「 String 」を選択します。 「 OK」をクリックすると、「 Send Data 」 をクリックできるようになります。このタブで、先ほど作成した fileContentパ ラメータとして送信する内容をOracle WLIに通知します。

Select variables to assignフィー ルドで、下図のように「 Create new variable... 」 を選択します。 これにより、この変数に格納された値がこのプロセスのコンシューマに対する応答として送信されるため、実行中にこの変数に何らかの値を格納しておく必要が あります。 この変数に値を格納する方法については、あとで説明します。

変数にfileContentという名前をつけ、「 OK 」 をクリックします。 「 Close 」ボタンをクリックします。 " Client Request with Return"グループの右上隅に緑のチェック・ ボックスが表示されます。これは、このグループが構成済みでありエラーもないことを示しています。

（WorkSpace画面の右下にある） Data Palette上 で矢印をクリックし、「 Integration Controls 」 →「 File 」を選択します（下図）。

" Insert Control: File"画面が表示され ます。 Field NameはfileControlのま まにします （これはコントロール・インスタンスを表すjavaファイル内のプロパティの名前になります）。 「 Next 」をクリックします。

Javaクラス名を入力するよう求められます。 この名前が、コントロールのJavaインタフェースの名前になります。 StringReaderFileControlと いう名前を入力して、「 Next 」をクリックします。

コントロールによってアクセスされるファイルに関する情報を指定するための画面が表示されます。 次のようにデータを入力して、「 Finish 」をクリックします。

定義したコントロールは、 Data Paletteの Controlsセクション内で使用可能になります。 fileControl要素が表示されており、開くと次のようになります。 リストからメソッドを選択し、プロセス内の実行場所にドラッグ・アンド・ドロップします。

リストから「 String read() 」メ ソッドを選択し、" Client request with return"グ ループ内に配置します（下図）。

readノードの右上にグレーのチェック・ボックスが表示されます。 前述のとおり、これは、そのノードの構成がまだ完了していないことを示すものです。readノードをダブルクリックします。

画面が表示されたら、「 Receive Data 」 を選択し、" Select variables to assign"で、ドロッ プダウン・リストから「 fileContent 」変数を選択しま す。 プロセスの横に緑のチェック・ボックスが表示されます。 「 Close 」 をクリックすると、プロセスは次のようになります（下図）。