15.1.9 サービスおよびポートからサービスクラスへのマッピング

WSDLのサービス(wsdl:service要素のname属性)およびポート(wsdl:port要素のname属性)から,サービスクラスへのマッピングについて説明します。

<この項の構成>
(1) マッピング
(2) サービス名およびポート名の条件

(1) マッピング

WSDLのサービスおよびポートと,サービスクラスは,JAX-WS 2.2仕様に従ってマッピングされます。マッピング例を次の図に示します。

図15-12 サービスおよびポートとサービスクラスのマッピング例

[図データ]

また,WSDLのサービスおよびポートは,スケルトンクラスにもマッピングされます。マッピング例を次の図に示します。

図15-13 サービスおよびポートとスケルトンクラスのマッピング例

[図データ]

(2) サービス名およびポート名の条件

サービス名およびポート名には,次の表に示すすべての条件を満たす文字列を記述できます。ただし,バインディング宣言でカスタマイズする場合は,XML Schema仕様のxsd:NCName型として使用できる文字列を記述できます。

表15-18 サービス名およびポート名に記述できる文字列の条件

項番条件不正な文字列の例不正な文字列を指定した場合の動作
1半角英数字(0~9,A~Z,a~z),およびアンダースコア(_)だけを使用した文字列鈴木_service
鈴木_port
動作は保証されません(エラーメッセージは出力されません)。
2先頭が数字以外の文字列1User_service
1User_port
標準エラー出力とログにエラーメッセージが出力され,処理が終了されます(KDJW51029-E)。