5.5. JSON スキーマドキュメント

XML スキーマドキュメントが DataMapper ドキュメントツリーにレンダリングされると、その要素名と属性名だけがフィールドラベルとして表示されます。JSON スキーマドキュメントの場合は若干異なります。JSON ドキュメントフィールドには名前がない場合 (匿名) もあるため、フィールドタイプを主なフィールドラベルとして使用します。

さらに、フィールドに名前がある場合は、フィールドタイプの後に @key 属性として表示されます。たとえば、AccountId という名前の string 型フィールドには、フィールドラベル string [@key = AccountId] が表示されます。

匿名オブジェクトフィールドには map だけが表示されます。

array 型フィールドの場合、注意が必要な点が 1 つあります。array 型フィールドは、その 子 がコレクション、つまり繰り返しフィールドであることを示しますが、array 型フィールド自体は示しません。たとえば、Item という名前の array 型フィールドは、DataMapper UI では次のように表示されます。

この場合、array 型フィールド Item の直接の子である map 型フィールドはコレクションフィールドです。レイヤーアイコン:

map フィールドがコレクションフィールドであることを示します。これは for-each マッピングを作成するときに重要です。for-each マッピングを作成する方法は このマニュアルの後半 で詳しく説明します。

以下は、Kaoto DataMapper UI で作成された JSON データマッピングの例です。Account および Cart 構造化 JSON パラメーターと orderSequence プリミティブパラメーターを消費し、ShipOrder JSON ターゲットボディーを作成します。

XPath 式では、パラメーター Account を参照するために、単なる $Account ではなく、接尾辞 -x が付いた $Account-x が使用されています。Account パラメーターは構造化された JSON であるため、内部的に json-to-xml を使用して XML に変換されます。$Account-x は、JSON から変換された XML ドキュメントを格納する変数です。

これらの JSON 固有の特性を考慮すると、マッピングを作成する残りの方法は XML と JSON で同じです。Kaoto DataMapper を使用すると、XML から XML、XML から JSON、JSON から XML、JSON から JSON へのマッピングを作成できます。次のセクションでは、このようなマッピングについて見ていきます。