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
ヘルプ情報を表示します。

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

必須引数:
-createEar<name of target ear file>
作成する EAR ファイルの完全修飾パス名を指定します。ファイルが既に存在する場合は、 新しいファイルで上書きする前に、.ear~ という拡張子でバックアップされます。
-clientType <application | servlet | EJB>
実装するクライアントのタイプを指定します。
-ri
クライアントのリモート・インターフェースの名前を指定します。 この名前は完全修飾パッケージ名でなければなりません。 -clientType EJB を指定する場合には、この引数は必須です。 他のすべてのタイプに対しては、この引数は無効です。
-main
クライアントのメイン・クラスの名前を指定します。 この名前は完全修飾パッケージ名でなければなりません。 <Application | Servlet> を指定する場合には、この引数は必須です。 他のすべてのタイプに対しては、この引数は無効です。
<ProjectDir>
WSDL2Client のステージ 1、 または Bean2WebService などの他のツールのいずれかによって作成されたプロジェクト・ディレクトリーのパス名です。 このディレクトリーには、 クライアントのコンパイル済み実装のクライアント・サイド・ディレクトリーが含まれていなければなりません。
オプションの引数:
-verbose
このツールの実行中に追加情報を表示します。
-help
ヘルプ情報を表示します。
注 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, 2004. All Rights Reserved. (C) Copyright IBM Japan 2005