wsgen
ツールは、JAX-WS Web サービスで使用される JAX-WS ポータブルアーティファクトを生成します。このツールは、サービスエンドポイント実装クラス (SEI) を読み取り、Web サービスの配備と呼び出しに必要なすべてのアーティファクトを生成します。
wsgen [options] <SEI>
次の表に、wsgen
のオプションを示します。
表 1-1 wsgen のオプション
オプション |
説明 |
---|---|
|
入力クラスファイルの検索場所を指定します |
|
|
|
生成される出力ファイルを格納する場所を指定する |
|
ベンダー拡張 (仕様で規定されていない機能) を許可します。拡張を使用すると、アプリケーションの移植性が失われたり、ほかの実装との相互運用が行えなくなる可性があります |
|
ヘルプを表示します |
|
生成されたファイルを保持します |
|
常に -wsdl オプションと組み合わせて使用します。WSDL などの生成されたリソースファイルの格納場所を指定します |
|
生成されるソースファイルを格納する場所を指定する |
|
コンパイラが実行している処理に関するメッセージを出力します |
|
バージョン情報を出力します。このオプションを使用した場合、バージョン情報が出力されるだけです。通常の処理は実行されません。 |
-wsdl[:protocol] |
wsgen はデフォルトでは WSDL ファイルを生成しません。このフラグは省略可能ですが、指定した場合は wsgen が WSDL ファイルを生成するようになります。このフラグは通常、エンドポイントの配備前に開発者が WSDL を参照できるようにするためだけに使用されます。protocol は省略可能であり、wsdl:binding で使用すべきプロトコルを指定するために使用されます。有効なプロトコルは次のとおりです。 soap1.1 と Xsoap1.2 。デフォルトは soap1.1 です。Xsoap1.2 は標準ではないため、-extension オプションと組み合わせないと使用できません。 |
|
常に |
|
常に |
wsgen
ツールには、このツール用の Ant タスクが付属しています。この Ant タスクがサポートする属性や要素を、次に示します。
<wsgen sei="..." destdir="directory for generated class files" classpath="classpath" | cp="classpath" resourcedestdir="directory for generated resource files such as WSDLs" sourcedestdir="directory for generated source files" keep="true|false" verbose="true|false" genwsdl="true|false" protocol="soap1.1|Xsoap1.2" servicename="..." portname="..."> extension="true|false" <classpath refid="..."/> </wsgen>
属性 |
説明 |
コマンド行 |
|
サービスエンドポイント実装クラスの名前 |
SEI |
|
生成される出力クラスを格納する場所を指定します |
|
|
入力クラスファイルの検索場所を指定します |
|
|
|
|
|
常に -wsdl オプションと組み合わせて使用します。WSDL などの生成されたリソースファイルの格納場所を指定します |
|
|
生成されるソースファイルを格納する場所を指定する |
|
|
生成されたファイルを保持します |
|
|
コンパイラが実行している処理に関するメッセージを出力します |
|
|
WSDL ファイルを生成すべきかどうかを指定します |
|
|
|
|
|
genwsdl オプションと組み合わせて使用します。生成される WSDL の |
|
|
genwsdl オプションと組み合わせて使用します。生成される WSDL の |
|
|
ベンダー拡張 (仕様で規定されていない機能) を許可します。拡張を使用すると、アプリケーションの移植性が失われたり、ほかの実装との相互運用が行えなくなる可性があります |
|
classpath
属性は、path-like structure であり、入れ子になった
<classpath>
要素を使って設定することもできます。このタスクを使用するには、次の
<taskdef>
要素をプロジェクトに追加しておく必要があります。
<taskdef name="wsgen" classname="com.sun.tools.ws.ant.WsGen">
<classpath path="jaxws.classpath"/>
</taskdef>
ここで、jaxws.classpath
は、JAX\-WS ツールが必要とするクラスのリストを含む、ビルド環境内の別の場所に定義された path-like structure への参照です。
<wsgen resourcedestdir="${wsdl.dir}" sei="fromjava.server.AddNumbersImpl"> <classpath refid="compile.classpath"/> </wsgen>
Copyright © 2006 Sun Microsystems, Inc.All Rights Reserved. |
Java Software |