8.1.5 配列型

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

目次索引

8.1.5 配列型

　以下の表にXMLの配列型と、Java言語のRPCアプリケーションで使用するデータ型の対応を示します。

XMLのデータ型	RPCアプリケーションのパラメタ(Javaのデータ型クラス)
XMLのデータ型	inまたはreturn	outまたはinout
soapenc:Array	配列	ZZZ.ArrayOfデータ型Holder

　配列型としてString型の配列の場合、WSDL定義は以下のようになります。

 <complexType name ='ArrayOfString'>
   <complexContent>
     <restriction base='soapenc:Array'>
       <attribute ref='soapenc:arrayType' wsdl:arrayType='xsd:string[]'/>
     </restriction>
   </complexContent>
 </complexType>

RPCアプリケーションで扱うことができる配列型は、“java.util.Vectorクラスを除くinパラメタ／返り値として使用できるJavaのデータ型”を要素とする配列です。
要素におけるデータ型マッピングについては、“単純型”、“列挙型”、“構造体型”、“Bean型”を参照してください。
RPCクライアントアプリケーションで配列型を送信する場合、SOAPバージョンによって、データ型を表すネームスペースが自動変換されます。

【in/return】

　Javaの配列を使用します。

　Int型の1次元配列の例

　　int[] value;

　UnsignedInt型の2次元配列の例

　　com.fujitsu.interstage.soapx.types.UnsignedInt[][] value;

　構造体型の3次元配列の例

　　構造体型として定義した任意のクラス[][][] value;

　列挙型の1次元配列の例

　　列挙型として定義した任意のクラス[] value;

　列挙型の3次元配列の例

　　列挙型として定義した任意のクラス[][][] value;

　Bean型の2次元配列の例

　　Bean型として定義した任意のクラス[][] value;

【out/inout】

［1次元Holder］
　ZZZ.ArrayOfIntHolder, ZZZ.ArrayOfUnsignedIntHolder, ZZZ.ArrayOfShortHolder, ZZZ.ArrayOfUnsignedShortHolder, ZZZ.ArrayOfDateHolder,
　ZZZ.ArrayOfLongHolder, ZZZ.ArrayOfUnsignedLongHolder, ZZZ.ArrayOfByteHolder, ZZZ.ArrayOfUnsignedByteHolder,
　ZZZ.ArrayOfFloatHolder, ZZZ.ArrayOfDoubleHolder, ZZZ.ArrayOfBooleanHolder, ZZZ.ArrayOfStringHolder, ZZZ.ArrayOfBigDecimalHolder, ZZZ.ArrayOfBigIntegerHolder
　ZZZ.ArrayOfImageHolder, ZZZ.ArrayOfSourceHolder, ZZZ.ArrayOfMimeMultipartHolder, ZZZ.ArrayOfDataHandlerHolder

［2次元Holder］
　ZZZ.ArrayOfInt2DHolder, ZZZ.ArrayOfUnsignedInt2DHolder, ZZZ.ArrayOfShort2DHolder, ZZZ.ArrayOfUnsignedShort2DHolder, ZZZ.ArrayOfDate2DHolder,
　ZZZ.ArrayOfLong2DHolder, ZZZ.ArrayOfUnsignedLong2DHolder, ZZZ.ArrayOfByte2DHolder, ZZZ.ArrayOfUnsignedByte2DHolder,
　ZZZ.ArrayOfFloat2DHolder, ZZZ.ArrayOfDouble2DHolder, ZZZ.ArrayOfBoolean2DHolder, ZZZ.ArrayOfString2DHolder, ZZZ.ArrayOfBigDecimal2DHolder, ZZZ.ArrayOfBigInteger2DHolder
　ZZZ.ArrayOfImage2DHolder, ZZZ.ArrayOfSource2DHolder, ZZZ.ArrayOfMimeMultipart2DHolder, ZZZ.ArrayOfDataHandler2DHolder

　配列をout/inoutパラメタとして使用する場合、RPCサーバアプリケーションではZZZ.ArrayOfデータ型Holderクラスを使用します。このクラスは、以下のように配列を保持するフィールドと、コンストラクタを持っています。

