javax.xml.ws.ResponseWrapperアノテーションは,wrapperスタイルで指定できます。non-wrapperスタイルで指定した場合,標準エラー出力とログに警告メッセージが出力され,処理が続行されます(KDJW61062-W)。
javax.xml.ws.ResponseWrapperアノテーションはSEIで指定するアノテーションです。Webサービス実装クラスに指定した場合は無視されます。Webサービス実装クラスに指定した場合,標準エラー出力とログに警告メッセージが出力され,処理が続行されます(KDJW61078-W)。
javax.xml.ws.ResponseWrapperアノテーションを使用したカスタマイズ例を次の図に示します。
図16-24 javax.xml.ws.ResponseWrapperアノテーションを使用したカスタマイズ例
localName要素は,レスポンスwrapper要素のローカル名のマッピングをカスタマイズするときに指定します。localName要素に要素値を指定した場合,wrapper要素の型名もカスタマイズできます。
localName要素は半角英数字とアンダースコア(_)で指定します。それ以外の文字を指定した場合の動作は保証されません(エラーメッセージは出力されません)。
targetNamespace要素は,レスポンスwrapper要素の名前空間のマッピングをカスタマイズするときに指定します。
targetNamespace要素には,http://またはurn:のプロトコルを名前空間として指定します。指定できる名前空間の形式および文字列を示します。
表16-23 名前空間に記述できる文字列の条件(javax.xml.ws.ResponseWrapper)
項番 | 条件 | 不正な文字列の例 | 不正な文字列を指定した場合の動作 |
---|---|---|---|
1 | 半角英数字(0~9,A~Z,a~z)だけを使用した文字列 | http://鈴木.com http://133.145.224.19/ http://[1080:2C14;D30:BA04:275:806:270C:418A]/ | 動作は保証されません(エラーメッセージは出力されません)。 |
2 | Javaの予約語以外の文字列 | http://xxx.com/abstract | 動作は保証されません。 |
3 | 先頭が数字でない文字列 | http://1xxx.com |
className要素は,生成するレスポンスbeanのクラス名を完全修飾名で指定します。
className要素を指定するときの注意事項について説明します。
partName要素は,レスポンスwrapper要素を参照するoutputメッセージのパート名をカスタマイズするときに指定します。
partName要素は半角英数字とアンダースコア(_)で指定します。それ以外の文字を指定した場合の動作は保証されません(エラーメッセージは出力されません)。