WSDL2Client ツール・リファレンス

WSDL2Client ツールは、Web サービスの WSDL 文書からクライアントを生成します。 

構文

コマンド行をセットアップした後、次の構文と引数を使用してこのツールを実行できます。 

スケルトンのクライアント実装を作成するには、以下を入力します。
  • <WSDL URI> は最後の引数でなければなりません。
  • スケルトンの Web サービス・クライアント実装を作成するときに、-createEar 引数を正常に実行するには、-clientType 引数を指定しなければなりません。
クライアント・アーカイブを作成するには、次のコマンドを実行します。

引数

スケルトンのクライアント実装を作成するには、以下を入力します。

必須引数:

-project <ProjectName>
出力のターゲット・プロジェクト・ディレクトリーの完全修飾パス名を指定します。このディレクトリーが存在しない場合は、WSDL2Client によって作成されます。デフォルトは現行ディレクトリーです。
<WSDL-URI>
WSDL 文書の場所を URI として指定します。この URI は、リモート・ファイル・システムでも ローカル・ファイル・システムでもかまいません。WSDL が複数の WSDL 文書に分割されている場合は、 インポート・チェーンの先頭の文書、通常は実装 WSDL を指定する必要があります。

オプショナル引数:

-NSToPkg <mappings>
ネームスペース=パッケージのマッピングのリストを指定します。
-fileNSToPkg <mappings file>
ネームスペース=パッケージのマッピングを含むプロパティー・ファイルへのパスを 指定します。このファイルでは、ネームスペース中のコロン (':') を円記号 (¥) で エスケープする必要があることに注意してください。たとえば、http¥://my.namespace の ように指定します。WSDL2Client は、エスケープされていないコロンを含むすべての ネームスペース参照を無視します。
-all
WSDL 文書に定義されたすべての複合タイプの Java™ クラスを生成します。デフォルトでは、WSDL 文書で定義および参照の両方が行われているクラスのみが生成されます。
-genResolver
インポート・リゾルバーを生成します。インポート・リゾルバーには、 インポートされた xsd (XML スキーマ) ファイルからのすべての情報が含まれています。このパラメーターについて詳しくは、注 1 を参照してください。
-wsSecDir <directory>
WS セキュリティーの情報を使用して EJB2WebService により生成されたデプロイメント記述子を構成するための使用されるテンプレートを含むディレクトリーへの絶対パスを指定します。このディレクトリー には、ibm-webservices-bnd.xmi ファイルと ibm-webservices-ext.xmi ファイルが含まれていなければ なりません。クライアント・サイド・バインディングを生成する場合は、ibm-webservicesclient-bnd.xmi ファイルと ibm-webservicesclient-ext.xmi ファイルも含まれていなければなりません。
-clientType <J2SE | Application | Servlet | EJB>
指定したクライアントのタイプに対するスケルトン実装クラスを生成します。この引数は、-genMain 引数と 組み合わせて使用する必要があります。
-genMain <name of main class>
生成するメイン・クラスの名前を指定します。この引数は、-clientType 引数と組み合わせて使用する必要があります。
-user
WSDL の URI にアクセスするために使用するユーザー名を指定します。
-password
WSDL の URI にアクセスするために使用するパスワードを指定します。
-verbose
このツールの実行中に追加情報を表示します。
-help
ヘルプ情報を表示します。
-clientName <client name>
<ProjectDirectory> にある <client name> ディレクトリーの下にクライアントを生成します。
-overwrite
既存のクライアント・ディレクトリーを上書きします。

クライアント・アーカイブを作成するには、次のコマンドを実行します。

必須引数:
-createEar<name of target ear file>
作成する EAR ファイルの完全修飾パス名を指定します。ファイルがすでに存在する場合は、 新しいファイルで上書きする前に、.ear~ という拡張子でバックアップされます。
-clientType <application | servlet | EJB>
実装するクライアントのタイプを指定します。
-ri
クライアントのリモート・インターフェースの名前を指定します。この名前は、完全修飾パッケージ名でなければなりません。-clientType EJB を指定する場合には、この引数は必須です。他のすべてのタイプに対しては、この引数は無効です。
-main
クライアントのメイン・クラスの名前を指定します。この名前は、完全修飾パッケージ名でなければなりません。<Application | Servlet> を指定する場合には、この引数は必須です。他のすべてのタイプに対しては、この引数は無効です。
<ProjectDir>
WSDL2Client のステージ 1、または Bean2WebService などの他のツールのいずれかによって作成された プロジェクト・ディレクトリーのパス名です。このディレクトリーには、クライアントのコンパイル済み実装のクライアント・サイド・ディレクトリーが含まれていなければなりません。
オプショナル引数:
-verbose
このツールの実行中に追加情報を表示します。
-help
ヘルプ情報を表示します。
-rootModule <root module base name>
同じタイプのクライアントの個々の Web サービス・クライアントを、単一のモジュール内にマージしてまとめます。クライアントが -clientName オプションで生成される場合のみ有効です。Web モジュールには <root module base name>_WEB.war という名前が付けられ、EJB クライアント・モジュールには <root module base name>_EJB.jar という名前が付けられ、アプリケーション・クライアント・モジュールには <root module base name>_APP.jar という名前が付けられます。
注 1: Web サービスの実行時にインターネットに接続しなくてもよいように、-genResolver 引数を選択してリモートの絶対参照ローカルを立ち上げるだけです。ローカルまたは相対インポートの場合には、使用しないでください。 また XSD ファイルをインポートする WSDL インポートを含む WSDL ファイルには -genResolver オプションを使用しないでください。 たとえば、スキーマ・エレメントの外で WSDL インポートを持つのではなく、以下のようにします。
  <import location="a.xsd" namespace="http://namespaceA"/>
  <types>
    <schema xmlns="http://www.w3.org/2001/XMLSchema"
      targetNamespace="http://namespaceA" 
      xmlns:xsd="http://www.w3.org/2001/XMLSchema">
これは、スキーマ・エレメント内部のスキーマ・インポートで置き換えられます。
  <types>
    <schema xmlns="http://www.w3.org/2001/XMLSchema"
      targetNamespace="http://namespaceA" 
      xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <import schemaLocation="a.xsd" namespace="http://namespaceA"/>
ご利用条件 | フィードバック
(C) Copyright IBM Corporation 1999, 2005. All Rights Reserved.
(C) Copyright IBM Japan 2005.