WebLogic Tuxedo Connector での FML の使用

この章では、フィールド操作言語 (FML) および WebLogic Tuxedo Connector が FML を使用する方法について説明します。

• FML の概要

• WebLogic Tuxedo Connector FML API

• FML フィールド テーブルの管理

• tBridge XML/FML32 変換

 

---

FML の概要

注意: FML の使い方の詳細については、『FML を使用した BEA Tuxedo アプリケーションのプログラミング』の「FML プログラミング入門」を参照してください。

FML は、フィールド バッファと呼ばれる記憶構造を定義および操作する Java 言語機能のセットです。各フィールド バッファには、フィールドに属性および値の組み合わせが含まれています。各フィールドは次のように構成されます。

• 属性はフィールドの識別子である。

• 関連する値はフィールドのデータ内容を示す。

• オカレンス番号。

FML には、2 つのタイプがあります。

• フィールド長および識別子の 16 ビット値に基づく FML16。 ユニークなフィールドは 8191 個、個々のフィールド長は 64K バイト、フィールド バッファ サイズの合計は 64K バイトに制限されています。

• フィールド長および識別子の 32 ビット値に基づく FML32。 およそ 3 千万個のフィールドが使用でき、フィールドおよびバッファの長さはおよそ 20 億バイトまで許可されています。

 

---

WebLogic Tuxedo Connector FML API

注意: WebLogic Tuxedo Connector は、FML 機能のサブセットを実装しています。たとえば、views はサポートされていません。

FML アプリケーション プログラム インタフェース (API) は、WebLogic Server クラスの Javadoc に含まれている weblogic.wtc.jatmi パッケージにドキュメント化されています。

 

---

FML フィールド テーブルの管理

フィールド テーブルは、Tuxedo フィールド テーブルに似た方法で生成されます。フィールド テーブルは、2 つのシステム間で共通のフィールド名定義、フィールド タイプ、および識別番号を提供するテキスト ファイルです。FML を使用して Tuxedo システムと相互運用するには、次の手順を実行する必要があります。

1. Tuxedo システムから WebLogic Tuxedo Connector 環境に、フィールド テーブルをコピーします。

   次に例を示す。Tuxedo 配布キットには、bankapp という銀行アプリケーション サンプルが含まれています。このアプリケーションには、次の構造を持つ bankflds というファイルがあります。

#Copyright (c) 1990 Unix System Laboratories, Inc.
#All rights reserved
#ident  "@(#) apps/bankapp/bankflds     $Revision: 1.3 $"
# Fields for database bankdb

# name                         number  type    flags   comments
ACCOUNT_ID                     110     long    -       -       
ACCT_TYPE                      112     char    -       -       
ADDRESS                        109     string  -       -       
.

.

.

2. フィールド テーブル定義を Java ソース ファイルに変換します。weblogic.wtc.jatmi パッケージの mkfldclass ユーティリティを使用します。このクラスは、FML32 フィールド テーブルを読み取るユーティリティ機能で、FldTbl インタフェースを実装する Java ファイルを生成します。このユーティリティには、次のような 2 つのインスタンスがあります。

   - mkfldclass

   - mkfldclass32

   コマンドの正しいインスタンスを使用して、bankflds フィールド テーブルを FML32 Java ソースに変換します。次は、mkfldclass を使用した例です。

   java weblogic.wtc.jatmi.mkfldclass bankflds

   作成されたファイルは bankapp.java となり、次のような構造を持ちます。

import java.io.*;
import java.lang.*;
import java.util.*;
import weblogic.wtc.jatmi.*;

