WSDLのポートタイプ名(wsdl:portType要素のname属性)からSEI名へのマッピングについて説明します。
WSDLのポートタイプとSEI名は,JAX-WS 2.2仕様に従ってマッピングされます。マッピング例を次の図に示します。
図15-2 ポートタイプとSEI名のマッピング例
マッピングするときに,WSDLのポートタイプ名の先頭文字は大文字に変換されます。変換例を次に示します。
(変換前)portTypeName (変換後)PortTypeName
WSDLのポートタイプ名と名前空間を指定する場合は,パッケージ名も含めてSEI名が"javax.xml.ws.Provider"にならないようにする必要があります。そのため,ポートタイプ名には"Provider"または"provider"を指定しないでください。また,名前空間には"http://ws.xml.javax"を指定しないでください。
ポートタイプには,次の表に示すすべての条件を満たす文字列を記述できます。ただし,バインディング宣言でカスタマイズする場合は,XML Schema仕様のxsd:NCName型として使用できる文字列を記述できます。
表15-3 ポートタイプに記述できる文字列の条件
項番 | 条件 | 不正な文字列の例 | 不正な文字列を指定した場合の動作 |
---|---|---|---|
1 | 半角英数字(0~9,A~Z,a~z),およびアンダースコア(_)だけを使用した文字列 | 鈴木_portType | 動作は保証されません(エラーメッセージは出力されません)。 |
2 | 先頭が数字でない文字列 | 1User_portType | 標準エラー出力とログにエラーメッセージが出力され,処理が終了されます(KDJW51029-E)。 |
WSDLに記述できるポートタイプは,1~255個です。ポートタイプの記述数と動作の対応を次の表に示します。
表15-4 ポートタイプの記述数と動作の対応
項番 | 要素 | 記述数 | 不正な文字列を指定した場合の動作 |
---|---|---|---|
1 | wsdl:portType | 0個 | 標準エラー出力とログにエラーメッセージが出力され,処理が終了されます(KDJW51008-E)。 |
2 | 1~255個 | 正常終了します。 | |
3 | 256個以上 | 標準エラー出力とログにエラーメッセージが出力され,処理が終了されます(KDJW51008-E)。 |