26.3 wsdl:import要素の書式

wsdl:import要素の書式例を次に示します。

<wsdl:import namespace="インポート対象のWSDL定義の名前空間名"
location="インポート対象のWSDL定義のロケーション"/>

wsdl:import要素の属性について,それぞれ説明します。

<この節の構成>
(1) namespace属性(wsdl:import要素)
(2) location属性(wsdl:import要素)

(1) namespace属性(wsdl:import要素)

インポート対象のWSDL定義の名前空間名を指定します。

インポート元のWSDL定義に記述するwsdl:import要素のnamespace属性には,インポート対象のWSDL定義の名前空間名(wsdl:definitions要素のtargetNamespace属性)と同じ名前空間名を指定してください。

インポート元のWSDL定義の名前空間と,インポート対象のWSDL定義の名前空間の関係を次の表に示します。

表26-1 WSDL定義の名前空間の関係(インポート元/インポート対象)

項番インポート元のWSDL定義インポート対象のWSDL定義条件実行時の動作
1wsdl:import要素のnamespace属性wsdl:definitions要素のtargetNamespace属性一致正常終了します。
2不一致標準エラー出力とログに警告メッセージが出力され,処理が続行されます(KDJW51191-W)。
インポート対象のWSDL定義およびインポート元のWSDL定義の要素は,それぞれの名前空間に属します。
3wsdl:definitions要素のtargetNamespace属性一致標準エラー出力とログに警告メッセージが出力され,処理が続行されます(KDJW51192-W)。インポート対象のWSDL定義およびインポート元のWSDL定義の要素は,同じ名前空間に属します。
4不一致正常終了します。

(2) location属性(wsdl:import要素)

インポート対象のWSDL定義のロケーションを指定します。

location属性に指定する文字列の条件を次に示します。

location属性の記述例を次の表に示します。

表26-2 location属性の指定例(WSDLインポート機能)

項番指定内容指定例
1ローカルにあるWSDLファイルを相対パスで指定※1./wsdl/input.wsdl
2ローカルにあるWSDLファイルをURL(file://~)で表現する絶対パスで指定※1,※2file:///C:/tmp/wsdl/input.wsdl
3リモートにあるWSDLファイルをURL(http:~)で指定※3http://example.com:8080/fromjava/test?wsdl
注※1
WSDLファイルを相対パスまたは絶対パスで指定する場合は,正しいパスを指定してください。パスを間違えてWSDLファイルが見つからない場合は,標準エラー出力とログにエラーメッセージが出力され,処理が終了されます(KDJW51197-EまたはKDJW51198-E)。
注※2
"C:/~"のようにドライブ指定で始まる絶対パスの文字列は指定できません。指定した場合,標準エラー出力とログにエラーメッセージが出力され,処理が終了されます(KDJW51199-E)。
注※3
リモートのWSDLファイルをURLで指定する場合は,正しいURLを指定してください。パスを間違えて,WSDLファイルが見つからない場合は,標準エラー出力とログにエラーメッセージが出力され,処理が終了されます(KDJW51197-EまたはKDJW51198-E)。