269.5. RFC のメッセージボディー

SAP エンドポイントは、SAP リクエストオブジェクトを含むメッセージボディーを持つメッセージを受信し、SAP 応答オブジェクトが含まれるメッセージのボディーが含まれるメッセージを返します。SAP リクエストと応答は、名前付きフィールドを含む名前付きフィールドを含むデータ構造を、事前定義したデータタイプを持つ固定です。

SAP リクエストと応答の名前付きフィールドは SAP エンドポイントに固有のもので、SAP リクエストのパラメーターを定義するエンドポイントごとに、受け入れる応答があります。SAP エンドポイントは、それに固有のリクエストおよび応答オブジェクトを作成するためのファクトリーメソッドを提供します。

public class SAPEndpoint ... {
    ...
    public Structure getRequest() throws Exception;

    public Structure getResponse() throws Exception;
    ...
}

SAP リクエストおよび応答オブジェクトはいずれも、org.fusesource.camel.component.sap.model.rfc.Structure インターフェースをサポートする構造オブジェクトとして Java で表されます。このインターフェースは、java.util.Map インターフェースと org.eclipse.emf.ecore.EObject インターフェースの両方を拡張します。

public interface Structure extends org.eclipse.emf.ecore.EObject,
                                        java.util.Map<String, Object> {

    <T> T get(Object key, Class<T> type);

}

構造オブジェクトのフィールド値は、マップインターフェースのフィールドの getter メソッドを介してアクセスされます。さらに、構造インターフェースは、フィールド値を取得するタイプ制限方法を提供します。

構造オブジェクトは、Eclipse Modeling Framework(EMF)を使用してコンポーネントランタイムに実装され、そのフレームワークの EObject インターフェースをサポートします。構造オブジェクトのインスタンスには、提供されるフィールドのマップの構造と内容を定義して制限する meta-data がアタッチされています。このメタデータには、EMF が提供する標準メソッドを使用してアクセスし、イントロスペクションすることができます。詳細は、EMF ドキュメントを参照してください。

以下のセクションで説明されているように、構造オブジェクトには、複雑なフィールドタイプの値（ STRUCTURE および TABLE ）が含まれるフィールドを含めることができます。これらのタイプのインスタンスを作成して構造に追加する必要はないことに注意してください。エンクロージング構造でアクセスする際に必要に応じて、このフィールド値のインスタンスがオンデマンドで作成されます。

SAP リクエストまたはレスポンスの構造オブジェクト内にあるフィールドは、要素的 または 複雑 である場合があります。elementary フィールドにはスカラー値が 1 つ含まれますが、複雑なフィールドには、単数または複雑な型の 1 つ以上のフィールドが含まれます。

要素フィールドには、文字、数字、16 進数、または文字列フィールドタイプを使用できます。以下の表は、構造オブジェクトに存在する可能性のある要素フィールドのタイプをまとめたものです。

文字フィールドには、基礎となる JCo および ABAP ランタイムでUnicode 以外の文字エンコーディングを使用できる固定された文字文字列が含まれます。ユニコード以外の文字文字列は、1 バイトごとに 1 文字エンコードされます。Unicode 文字文字列は、UTF-16 エンコーディングを使用して 2 つのバイトでエンコードされます。文字フィールドの値は Java で java.lang.String オブジェクトとして表され、基礎となる JCo ランタイムは ABAP 表現への変換を行います。

文字フィールドは、関連付けられた バイト長と unicodeByteLength プロパティーでフィールドの長さを宣言します。これは、各エンコーディングシステムのフィールドの文字文字列の長さを決定します。

数値フィールドには数字が含まれます。以下の数値フィールドタイプがサポートされます。

16 進数フィールドには raw バイナリーデータが含まれます。以下の 16 進数のフィールドタイプがサポートされます。

文字列フィールドは変数長の文字列値を参照します。その文字列値の長さは、ランタイムまで固定されません。文字列値のストレージは、基礎となる JCo および ABAP ランタイムに動的に作成されます。文字列フィールド自体のストレージが修正され、文字列ヘッダーのみが含まれます。

複雑なフィールドは structure または table フィールドタイプのいずれかになります。以下の表では、これらの複雑なフィールドタイプをまとめています。

STRUCTURE フィールドには構造オブジェクトが含まれ、BAAP 構造レコードとして基礎となる JCo および ABAP ランタイムに保存されます。ABAP タイプの u または v に対応します。STRUCTURE フィールドの値は、Java で org.fusesource.camel.component.sap.model.rfc.Structure のインターフェースを持つ構造オブジェクトとして表現されます。

TABLE フィールドには、テーブルオブジェクトが含まれており、BAAP 内部テーブルとして基礎となる JCo および ABAP ランタイムに保存されます。ABAP タイプ h に対応します。フィールドの値は、テーブルオブジェクトにより、org.fusesource.camel.component.sap.model.rfc.Table のインターフェースを持つテーブルオブジェクトによって Java で表されます。

テーブルオブジェクトは、同じ構造を持つ構造オブジェクトの行が含まれる同種のリストデータ構造です。このインターフェースは、java.util.List インターフェースと org.eclipse.emf.ecore.EObject インターフェースの両方を拡張します。

public interface Table<S extends Structure>
    extends org.eclipse.emf.ecore.EObject,
    java.util.List<S> {

    /**
     * Creates and adds table row at end of row list
     */
    S add();

    /**
     * Creates and adds table row at index in row list
     */
    S add(int index);

}

テーブルオブジェクトの行のリストは、リストインターフェースで定義された標準のメソッドを使用してアクセスおよび管理されます。テーブルインターフェース以外に、構造オブジェクトを行リストに追加する 2 つのファクトリーメソッドが提供されます。

テーブルオブジェクトは、Eclipse Modeling Framework(EMF)を使用してコンポーネントランタイムに実装され、そのフレームワークの EObject インターフェースをサポートします。テーブルオブジェクトのインスタンスには、提供される行の構造と内容を定義して制限する meta-data がアタッチされています。このメタデータには、EMF が提供する標準メソッドを使用してアクセスし、イントロスペクションすることができます。詳細は、EMF ドキュメントを参照してください。