| Oracle® Fusion Middleware Oracle WebLogic Server WebLogic Tuxedo Connectorプログラマーズ・ガイド 11g リリース1 (10.3.6) B61627-03 |
|
 前 |
 次 |
| Oracle® Fusion Middleware Oracle WebLogic Server WebLogic Tuxedo Connectorプログラマーズ・ガイド 11g リリース1 (10.3.6) B61627-03 |
|
前 |
次 |
以下の節では、Oracle WebLogic Tuxedo Connector VIEWバッファの使い方について説明します。
|
注意: Oracle Tuxedo VIEWバッファの詳細は、http://download.oracle.com/docs/cd/E13203_01/tuxedo/tux100/pgc/pgbuf.htmlで『C言語を使用したTuxedo ATMIアプリケーションのプログラミング』の「VIEW型バッファ」を参照してください。 |
Oracle WebLogic Tuxedo Connectorを使用すると、非依存型C構造体から派生したOracle Tuxedo VIEWバッファ・タイプと同様のJava VIEWバッファを作成することができます。これにより、Oracle WebLogic ServerアプリケーションおよびOracle Tuxedoアプリケーションが共通の構造体を用いて情報を受け渡しできます。Oracle WebLogic Tuxedo Connector VIEWバッファは、FML VIEWもFML VIEW/Java会話もサポートしていません。
|
注意: fbnameフィールドとnullフィールドは、非依存型Java構造体やC構造体とは関係がなく、JavaやCのVIEWコンパイラには無視されます。これらのフィールドにはプレースホルダーとして値(たとえば、ダッシュ)を入れる必要があります。 |
Oracle WebLogic ServerアプリケーションとOracle Tuxedoアプリケーションは、VIEW記述で定義された同一の情報構造を共有する必要があります。VIEW記述ファイルの各構造体には下記の形式を使用します。
$ /* VIEW structure */ VIEW viewname type cname fbname count flag size null
説明:
ファイル名はVIEW名と同一です。
ファイルごとに1つのVIEWしか持てません。
Oracle WebLogic Tuxedo Connector viewjコンパイラとOracle Tuxedo viewcコンパイラの両方で同一のVIEW記述ファイルが使用されます。
viewnameは情報構造の名前です。
コメント行は、「#」または「$」文字で始めます。
各構造体用のVIEW記述ファイルに指定しなければならないフィールドを下表で説明します。
表8-1 VIEW記述ファイルのフィールド
| フィールド | 説明 |
|---|---|
type
|
フィールドのデータ型。設定できる型は、 |
cname
|
情報構造内でのフィールド名。 |
fbname
|
無視されます。 |
count |
フィールドの反復回数。 |
flag |
次のいずれかのオプション・フラグを指定します。
|
size |
|
null |
ユーザー指定のNULL値、または、マイナース記号( デフォルトのNULL値は、数値型の場合はすべて0 (dec_tでは0.0)。文字型の場合は、` 規約により、エスケープ文字として使用される定数にも、NULL値を指定できます。VIEWコンパイラが認識するエスケープ定数は次のとおりです: \ddd (dは8進数)、\0、\n、\t、\v、\r、\f、\\、\'、および\"。 STRING、CARRAY、およびchar型のNULL値を、二重引用符または単一引用符で囲んでもかまいません。ユーザー指定のNULL値内のエスケープされていない引用符は、VIEWコンパイラでは受け付けられません。 VIEWメンバー記述のNULLフィールドでキーワード「NONE」を指定することもできます。この指定は、そのメンバーにはNULL値がないことを意味します。文字列および文字配列メンバーの最大サイズのデフォルト値は2660文字です。 |
VIEW型バッファをコンパイルするには、引数としてパッケージ名とVIEW記述ファイルの名前を指定して、viewjコマンドを実行します。出力ファイルはカレント・ディレクトリに作成されます。
viewjコンパイラを使用するには、次のコマンドを入力します。
java weblogic.wtc.jatmi.viewj [options] [package] viewfile
viewj32コンパイラを使用するには、次のコマンドを入力します。
java weblogic.wtc.jatmi.viewj32 [options] [package] viewfile
このコマンドの引数の定義は次のとおりです。
| 引数 | 説明 |
|---|---|
| options |
注意: |
package |
.javaソース・ファイルに含まれるパッケージ名。
例: examples.wtc.atmi.simpview |
viewfile |
VIEW記述ファイルの名前。
例: |
例:
VIEWバッファは次のようにしてコンパイルします。
java weblogic.wtc.jatmi.viewj -compat_names examples.wtc.atmi.simpview infoenc
VIEW32バッファは次のようにしてコンパイルします。
java weblogic.wtc.jatmi.viewj32 -compat_names -modify_strings examples.wtc.atmi.simpview infoenc
viewjおよびviewj32コマンドの出力は、VIEW記述ファイルの各フィールドに対するsetおよびgetアクセサ・メソッドが含まれた.javaソース・ファイルになります。VIEWバッファとの間で情報を受け渡すには、Javaアプリケーションでこれらのsetおよびgetアクセサ・メソッドを使用します。
VIEW記述ファイルで関連する長さと数のフィールドが指定されている場合、その値をsetおよびgetアクセサ・メソッドで使用するかどうかを指定するには、AssociatedFieldHandlingフラグを使用します。
setメソッドは、配列フィールドの数を設定し、文字列またはcarrayフィールドの長さを設定します。
配列に対するgetメソッドは、関連する数のフィールド以下のサイズを持つ配列を返します。
文字列とcarrayに対するgetメソッドは、関連する長さのフィールド以下の長さを持つデータを返します。
AssociatedFieldHandlingフラグの状態を設定または取得するには、次のいずれかの方法を使用します。
viewjおよびviewj32コンパイラの-associated_fieldsオプションを使用して、AssociatedFieldHandlingフラグをtrueに設定します。
Javaアプリケーションでvoid setAssociatedFieldHandling(boolean state)メソッドを呼び出して、AssociatedFieldHandlingフラグの状態を設定します。
falseの場合、setおよびgetメソッドは長さと数のフィールドを無視します。
trueの場合、VIEW記述ファイルで関連する長さと数のフィールドが指定されている場合は、その値をsetおよびgetアクセサ・メソッドで使用します。
デフォルトの状態はfalseです。
Javaアプリケーションでboolean getAssociatedFieldHandling()メソッドを呼び出して、AssociatedFieldHandlingの現在の状態を返します。
JATMIアプリケーションにVIEWバッファを取り込む際には、次の手順に従います。
「VIEW記述ファイルの作成方法」で説明されているとおりに、アプリケーション用のVIEW記述ファイルを作成します。
「viewjコンパイラの使用方法」で説明されているとおりに、VIEW記述ファイルをコンパイルします。
「VIEWバッファとの情報の受け渡し方法」で説明されているとおりに、setおよびgetアクセサ・メソッドを使用して、VIEWバッファに情報を渡したり、VIEWバッファから情報を受け取ったりします。
クライアントでアクセサを使用してVIEWバッファと情報を受け渡す方法の例については、Oracle WebLogic Server配布キットのexamples/wtc/atmi/simpview/ViewClient.javaファイルを参照してください。
VIEWコンパイラの出力ファイルをソース・コードにインポートします。
必要な場合は、http://download.oracle.com/docs/cd/E13203_01/tuxedo/tux100/pgc/pgbuf.htmlにある『C言語を使用したTuxedo ATMIアプリケーションのプログラミング』の「VIEW型バッファ」で説明されているとおりに、Oracle Tuxedoアプリケーション用のVIEW記述ファイルをコンパイルし、その出力をCソース・ファイルにインクルードします。
コンパイル済みJava VIEW記述ファイルの完全修飾クラス名とVIEWバッファ・タイプ(VIEWまたはVIEW32)を指定したResources MBeanでWTCServer MBeanを構成します。コンパイル済みJava VIEW記述ファイルのクラスをCLASSPATHに指定する必要があります。
Oracle Tuxedoアプリケーションをビルドし、起動します。
Oracle WebLogic Serverアプリケーションをビルドし、起動します。
ヘルパー・クラスを使用して、FML32バッファに対してVIEW32データを追加および取得できます。クラス名はwtc.jatmi.FViewFldです。このクラスを使用することで、プログラマはFML32バッファに対してVIEW32フィールド・タイプを使用するJATMIベースのアプリケーションを簡単に開発できます。
構成の変更は不要です。引き続き、WLS構成ファイルのWTCResourcesセクションにあるViewTbl32Classes属性を使用して、VIEW32クラス・パスを構成します。
このヘルパー・クラスでは、以下のアクセス・メソッドを使用できます。
FViewFld(String vname, TypedView32 vdata);
FviewFld(FviewFld to_b_clone);
void setViewName(String vname)
String getViewName();
void setViewData(TypedView32 vdata)
void TypedView32 getViewData();
例8-2 TypedFML32バッファに対して埋め込みTypedView32バッファを追加および取得する方法
String toConvert = new String("hello world");
TypedFML32 MyData = new TypedFML32(new MyFieldTable());
Long d1 = new Long(1234);
Float d2 = new Float(12.32);
MyView data = new myView();
FviewFld vfld;
data.setamount((float)100.96);
data.setstatus((short)3);
vfld = new FviewFld("myView", data);
try {
myData.Fchg(MyFieldTable.FLD0, 0, toConvert);
myData.Fchg(MyFieldTable.FLD1, 0, 1234);
myData.Fchg(MyFieldTable.FLD2, 0, d2);
myData.Fchg(MyFieldTable.myview, 0, vfld);
} catch (Ferror fe) {
log("An error occurred putting data into the FML32 buffer. The error is " + fe);
}
try {
myRtn = myTux.tpcall("FMLVIEW", myData, 0);
} catch(TPReplyException tre) {
….
}
TypedFML32 myDataBack = (TypedFML32)myRtn.getReplyBuffer();
Integer myNewLong;
Float myNewFloat;
myView View;
String myNewString;
try {
myNewString = (String)myDataBack.Fget(MyFieldTable.FLD0, 0);
myNewLong = (Integer)myDataBack.Fget(MyFieldTable.FLD1, 0);
myNewFloat = (Float)myDataBack.Fget(MyFieldTable.FLD2, 0);
vfld = (FviewFld)myDataBack.Fget(MyFieldTable.myview, 0);
view = (myView)vfld.getViewData();
} catch (Ferror fe) {
….
}
次のコード・リストは、例8-2のサンプルに関連するFML記述(MyFieldTable)の例です。
*base 20000 #name number type flags comments FLD0 10 string - - FLD1 20 long - - FLD2 30 float - - myview 50 view32 - defined in View description file
XmlViewCnvクラスを使用すると、XMLからView/View(32)への変換、およびView/View(32)からXMLへの変換を実行できます。次のコードは、XMLバッファ・フォーマットとの間での変換にXmlViewCnvクラスを使用する例です。
import examples.wtc.atmi.simpview.infoenc; // View class import
weblogic.wtc.gwt.XmlViewCnv;
import weblogic.wtc.jatmi.TypedBuffer;
public class xml2view
{
public static void main(String[] args) {
String xmlDoc =
"<VIEW32><infoenc><amount>1000.0</amount><infoenc></VIEW32>";
infoenc convertMe = new infoenc();
convertMe = (infoenc) XmlViewCnv.XMLToView(
xmlDoc,
convertMe.getClass(),
convertMe.getSubtype());
convertMe = (infoenc) echo.Echo(convertMe);
result = XmlViewCnv.ViewToXML(
(TypedBuffer) convertMe,
convertMe.getClass(),
true);
System.out.println(result);
}
}
