1. プログラミング・ガイド
  2. データ型のマッピングとメッセージ変換
  3. RESTデータ・マッピング
  4. 着信メッセージ変換
  5. XMLデータ・マッピング

2.5.1.3 XMLデータ・マッピング

XMLデータ・マッピングは、SOAPモードで使用されるマッピングと類似のルールを使用して実行されます。

次の点が異なります:

  • 小数の値がない浮動小数点数は、整数として表現されます。たとえば、10.0は10と出力されます。これは現時点での制約です。
  • RESTモードにはインタフェースがないため、ネームスペースは生成または処理されません。
  • シンプル・バッファ(STRING、CARRAY、MBSTRING、XML)は、XML処理なしにそのまま送受信されます。動作はJSON処理と同じです(つまり、マッピングは必要ありません)。
  • FMLおよびFML32のリクエストは、ルート要素でラップする必要があります(ルート要素の名前は、XMLが適切な形式であれば無視されます)。また、応答は、SALTDEPLOY構成ファイルのREST/Service/Method/@inputbuffer属性で指定されているサブタイプと同じ名前の要素でラップします。また、サブタイプが構成されていない場合はその要素が存在しないこともあるため、<root>要素でラップします。VIEW、VIEW32、X_COMMONおよびX_C_TYPEバッファはサブタイプ名をルート要素名として使用します。

次の表に、様々なOracle Tuxedoバッファ・タイプとXMLとの変換を示します:

表2-14 XMLデータ・マッピング

Tuxedoのバッファ・タイプ 説明 REST XMLマッピングの例
STRING Oracle Tuxedo STRING型付きバッファは、NULL文字で終わる文字列の格納に使用します。Oracle Tuxedo STRING型付きバッファは自己記述型バッファです。 HELLO WORLD!
CARRAY Oracle Tuxedo CARRAY型付きバッファには文字配列が格納されます(配列内には任意の位置にNULLを含んでよい)。CARRAYバッファはデータをオペークなものとして扱うバッファで、自己記述型ではありません。 バイナリ・コンテンツ
MBSTRING Oracle Tuxedo MBSTRING型付きバッファは、マルチバイト文字配列に使用します。Oracle Tuxedo MBSTRINGバッファは次の3つの要素により構成されます。
  • コードセット文字エンコーディング
  • データ長
  • エンコーディングの文字配列。

UTF-8以外のエンコーディングを転送するには、SALTDEPLOY構成のenableMultiEncodingプロパティをtrueに設定する必要があります。

Content-Type設定に基づいてエンコードされたマルチバイト文字列。
XML Oracle Tuxedo XML型付きバッファにはXMLドキュメントが格納されます。

GWWSサーバーでは、実際のXMLデータが整形式であることが検証されます。それ以外の事項(スキーマ検証など)の適用については確認されない。

ペイロードには、単一ルートのXMLバッファのみを格納できます。この点はGWWSサーバーによりチェックされます。

元のXMLドキュメントに含まれるプロローグ情報は、ペイロードに含めて伝送することはできません。

UTF-8以外のエンコーディングを転送するには、SALTDEPLOY構成のenableMultiEncodingプロパティをtrueに設定する必要があります。

XMLフラグメントはそのままです
X_C_TYPE VIEW/VIEW32と同じ -
X_COMMON VIEW/VIEW32と同じ -
X_OCTET CARRAYと同じ -
VIEW/VIEW32 Oracle Tuxedo VIEWおよびVIEW32型付きバッファには、Oracle Tuxedoアプリケーションで定義されたC構造が格納されます。

VIEW構造は、VIEW定義ファイルを使用して定義されます。VIEWバッファ・タイプは複数のフィールドを定義できます。

VIEWでは次のフィールド型がサポートされています:

  • short
  • int
  • long
  • float
  • double
  • char
  • string
  • carray (base64でエンコードされたコンテンツとして表現)
  • bool
  • unsigned char
  • signed char
  • wchar_t* or wchar_t
  • unsigned int
  • unsigned long
  • long long
  • unsigned long long
  • long double

VIEW32では、すべてのVIEWフィールド型、mbstringおよび埋込みVIEW32型がサポートされています。

サブ要素の名前はVIEWフィールド名と同じです。サブ要素の出現回数は、VIEWフィールド定義のcount属性によって異なります。サブ要素の値は、XMLスキーマの型に対応するVIEWフィールド・データ型である必要があります。 

<VIEW>
<viewfieldname>
fieldcontent
</viewfieldname>
</VIEW>
<VIEW>

<viewfieldname>

fieldcontent

</viewfieldname>

</VIEW>

FML/FML32 Oracle Tuxedo FMLおよびFML32型バッファは、Oracle Tuxedoシステムに特有の自己記述型バッファです。各データ・フィールドは独自の識別子、オカレンス番号、および可能であれば長さインジケータを保持します。

FMLでは次のフィールド型がサポートされています:

  • FLD_CHAR
  • FLD_SHORT
  • FLD_LONG
  • FLD_FLOAT
  • FLD_DOUBLE
  • FLD_STRING
  • FLD_CARRAY (base64エンコードされたコンテンツとして)
  • FML32では、すべてのFMLフィールド型とFLD_PTR、FLD_MBSTRING、FLD_FML32、FLD_VIEW32がサポートされています。
ネストFLD_VIEW32: ビュー・サブタイプの名前は組込みVIEW32の名前である必要があります。例: 
VIEW32 example.v definition file:
VIEW v32example
char flag1 - 1 ---
string str - 1 - 100
XML content (EVIEW32 is a FLD_VIEW32 fml32 type):
<EVIEW32>
<v32example>
<flag1>x</flag1>
<str>somestring</str>
</v32example>
</EVIEW32>
RECORD RECORDバッファ・タイプは、コピーブック・レコードを表します。RECORD型には、個々のレコード構造体を示すサブタイプが必要です。

生成されるCOBOL型:

  • RECORD
  • COMP-1
  • COMP-2
  • S9(18)
  • 9(18)
  • S9(9)
  • 9(9)
  • S9(4)
  • S9(10)V9(10)
  • X(1024)
  • @binary=true 
<myRecord>
  <name>aaa</name>
  <num>1000</num>
  <subgroup>
    <long1> 3000 </long1>
    <string1> www </string1>
  </subgroup>
</myRecord>

ノート:

非構造化バッファ・タイプ(STRING、CARRAY、X_OCTET、MBSTRING)はデータをXMLオブジェクトとしてラップしません。データはそのまま転送されます。

親トピック: 着信メッセージ変換