26.3.1 書式と説明
wsdl:import要素の書式例を次に示します。
<wsdl:import namespace="インポート対象のWSDL定義の名前空間名" location="インポート対象のWSDL定義のロケーション"/>
wsdl:import要素の属性について,それぞれ説明します。
(1) namespace属性(wsdl:import要素)
インポート対象のWSDL定義の名前空間名を指定します。
インポート元のWSDL定義に記述するwsdl:import要素のnamespace属性には,インポート対象のWSDL定義の名前空間名(wsdl:definitions要素のtargetNamespace属性)と同じ名前空間名を指定してください。
インポート元のWSDL定義の名前空間と,インポート対象のWSDL定義の名前空間の関係を次の表に示します。
項番 |
インポート元のWSDL定義 |
インポート対象のWSDL定義 |
条件 |
実行時の動作 |
---|---|---|---|---|
1 |
wsdl:import要素のnamespace属性 |
wsdl:definitions要素のtargetNamespace属性 |
一致 |
正常終了します。 |
2 |
不一致 |
標準エラー出力とログに警告メッセージが出力され,処理が続行されます(KDJW51191-W)。 インポート対象のWSDL定義およびインポート元のWSDL定義の要素は,それぞれの名前空間に属します。 |
||
3 |
wsdl:definitions要素のtargetNamespace属性 |
一致 |
標準エラー出力とログに警告メッセージが出力され,処理が続行されます(KDJW51192-W)。インポート対象のWSDL定義およびインポート元のWSDL定義の要素は,同じ名前空間に属します。 |
|
4 |
不一致 |
正常終了します。 |
(2) location属性(wsdl:import要素)
インポート対象のWSDL定義のロケーションを指定します。
location属性に指定する文字列の条件を次に示します。
-
URLの形式で相対パス,リモート,またはローカルにあるWSDLファイルを指定できます。
-
WARファイルに含まれるWSDLファイルは,メタデータとして発行されます(WSDLファイルを新たに生成する場合は除きます)。ただし,メタデータを発行するときに注意事項があります。メタデータを発行するときの注意事項については,「10.6.6 WSDL定義またはXML Schemaをインポート/インクルードしている場合の注意」を参照してください。
-
RFC 2396で規定される文字およびxsd:anyURIを満たす文字を使用してください。また,RFC 2732(IPv6アドレス)の規則に従った文字列も使用できます。
-
大文字と小文字は区別されません。
-
指定できる文字列の最大長の制限はありません。ただし,OSの制限を超えた場合は,エラーとなります。
location属性の記述例を次の表に示します。
項番 |
指定内容 |
指定例 |
---|---|---|
1 |
ローカルにあるWSDLファイルを相対パスで指定※1 |
./wsdl/input.wsdl |
2 |
ローカルにあるWSDLファイルをURL(file://〜)で表現する絶対パスで指定※1,※2 |
file:///C:/tmp/wsdl/input.wsdl |
3 |
リモートにあるWSDLファイルをURL(http:〜)で指定※3 |
http://example.com:8080/fromjava/test?wsdl |