クラス名	メソッド名	説明
ZZZ.ArrayOfデータ型Holder	public データ型配列 value	インスタンスフィールド。インスタンスが現在保持している配列です。
ZZZ.ArrayOfデータ型Holder	publicArrayOfデータ型Holder(データ型配列 initial)	コンストラクタ。 valueフィールドとしてinitialを持つインスタンスを作成します。

2次元配列の場合は、ZZZ.ArrayOfデータ型2DHolderになります。

　配列をRPCサーバアプリケーションのメソッドのinout/outパラメタとして使用する場合、パラメタのデータ型としてZZZ.ArrayOfデータ型Holder を使用します。RPCサーバアプリケーションのメソッドでは、パラメタとして受け取った、ZZZ.ArrayOfデータ型Holderクラスのインスタンスのvalueフィールドを更新します。これにより、更新された新しい配列がRPCクライアントアプリケーションへout/inoutパラメタとして送信されます。

　3次元以上の単純型の配列をRPCサーバアプリケーションでinout/outパラメタとして使用する場合は、inout/outパラメタの配列データ型をvalueに持つHolderクラスを作成する必要があります。

　
　RPCサーバアプリケーションで使用する3次元配列のHolderクラスの作成例

 import javax.xml.rpc.holders.Holder;
 class ArrayOfString3DHolder implements Holder {
   public String[][][] value;
   public ArrayOfString3DHolder() {}  // デフォルトコンストラクタ
   public ArrayOfString3DHolder( String[][][] initial ) {
     this.value = initial;
   }
 }

　
　RPCクライアントアプリケーションでint型の1次元配列を使用する例

 //RPCクライアントアプリケーション
 package client;
 import javax.xml.rpc.Call;
 import javax.xml.rpc.Service;
 import javax.xml.rpc.ServiceFactory;
 import javax.xml.namespace.QName;
 import javax.xml.rpc.ParameterMode;
 import javax.xml.rpc.encoding.XMLType;
 import java.util.Map;

 class arrayClient {
   public static void main(String[] args){
        ：
     Service service = ServiceFactory.newInstance().createService(new QName("",""));
     Call call = service.createCall();
        ：
     call.addParameter( "iArrayHolder", XMLType.SOAP_ARRAY,
               int[].class, ParameterMode.INOUT );
     call.setReturnType(XMLType.SOAP_ARRAY,int[].class);
          ：
   //パラメタの設定
     int[] inArray = new int[10];
     for(int i=0; i<inArray.length; i++)
     {
       inArray[i] = i;
     }
     Object[] params = new Object[]{ inArray };
          ：
   //Webサービス呼び出し・戻り値の取得
     int[] _ret = (int[])call.invoke(params);
          ：
   //INOUTパラメタの取得
     Map outParams = call.getOutputParams();
     int[] _inout = (int[])outParams.get("iArrayHolder");
          ：
   //例外処理
          ：
   }
 }

　RPCサーバアプリケーションでint型の1次元配列をinoutパラメタとして使用する例

 //RPCサーバアプリケーションのメソッド
 package server;
 import com.fujitsu.interstage.soapx.holders.ArrayOfIntHolder;
 public class arrayServer{
   public int[] server_method(ArrayOfIntHolder iArrayHolder){
     int[] iArray = iArrayHolder.value;  // ArrayOfIntHolderの保持する配列の取得
     int[] newArray = new int[iArray.length];
     for(int i=0;i<iArray.length;i++){
       newArray[i] = iArray[i] * 2;
     }
     iArrayHolder.value = newArray;  // ArrayOfIntHolderの保持する配列の再設定
     return newArray;
   }
 }

　上記の例では、第1パラメタのArrayOfIntHolderオブジェクトの持つ配列を取り出し、各要素に含まれる値を2倍してinoutパラメタとしてRPCクライアントアプリケーションへ送信します。

　Webサービス情報ファイルの記述例

     ：
 <service name="" provider="java:RPC">
   <parameter name="className" value="server.arrayServer.server_method"/>
   <parameter name="allowedMethods" value="*"/>
   <operation name="server_method" >
     <parameter name="iArrayHolder" type="soapenc:Array"
          xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" mode="INOUT"/>
   </operation>
 </service>
     ：

目次索引