public final class bankflds
        implements weblogic.wtc.jatmi.FldTbl
{
        /** number:110  type:long */
        public final static int ACCOUNT_ID = 33554542;
        /** number:112  type:char */
        public final static int ACCT_TYPE = 67108976;
        /** number:109  type:string */
        public final static int ADDRESS = 167772269;
        /** number:117  type:float */

.

.

.

3. 次のコマンドを使用して、作成した bankflds ファイルをコンパイルします。

   javac bankflds.java

   コンパイルすると、bankflds.class ファイルとなります。ロード時、WebLogic Tuxedo Connector はクラス ファイルを使用して FML32 フィールドからフィールド エントリを追加、検索、および削除します。

4. フィールド テーブルのクラス ファイルをアプリケーション CLASSPATH に追加します。

5. WTCServer MBean を更新します。

• フィールド テーブルのクラス ファイルの完全に修飾された場所を反映するため、WTCResources MBean を更新します。

• fml16 または fml32 の FML バッファ タイプを記述するために必要なキーワードを使用します。

• カンマ区切りのリストに、複数のフィールド テーブル クラスを入力できます。

例 :

<WTCResources
     FldTbl16Classes="my.bankflds,your.bankflds,more.bankflds"
     Name="BankappResources"/>

6. フィールド テーブルのクラス定義をロードするために、WebLogic Server を再起動します。

mkfldclass32 クラスに対する DynRdHdr プロパティの使用

WebLogic Tuxedo Connector には、FML テーブルを別の方法でコンパイルするためのプロパティが提供されています。 以下の場合には、DynRdHdr ユーティリティを使用する必要があります。

• 非常に大きな FML テーブルを使用しているので、mkfldclass32 クラスで作成された .java メソッドが、単一のクラスまたはインタフェースの複雑さ全体に関する内部 Java 仮想マシンの制限を越える。

• 非常に大きな FML テーブルを使用しているので、.java メソッドをコンパイルして作成されたクラスをロードできない。

FML テーブルをコンパイルするときには、次の手順で DynRdHdr プロパティを使用します。

1. フィールド テーブル定義を Java ソース ファイルに変換します。

   java -DDynRdHdr=Path_to_Your_FML_Table weblogic.wtc.jatmi.mkfldclass32 userTable

このコマンドの引数の定義は次のとおりです。

属性	説明
-DDynRdHdr	FML テーブルをコンパイルするための WebLogic Tuxedo Connector プロパティ
Path_to_Your_FML_Table	FML テーブルの絶対パスと完全修飾名
weblogic.wtc.jatmi.mkfldclass32	このクラスは、FML32 フィールド テーブルを読み取るユーティリティ機能で、FldTbl インタフェースを実装する Java ファイルを生成する。
userTable	mkfldclass32 クラスによって作成される .java メソッドの名前

2. 次のコマンドを使用して、userTable ファイルをコンパイルします。

   javac userTable.java

3. userTable.class ファイルをアプリケーション CLASSPATH に追加します。

4. userTable.class ファイルの完全に修飾された場所を反映するため、WTCResources MBean を更新します。

5. WTCServer を対象とします。 WTCServer サービスが開始されるときに、userTable.class がロードされます。

userTable.class ファイルの作成後は、userTable.class を手動で更新しなくても FML テーブルを変更してその変更をデプロイすることができます。 WTCServer の起動時に、Weblogic Tuxedo Connector は、WTCResources MBean で指定された場所に従って FML テーブルをロードします。 Path_to_Your_FML_Table 属性を変更した場合、前の手順に従って userTable.java および userTable.class ファイルを更新する必要があります。

 

---

tBridge XML/FML32 変換

注意: 指定するデータ型は、FLAT または NO にする必要があります。他のデータ型を指定すると、リダイレクションは失敗します。

WTCtBridgeRedirect MBean の TranslateFML 要素は、FML32 変換がメッセージ ペイロードで実行されることを示すために使用します。 FML32 変換には、FLAT および NO の 2 つのタイプがあります。

FLAT

メッセージ ペイロードは、WebLogic Tuxedo Connector の内部 FML32/XML トランスレータを使用して変換されます。フィールドは、メッセージ構造 (階層構造) を意識せず、グループ化を反復せずに、フィールドごとの値に変換されます。

FML32 バッファを XML に変換するため、tBridge は FML32 バッファにある各フィールドの各インスタンスを抽出して文字列に変換し、それをフィールド名で構成されるタグ内に配置します。これらすべてのフィールドは、サービス名で構成されるタグ内に配置されます。たとえば、次のフィールドで構成される FML32 バッファがあるとします。

NAME          JOE
ADDRESS       CENTRAL CITY
PRODUCTNAME   BOLT
PRICE         1.95
PRODUCTNAME   SCREW
PRICE         2.50

変換された XML バッファは次のようになります。

<FML32>
  <NAME>JOE</NAME>
  <ADDRESS>CENTRAL CITY</ADDRESS>
  <PRODUCTNAME>BOLT</PRODUCTNAME>
  <PRODUCTNAME>SCREW</PRODUCTNAME>
  <PRICE>1.95</PRICE>
  <PRICE>2.50</PRICE>
</FML32>

NO

変換は使用されません。tBridge は、リダイレクションの方向に応じて、JMS TextMessage を Tuxedo TypedBuffer (TypedString) に (またはその逆に) マップします。JMS BytesMessage は、Tuxedo TypedBuffer (TypedCarray) に (またはその逆に) マップされます。

FML32 の考慮事項

FML32 を使用する場合は、以下の情報について考慮する必要があります。

• XML 入力では、ルート要素が必要ですが無視されます。

• XML 出力では、ルート要素は常に <FML32> です。

• フィールド テーブル名は、FML フィールド テーブルの管理で説明されているようにロードする必要があります。

• tBridge トランスレータは、「flat」またはリニアなグループ化でのみ有効です。これは FML32 順を記述する情報が管理されないために、繰り返しデータを含むバッファが予期しない形式で示される場合があります。たとえば、部品とそれに関連付けられた価格のリストを含む FML32 バッファがあると仮定します。ここでは PART A、PRICE A、PART B、PRICE B などが予想されますが、tBridge 内に構造的なグループ情報がないため、変換された XML は PART A、PART B など、PRICE A、PRICE B などになります。

• XML を FML32 に変換する場合、トランスレータは空白値を無視します。たとえば、<STRING></STRING> は、結果的に FML32 バッファではスキップされます。

• 組み込み FML は、このリリースではサポートされません。

• FML から XML への変換では、TypedCArray はサポートされません。以下のサポートされているフィールド型から選択してください。

  • SHORT

  • LONG

  • CHAR

  • FLOAT

  • DOUBLE

  • STRING

  • INT (FML32)

  • DECIMAL (FML32)

• FML 内に TypedCArray が存在する場合、TypedString にエンコードし、XML を TypedCArray にデコードします。

• バイナリ データを渡す必要がある場合、選択したフィールド型へのコード化を行い、受け取り側で XML をデコードします。