Interstage Application Server J2EE ユーザーズガイド

19.2.3 Webサービスクライアントアプリケーションを開発する

　Webサービスクライアントは、WSDLから生成したスタブを利用してWebサービスを呼び出す処理を行う任意のクラスです。この処理では、以下のオブジェクトを利用します。

• JAX-RPCで提供されるjavax.xml.rpc.ServiceFactoryオブジェクト
  Serviceオブジェクトの生成を行います。
• WSDLから生成された、ServiceインタフェースおよびServiceオブジェクト
  呼び出すWebサービス全体に対応するクラスです。Serviceオブジェクトは、Serviceインタフェースをimplementsし、スタブオブジェクトの生成機能を備えています。WSDLのtargetNamespaceに基づいたパッケージ名と、WSDLのserviceのnameに基づいたクラス名でアクセスします。
• WSDLから生成された、サービスエンドポイントインタフェースおよびスタブオブジェクト
  呼び出すWebサービスアプリケーションに対応するクラスです。スタブオブジェクトは、サービスエンドポイントインタフェースをimplementsし、Webサービスの呼び出し機能を備えています。WSDLのtargetNamespaceに基づいたパッケージ名と、WSDLのportTypeのnameに基づいたクラス名でアクセスします。

■ 処理の流れ

1. ServiceFactoryオブジェクトを生成する
2. ServiceFactoryオブジェクトからServiceオブジェクトを取得する
3. Serviceオブジェクトからスタブオブジェクトを取得する
4. スタブオブジェクトのメソッドを呼び出す

　Serviceインタフェースのクラス名が“StockQuoteProviderService”、サービスエンドポイントインタフェースのクラス名が"StockQuoteProvider"、呼び出すWebサービスのオペレーションの名前が"getLastTradePrice"の場合についての処理例です。

ServiceFactory sf = ServiceFactory.newInstance();//(1)
StockQuoteProviderService sqs = (StockQuoteProviderService) sf.loadService(StockQuoteProviderService.class);//(2)
StockQuoteProvider sqp = sqs.getStockQuoteProviderPort();//(3)
float price = sqp.getLastTradePrice(tickerID);//(4)

• JAX-RPCのServiceFactoryオブジェクトでは、以下のメソッドを使用してください。
  • loadService(java.lang.Class class1)

  　以下のメソッドは使用できません。

  • createService(QName serviceName)
  • createService(java.net.URL wsdlDocumentLocation, QName serviceName)
  • loadService(java.net.URL url, java.lang.Class class1,java.util.Properties properties)
  • loadService(java.net.URL url, QName qname, java.util.Properties properties)
    
    
• Serviceオブジェクトでは、呼び出すWebサービスに対応してWSDLに基づいて生成された、対象のWebサービス固有のメソッドを使用してください。JAX-RPC APIで提供されるjavax.xml.rpc.Serviceインタフェースに定義されている汎用メソッドは使用できません。
  
  
• セション管理を利用している場合、同じ接続先に対して新たなセションを 開始するときは、Serviceオブジェクトを新たに取得します。セション管理の利用については“HTTP接続に関する設定”を参照してください。
  
  
• Serviceオブジェクトの取得では、内部的に多くの処理が行われます。アプリケーションの性能向上のため、Serviceオブジェクトをリクエストごとに取得するのではなく、取得したServiceオブジェクトを保持して再利用することを推奨します。
  
  
• 単一のスタブオブジェクトは、複数のスレッドで同時に使用できません。スレッドの排他を行って利用する、または、リクエストごとに毎回取得するなどの対応が必要です。
  
  
• 通信異常などが発生した場合のため、これらの処理で発生する可能性のある例外については、これをすべてcatchし、すべての情報とスタックトレースをログなどに残る出力処理を行うことを推奨します。
  以下は標準出力・標準エラーがファイルに出力されている場合の例外処理の例です。

  ------------------------------------------------------------------
       } catch( javax.xml.rpc.ServiceException e ){
         e.printStackTrace();
         if( e.getLinkedCause() != null ){
           e.getLinkedCause().printStackTrace();
         }
       } catch( javax.xml.rpc.soap.SOAPFaultException e ){
         e.printStackTrace();
         System.out.println("  Code = " + e.getFaultCode());
         System.out.println("  String = " + e.getFaultString());
         System.out.println("  Actor = " + e.getFaultActor());
         if( e.getDetail() != null ){
           Detail detail = e.getDetail();
           Iterator it = detail.getDetailEntries();
           if( it != null ){
             while(it.hasNext()){
               SOAPElement elm = (SOAPElement)it.next();
               System.out.println("  Detail = " + elm);
             }
           }
         }
       } catch( javax.xml.rpc.JAXRPCException e ){
         e.printStackTrace();
         if( e.getLinkedCause() != null ){
           e.getLinkedCause().printStackTrace();
         }
       } catch( java.rmi.RemoteException e ){
         e.printStackTrace();
         if( e.detail != null ){
           e.detail.printStackTrace();
         }
       } catch( Throwable e ) {
         e.printStackTrace();
       }
  ------------------------------------------------------------------