Interstage Application Server SOAPサービス ユーザーズガイド

6.4.4 Fault詳細項目からの例外クラスの取得

　EJBサーバアプリケーションから通知された例外はFault詳細項目に情報が設定されています。
　以下を指定してFault詳細項目を取得し、例外クラス情報を取得してください。

• 名前空間名：urn:Fujitsu-Soap-Service-Data
• ローカル名：パッケージ名-Javaクラス名SOAPGWType(Javaクラス名が"a.b.c"の場合、"a-b-cSOAPGWType"になります。)
• EJBサーバアプリケーションと連携するRPCクライアントアプリケーションでは、Fault詳細項目の取得処理として、必ず上記の詳細項目を取得する処理が必要です。
• 例外クラスは、メソッド呼び出し前に、変換マッピングを構築しておきます。
  

　
　以下のようなリモートインタフェースが定義され、subメソッドが例外クラスpack1.SubExceptionをスローするように定義されている場合のFault詳細項目取得についてのコーディング例を示します。
　Fault詳細項目から例外情報を取り出すには

1. 例外クラスの各メンバ情報を取得し、例外クラスを構築する方法
2. Interstage SOAPサービスが提供する拡張APIを使用して例外クラスを取得する方法

の2種類の方法があります。
　例外クラスに複数のメンバが定義される場合は(2)の方法を使用することで処理の簡素化が行えます。

 // リモートインタフェース定義
 package pack1;
 import java.rmi.*;
 import javax.ejb.*;

 public class calcBean implements javax.ejb.SessionBean {
     ：
   public int sub(int a, int b)  throws pack1.SubException {
     ：
   }
     ：
 }

 // 例外クラス定義
 public class SubException extends java.lang.Exception {
     ：
   public String detailMessage;
   public int detailCode;

   public SubException() { }
     ：
 }

• 例外クラス名前空間名：urn:Fujitsu-Soap-Service-Data
• 例外クラスのローカル名：pack1-SubExceptionSOAPGWType
• 例外クラスのJavaクラス名： pack1.SubException

 // import文宣言
 import javax.xml.rpc.Service;
 import javax.xml.rpc.ServiceFactory;
 import javax.xml.rpc.soap.SOAPFaultException;
 import javax.xml.rpc.encoding.TypeMappingRegistry;
 import javax.xml.rpc.encoding.TypeMapping;
 import javax.xml.soap.Detail;
 import javax.xml.soap.DetailEntry;
 import javax.xml.namespace.QName;
 import java.util.Iterator;
 import javax.xml.soap.SOAPElement;
     ：
 try {
     ：
   Service service = null;
   service = ServiceFactory.newInstance().createService(new QName("",""));
   TypeMappingRegistry tmr = service.getTypeMappingRegistry();
   TypeMapping tm = tmr.createTypeMapping();
   // 例外クラス QName作成
   QName _qname = 
         new QName( "urn:Fujitsu-Soap-Service-Data", "pack1-SubExceptionSOAPGWType" );
   // 例外クラスのマッピング登録
   tm.register(pack1.SubException.class, _qname,
         new com.fujitsu.interstage.soapx.encoding.ser.BeanSerializerFactory( 
            pack1.SubException.class, _qname),
            new com.fujitsu.interstage.soapx.encoding.ser.BeanDeserializerFactory( 
            pack1.SubException.class, _qname ) );

   // マッピング情報をマッピングレジストリへ登録
   tmr.register( "http://schemas.xmlsoap.org/soap/encoding/", tm );
     ：
   // メソッド呼び出し
   ..... = call.invoke( ... );
     ：
 } catch( javax.xml.rpc.ServiceException e ) {
     ：
 } catch( SOAPFaultException e ) {
 // Fault情報の取得
   QName _faultCode = e.getFaultCode();
   String _faultString = e.getFaultString();
   String _faultActor = e.getFaultActor();
   Detail _detail = e.getDetail();
   if( _detail != null ){
   // Fault詳細項目の取得
     String  _detailMessage = null;
     int  _detailCode = 0;

     Iterator _it = _detail.getChildElements();
     if( _it != null ) {
       while(_it.hasNext()) {
         SOAPElement _elm = (SOAPElement)_it.next();
         String _elmName = _elm.getElementName().getLocalName();
         // 例外クラス情報の判定
         if( _elmName.equals("pack1-SubExceptionSOAPGWType")) {
   //
   // 例外クラスの各メンバ情報を取得し例外クラスを構築する方法
   //
           pack1.SubException excep;
           _it = _elm.getChildElements();
   // 例外クラスのメンバ情報の取得
   // 例外クラスに定義されたメンバ名でメンバ情報を取得する
           while(_it.hasNext()) {
             _elm = (SOAPElement)_it.next();
             _elmName = _elm.getElementName().getLocalName();
             if( _elmName.equals("detailMessage")) {
               _detailMessage = _elm.getValue();
             }
             else if( _elmName.equals("detailCode")) {
               _detailCode = (new Integer((String)_elm.getValue())).intValue();
             }
           }

   // 例外クラスの作成
           excep = new pack1.SubException();
   // 例外クラスメンバ情報の設定
           excep.detailMessage = _detailMessage;
           excep.detailCode = _detailCode;
   // 例外クラスのスロー
           throw excep;

   //
   // Interstage SOAPサービスが提供する拡張APIを使用して例外クラスを取得する方法
   //
           QName ExcepQName = 
            new QName( "urn:Fujitsu-Soap-Service-Data",
                       "pack1-SubExceptionSOAPGWType" );
           java.lang.Object excep;
   // 例外クラスの取得
           try {
             excep = ((com.fujitsu.interstage.soapx.message.SOAPElementImpl)_elm)
                        .getValueAsType(ExcepQName);
           } catch( java.lang.Exception ee ) {
                  ：   //  取り出しに失敗した場合の処理を記述
           }
   // 例外クラスのスロー
           throw (pack1.SubException)excep;

         }
       }
     }
   }
 }