XML マップをサービスコントロールのメソッドに追加する

サービスコントロールのクライアントに公開される Java インタフェースと、対象のWeb サービスに送信される XML メッセージとの関係を変更することができます。以下の例は、QuoteClient.jws サンプルで使用する QuoteServiceControl.ctrl サンプルサービスから抜き出したものです。

最初、QuoteServiceControl.ctrl は QuoteService.jws から生成されます。生成後、getQuote の最初のパラメータが Java シグネチャから削除されました。つまり、このサービスコントロールを使用する呼び出し側 Web サービスがそのパラメータを渡すことは想定されていません。次に、<customerID> 要素の値をハードコード化して、XML マップが getQuote に追加されています。これにより、メッセージの形式は QuoteService で想定しているとおり、2 つのパラメータを持つことになります。呼び出し側サービスは 1 つのパラメータを渡し、サービスコントロールがそのパラメータとハードコード化されたパラメータを組み合わせて、対象のサービスが想定している 2 つのパラメータを持つメッセージを生成します。

QuoteService.jws から生成されたままのコードを以下に示します。getQuote が 2 つのパラメータを取ることに注意してください。

import weblogic.jws.control.ServiceControl;
/**
 * @jws:location http-url="QuoteService.jws" jms-url="QuoteService.jws"
 * @jws:wsdl file="#QuoteServiceWsdl"
 */
public interface QuoteServiceControl extends ServiceControl
{
    public interface Callback
    {
        /**
         * @jws:conversation phase="finish"
         */
        public void onQuoteReady (java.lang.String tickerSymbol, double dQuote);
    }
    /**
     * @jws:conversation phase="start"
     */
    public void getQuote (int customerID String tickerSymbol);
}

CTRL ファイルを手動で変更した後のコードを以下に示します。customerID パラメータがメソッドシグネチャから削除されており、手動で追加された XML マップにハードコード化されています。XML マップは、対象の Web サービスのコントラクトに準拠していなければなりません。

import weblogic.jws.control.ServiceControl;
/**
 * @jws:location http-url="QuoteService.jws" jms-url="QuoteService.jws"
 * @jws:wsdl file="#QuoteServiceWsdl"
 */
public interface QuoteServiceControl extends ServiceControl
{
    public interface Callback
    {
        /**
         * @jws:conversation phase="finish"
         */
        public void onQuoteReady (java.lang.String tickerSymbol, double dQuote);
    }
    /**
     * @jws:conversation phase="start"
     * @jws:parameter-xml xml-map::
     *  <getQuote xmlns="http://www.openuri.org/">
     *      <customerID>1234567890</customerID>
     *      <tickerSymbol>{tickerSymbol}</tickerSymbol>
     *  </getQuote>::
     */
    public void getQuote (String tickerSymbol);
}

メソッドシグネチャと XML マップを変更するには、[マップおよびインタフェースの編集] ダイアログを使用する方法もあります。ダイアログにアクセスするには、デザインビューで QuoteClient.jws を編集する際に getQuote メソッドのマップアイコン（太い矢印）をダブルクリックします。

XML マップをサービス コントロールのメソッドに追加する

XML マップをサービスコントロールのメソッドに追加する