WebLogic Tuxedo Connector での FML の使用



\| WebLogic Server ホーム \| WTC 管理ガイド \| 前へ \| 次へ \| 目次 \| 索引 \| PDF 版

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

FML の概要

注意: FML の使い方の詳細については、『Programming a Application Using FML』を参照してください。

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

属性はフィールドの識別子です。
関連する値はフィールドのデータ内容を示します。
オカレンス番号。

2 種類の FML があります。

FML16。フィールドの長さと識別子は 16 ビットの値で表されます。ユニークなフィールドの数は 8191、個々のフィールドの長さは 64K バイト、フィールド化されるバッファの全体のサイズは 64K バイトにそれぞれ制限されます。
FML32。フィールドの長さと識別子は 32 ビットの値で表されます。フィールドの数は約 3000 万で、フィールドとバッファ長は約 20 億バイトです。

WebLogic Tuxedo Connector FML API

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

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

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

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

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 - - .

.

フィールドテーブル定義を Java ソースファイルに変換します。weblogic.wtc.jatmi パッケージの mkfldclass ユーティリティを使用します。このクラスは、FML32 フィールドテーブルを読み取るユーティリティ機能で、FldTbl インタフェースを実装する Java ファイルを生成します。このユーティリティには、次のような 2 つのインスタンスがあります。
1. mkfldclass
2. mkfldclass32
  コマンドの正しいインスタンスを使用して、bankflds フィールドテーブルを FML32 Java ソースに変換します。次は、mkfldclass を使用した例です。
  
  java weblogic.wtc.jatmi.mkfldclass bankflds
  
  作成されるファイルの名前は bankflds.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 */
```
```
.
```
```
.
```
```
.
```
次のコマンドを使用して、作成した bankflds.java ファイルをコンパイルします。
javac bankflds.java

コンパイルすると、 bankflds.class ファイルとなります。ロード時、WebLogic Tuxedo Connector はクラスファイルを使用して FML32 フィールドからフィールドエントリを追加、検索、および削除します。
フィールドテーブルのクラスファイルをアプリケーション CLASSPATH に追加します。
WebLogic Tuxedo Connector XML コンフィグレーションファイルを更新します。
- フィールドテーブルのクラスファイルの完全に修飾された場所を反映するため、T_DM_RESOURCES セクションを更新します。
- fml16 または fml32 の FML バッファタイプを記述するために必要なキーワードを使用します。
- 追加のフィールドテーブルを指定するために、複数の <FldTblClass> 行を入力できます。
  例 :
```
        <T_DM_RESOURCES>
                <FieldTables>
                <FldTblClass Type="fml32">com.bea.mystuff.bankflds</FldTblClass>
                </FieldTables>
        </T_DM_RESOURCES>
```
フィールドテーブルのクラス定義をロードするために、WebLogic Server を再起動します。

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

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

非常に大きな FML テーブルを使用していて、mkfldclass32 クラスによって作成される .java メソッドが、単一のクラスまたはインタフェースの全体的な複雑さに対する Java 仮想マシンの内部的な限界を超える場合。
非常に大きな FML テーブルを使用していて、.java メソッドのコンパイル時に作成されるクラスをロードできない場合。

DynRdHdr プロパティを使って FML テーブルをコンパイルするときは、以下の手順で行います。

フィールドテーブルの定義を、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 メソッドの名前。

引数	説明
`-DDynRdHdr`	FML テーブルのコンパイルに使用する WebLogic Tuxedo Connector のプロパティ。
`Path_to_Your_FML_Table`	FML テーブルの完全修飾パスとファイル名。
`weblogic.wtc.jatmi.mkfldclass32`	FML32 フィールドテーブルを読み取って `FldTbl` インタフェースを実装する Java ファイルを生成するユーティリティ関数のクラス。
`userTable`	mkfldclass32 クラスによって作成される `.java` メソッドの名前。

次のコマンドを使って userTable ファイルをコンパイルします。
```
javac userTable.java 
```
アプリケーション CLASSPATH に userTable.class ファイルを追加します。
WebLogic Tuxedo Connector の XML コンフィグレーションファイルの T_DM_RESOURCES セクションを変更し、userTable.class ファイルの完全修飾された場所を指定します。
サーバを起動します。サーバは、起動すると、WebLogic Tuxedo Connector の XML コンフィグレーションファイルの T_DM_RESOURCES セクションで指定されている場所を使って、FML テーブルをロードします。

いったん userTable.class ファイルを作成した後は、FML テーブルを変更してデプロイする際に、userTable.class を手作業で更新する必要はありません。サーバは、起動時に、WebLogic Tuxedo Connector の XML コンフィグレーションファイルの T_DM_RESOURCES で指定されている場所を使って、更新された FML テーブルをロードします。ただし、Path_to_Your_FML_Table 属性を変更する場合は、前記の手順を使って、userTable.java ファイルと userTable.class ファイルを更新する必要があります。

tBridge XML/FML32 変換

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

<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 をデコードします。