コマンド行から Bean2WebService ツールを使用すると、IBM® WebSphere® ランタイム環境を
使用して、Java™
Bean から Web サービスを生成することができます。
構文
一度コマンド行をセットアップすると、次の構文と引数を使用して、
ツールを実行できます。
- Windows: Bean2WebService
[<optional arguments>] -cp <Classpath> -project <ProjectName> <BeanName>
- Linux: Bean2WebService.sh
[<optional arguments>] -cp <Classpath> -project <ProjectName> <BeanName>
注: 引数 <BeanName> は、最後に置く必要があります。
引数
必須引数:
- -project <ProjectName>
- プロジェクト名を指定します。生成されたすべてのファイルが保管される現行作業ディレクトリーの下に
ディレクトリーを作成する場合に使用します。このプロジェクト名が既に存在する場合は、既存の EAR ファイルのバックアップ・コピーが
作成されます。例えば、MyWebService という名前のプロジェクトがある場合、MyWebService.ear ファイルは MyWebService.ear.backup にリネームされます。
- -cp <ClassPath>
- Java
Bean とその実行に必要なすべての依存性が含まれる、JAR ファイルおよび
ディレクトリーのリスト (プラットフォーム固有のパス区切り文字で区切ります) を指定します。
- <BeanName>
- Web サービスとして公開する、コンパイル済み Java クラスの
完全修飾パッケージ名を指定します。-g オプションを
使用して Java クラスを
コンパイルすると、
- 生成された WSDL ファイルのパーツ名属性に、
メソッドの正しいパラメーター名が含まれるようになります。
オプション引数:
- -methods <method list>
- Java Bean の
非静的なパブリック・メソッドのうち、Web サービスで公開するものを指定します。デフォルトでは、すべてのメソッドがここに含まれます。
<method list> 内のメソッドは、スペースで区切ってください。
- -clientType <J2SE | Application | Servlet | EJB>
- 指定したクライアント・タイプのスケルトン実装クラスを生成します。
この引数は、必ず -genMain 引数と一緒に使用します。
-server-side-only 引数を既に指定している場合は、
この引数は使用できません。
- -genMain <name of main class>
- 生成するメイン・クラスの名前を指定します。この引数は、
必ず -clientType 引数と一緒に使用します。 -server-side-only 引数を既に指定している場合は、
この引数は使用できません。
- -voidReturn [ONEWAY | TWOWAY]
- void 戻りメソッドを要求/応答操作 (デフォルト) にするか、
片方向操作にするかを指定します。
- -host <hostName:portNumber>
- ホスト名とポート番号を指定します。デフォルト値は localhost:6080 です。
- -contextRoot <ContextRoot>
- Web サービスのコンテキスト・ルートを指定します。デフォルト値は <ProjectName> です。
- -servicePortName <PortName>
- Web サービスのポート名を指定します。デフォルト値は、Java
Bean の名前です。
サービス・エンドポイントの URL を指定するには、
引数 -host、-contextRoot、
および -servicePortName を使用します。
フォーマットは次のとおりです。http://HostName:PortNumber/<ContextRoot>/services/<PortName>
- -sei <endpoint interface>
- 事前に作成されたサービス・エンドポイント・インターフェース (Java ソース・コード・ファイル) の完全修飾パス名を指定します。何も指定しない場合は、ツールが実行時に
動的に生成します。
- -server-side-only
- サーバー・サイド・ヘルパー・クラスのみを生成します。デフォルトでは、
サーバー・サイドだけではなくクライアント・サイドのヘルパー・クラスも生成されます。
- -clientEJBName <EJB client filename>
- クライアント EJB ファイル内の情報を使用して、クライアント・サイドの webservicesclient.xml 記述子を、
クライアント・アプリケーションの名前で構成します。
このオプションを指定しない場合は、webservicesclient.xml を手動で編集してから、
それをクライアント EJB ファイルに追加する必要があります。
- -style <style type>
- <style type> で指定したスタイル ( RPC、Doc、
または Wrapped) の WSDL を生成します。デフォルト・スタイルは
Wrapped です。-style=DOC を
設定すると、アンラップされた WSDL が生成されることに注意してください。
- -use <bindings>
- <bindings> の指定に従って、
バインディングが literal または encoded の WSDL を
生成します。デフォルトは literal です。
- -splitWsdl
- デプロイされていない、個別のインターフェースおよび実装 WSDL 文書を
生成します。デフォルトでは、インターフェースと実装の情報を結合した
単一の文書が作成されます。
- - wsSecDir <directory>
- WS-Security 情報で生成されたデプロイメント記述子を構成するテンプレートが
含まれているディレクトリーの絶対パスを指定します。このディレクトリーには、
ibm-webservices-bnd.xmi ファイルと ibm-webservices-ext.xmi ファイルが含まれている
必要があり、クライアント・サイドのバインディングを生成する場合は、
ibm-webservicesclient-bnd.xmi と ibm-webservicesclient-ext.xmi も
含まれている必要があります。
- -PkgtoNS <package> <namespace>
- Java パッケージの名前空間へのマッピングを指定します。パッケージに
名前空間が存在しない場合は、適切な名前空間名が生成されます。
この引数を繰り返すことにより、複数のパッケージのマッピングを指定することができます。
- -verbose
- ツールの実行時に追加情報を表示します。
- -help
- ヘルプ情報を表示します。
注: -deploy オプションは
サポートされていません。