wrapperスタイルの場合，WSDLのメッセージのパートから参照するwrapper子要素と，Javaメソッドのパラメタおよび戻り値がマッピングされます。マッピング例を次の図に示します。

図12-4　メッセージのパートとパラメタおよび戻り値のマッピング例（wrapperスタイル）

マッピングするときに，WSDLのwrapper子要素名の先頭文字は小文字に変換されます。

（変換前）WrapperName　　　（変換後）wrapperName

• パートの種類とJavaソースへのマッピングの関係
  パートの種類（in，inout，out）と，Javaソースへのマッピングの関係を次の表に示します。
  

  表12-8　パートの種類とJavaソースへのマッピングの関係（wrapperスタイル）

  項番	WSDLパートの種類	Javaへのマッピング
  		マッピング先	マッピング方法
  1	in	パラメタ	javax.xml.ws.Holder<T>クラスでマッピングされません。java.lang.Stringなどのクラスでマッピングされます。
  2	inout	パラメタ	javax.xml.ws.Holder<T>クラスでマッピングされます。※
  3	out	パラメタ	javax.xml.ws.Holder<T>クラスでマッピングされます。※
  4		戻り値	javax.xml.ws.Holder<T>クラスでマッピングされません。java.lang.Stringなどのクラスでマッピングされます。

  注※

  wrapper子要素の型がxsd:intなど，JAXB仕様でJavaのプリミティブ型にマッピングされる型の場合，プリミティブに対応するため，送信時のHolderのインスタンスにnullでない値を設定してください。

  
  

wrapper子要素名には，次の表に示すすべての条件を満たす文字列を記述できます。ただし，バインディング宣言でカスタマイズする場合は，XML Schema仕様のxsd:NCName型として使用できる文字列を記述できます。

表12-9　wrapper子要素名に記述できる文字列の条件（wrapperスタイル）

注※

「Abstract」のように，Java予約語の先頭文字を大文字にした文字列も記述できません（マッピングによって先頭文字が小文字に変換されるため）。

inputメッセージまたはoutputメッセージに出現するwrapper子要素をWSDL内に複数記述した場合，wrapper子要素のローカル名とXML Schemaの型が同じか異なるかによって，wrapper子要素の扱いは次の表のとおり異なります。

表12-10　wrapper子要素のローカル名とXML Schemaの型によって異なるwrapper子要素の扱い

複数の同じwrapper子要素と，異なるwrapper子要素を複合型の子要素として同時にWSDLファイルに定義している場合，そのWSDLファイルを指定してcjwsimportコマンドに実行したときに，SEIがnon-wrapperスタイルでマッピングされます。

SEIがnon-wrapperスタイルでマッピングされるWSDLファイルの例を次に示します。

<wsdl:definitions name="TestJaxWsService"
                  xmlns:soap=http://schemas.xmlsoap.org/wsdl/soap/
                  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
                  xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
                  xmlns:tns="http://example.com/example"
                  targetNamespace="http://example.com/example">
 
   <xsd:element name="getUserData" type="tns:getUserData"/>
    ...
   <xsd:complexType name="getUserData">
     <xsd:sequence>
       <xsd:element name="in0"  type="xsd:string"/>
       <xsd:element name="in0"  type="xsd:string"/>
       <xsd:element name="hoge" type="xsd:string"/>
     </xsd:sequence>
   </xsd:complexType>
   ...
  </xsd:schema>
 </wsdl:types>
 
...
 <wsdl:message name="getUserDataRequest">
  <wsdl:part name="inputParameters" element="tns:getUserData"/>
 </wsdl:message>
 ...
</wsdl:definitions>

• wrapper子要素をJavaへマッピングするときに，メソッドのパラメタの型は異なっていてもパラメタ名が同じになると，標準エラー出力とログにエラーメッセージが出力され，処理が終了されます。
• inおよびinoutのwrapper子要素からマッピングされたパラメタは，wrapper要素内の対応するwrapper子要素の出現順序でマッピングされます。outのwrapper子要素からマッピングされたパラメタは，wrapper要素内の対応するwrapper子要素の出現順序でマッピングされます。
• in，inout，outのwrapper子要素が混在している場合，inとinoutのwrapper子要素が，wrapper要素内の対応するwrapper子要素の出現順序でマッピングされます。そのあとにoutのwrapper子要素が，wrapper要素内の対応するwrapper子要素の出現順序でマッピングされます。
• Javaプリミティブ型，Java配列型，ユーザ定義型であるout（戻り値にマッピングされるものは除く），およびinoutのパラメタは，JavaソースではHolder型（javax.xml.ws.Holder<T>）にマッピングされます。その例を次に示します。
  

  （例）

  outおよびinoutのパートのデータ型：java.lang.String

  Javaへのマッピング後のデータ型：javax.xml.ws.Holder<java.lang.String>

• Javaへマッピング後のパラメタの数は，0〜254個で指定してください。255個以上指定した場合は，標準エラー出力とログにエラーメッセージが出力され，処理が終了されます（KDJW51016-E）。

outのwrapper子要素が1個の場合，またはoutのwrapper子要素のローカル名が"return"の場合，その値がメソッドの戻り値へマッピングされます。ただし，型は異なっていてもローカル名が"return"であるwrapper子要素を複数記述した場合，標準エラー出力とログにエラーメッセージが出力され，処理が終了されます。