XML マップは、拡張子が .xmlmap のマップファイルに配置すれば再利用することができます。マップファイルのマップはソースコードに配置されたマップと同じように機能しますが、マップファイルには複数のメソッド、コールバック、およびコールバックハンドラから利用できるというメリットがあります。つまり、マップファイルのマップはプロジェクトの任意の位置または別のプロジェクトから再利用することができます。また、複数のマップをマップファイルに追加すると、独立したマップファイルで関連する複数のマップをグループ化できます。

注意: このトピックでは、XML マップファイルの具体的な特性について説明します。（インラインマップとマップファイルの両方で実行できる）一般的なマッピングタスクの詳細については、XML マップのしくみを参照してください。

マップファイルを使用するのは、2 段階のプロセスです。マップファイルを作成し、それをソースコードから呼び出します。

マップファイルを作成する

再利用可能な XML マップを開始するにはで説明されているように、マップファイルは、プロジェクトにテキストファイルを追加し、そのファイルの拡張子を .xmlmap にして作成します。次の例は、そのファイルの内容を説明しています。

XML マップファイルの先頭は、次の <xm:map-file> タグでなければなりません。このタグは、ファイルにマップが含まれていることを WebLogic Workshop に示します。また、<xm:value> などのマップタグのネームスペースを区切る「xm」プレフィックスも宣言します。

<xm:map-file xmlns:xm="http://www.bea.com/2002/04/xmlmap/">

必要に応じて、<xm:map-file> タグの後に <xm:java-import> タグを続けることができます。<xm:java-import> タグは、マップの置換ディレクティブが、マップを呼び出すメソッドまたはコールバックのスコープにない Java クラスを必要とする場合に使用します。次の例では、Date クラスとユーザ定義クラスがインポートされます。

<xm:java-import class="java.util.Date"/>
<xm:java-import class="com.MyCompany.MyType"/>

<xm:java-import> は、Java の import ディレクティブに似ています。ただし、class 属性では完全修飾クラス名のみ使用できます。* を使用してパッケージの全クラスをインポートすることはできません。

マップファイルの各 XML マップは、<xm:xml-map> タグの内側に挿入されます。それらのタグの signature 属性はマップのシグネチャを定義します。これは、メソッドまたはコールバックのシグネチャと似ていますが混同しないようにしてください。XML マップのシグネチャは、マップの名前を指定します。マップのシグネチャは、マップおよびそのマップによって使用されるパラメータを参照する際に使用します。パラメータは、マップそれ自体の中の置換ディレクティブに対応します。たとえば次のマップを使用するには、呼び出し元のメソッドまたはコールバックのパラメータ値をデータとして渡して placeOrder として呼び出します。マップファイルのマップの呼び出しに関する詳細は、次の節を参照してください。

    <xm:xml-map signature="placeOrder(String serialNumber, int quantity)">
        <serialNumber>{serialNumber}</serialNumber>


        <quantity>{quantity}</quantity>
    </xm:xml-map>

XML マップの多くは 1 つのマップファイルに配置できます。XML マップファイルは、次の </xm:map-file> タグで終了します。

</xm:map-file>

マップファイルのマップを呼び出す

マップファイル中のマップは、<xm:use> タグまたはその代替構文（このトピックの最後に説明）を使用します。<xm:use> タグには、1 つの属性 call があります。この属性は、パラメータとして渡す値だけでなく、呼び出すマップの位置を示すために使用します。

次の例では、requestParts メソッドの partID パラメータと partQuantity パラメータが、「CustomerRequests」というマップファイルにある（前の例のマップのような）「placeOrder」というマップに渡されます。

/*


 * @jws:operation


 * @jws:parameter-xml xml-map::
 * <requestParts>
 *     {CustomerRequests.placeOrder(String partID, int partQuantity)}
 * </requestParts>
 * ::


public void requestParts(String partID, int partQuantity)
{...}

マップのパスは、そのマップを見つけられるだけの完全なものでなければなりません。たとえば、マップファイルが「CustomerMaps」というプロジェクトのパラレルフォルダに格納されており、そのプロジェクト自体の名前が「OrderServices」である場合、上の例のパスは次のように指定できます。

OrderServices.CustomerMaps.CustomerRequests.placeOrder(String partID, int partQuantity)

マップ ファイルを作成する

マップ ファイルのマップを呼び出す

マップファイルを作成する

マップファイルのマップを呼び出す