WebSphere Application Server Version 6.1 Feature Pack for Web Services   
             オペレーティング・システム: AIX , HP-UX, i5/OS, Linux, Solaris, Windows, Windows Vista, z/OS

             目次と検索結果のパーソナライズ化
             New or updated topic for this feature pack

WSDL ファイルからの JAX-WS アプリケーション用 Java 成果物の作成

JAX-WS ツールを使用することにより、WSDL ファイルから開始する際に、 JAX-WS Web サービスの作成に必要な Java 成果物を生成できます。

始める前に

Web サービス記述言語 (WSDL) ファイルから開始する Java API for XML-based Web Services (JAX-WS) Web サービスの開発にトップダウン開発アプローチを使用する場合、 WSDL ファイルの Uniform Resource Locator (URL) を取得する必要があります。

[Windows] [z/OS] WSDL ファイルがローカル・ファイルである場合、URL は file:drive:¥path¥file_name.wsdl のようになります。

[Linux] [AIX] [HP-UX] [Solaris] [i5/OS] WSDL ファイルがローカル・ファイルである場合、URL は file:/path/file_name.wsdl のようになります。

また、絶対または相対ファイル・システム・パスを使用してローカル・ファイルを指定することもできます。

このタスクについて

JAX-WS ツールの wsimport を使用して WSDL ファイルを処理し、 Web サービス・クライアントの作成に使用される移植可能な Java 成果物を生成します。 wsimport ツールを使用して作成される移植可能な Java 成果物は以下のとおりです。

プロシージャー

wsimport -keep -verbose wsdl_URL コマンドを実行して、 移植可能な成果物を生成します。 wsimport ツールは、 app_server_root¥bin¥ ディレクトリーにあります。-verbose オプションを指定しているため、 生成されたすべてのファイルのリストが、コマンドを実行したときに表示されます。

結果

JAX-WS Web サービスの作成に必要な Java 成果物が得られました。

以下の例は、移植可能な成果物を生成するために、wsimport コマンドを使用して サンプルの Ping WSDL ファイルを処理する方法を示しています。
  1. 以下の ping.wsdl WSDL ファイルを app_server_root¥bin¥ ディレクトリーにコピーします。
    <?xml version="1.0" encoding="UTF-8"?>
    <!--
     * This program may be used, run, copied, modified and distributed
     * without royalty for the purpose of developing, using, marketing, or distributing.
     -->
    <wsdl:definitions xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
    xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
    	xmlns:tns="http://com/ibm/was/wssample/sei/ping/"
    	xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="PingService"
    	targetNamespace="http://com/ibm/was/wssample/sei/ping/">
    <wsdl:types>
    <xsd:schema
    			targetNamespace="http://com/ibm/was/wssample/sei/ping/"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    
    
    			<xsd:element name="pingStringInput">
    	<xsd:complexType>
    			<xsd:sequence>
    						<xsd:element name="pingInput" type="xsd:string" />
    			</xsd:sequence>
    		</xsd:complexType>
    </xsd:element>
    </xsd:schema>
    </wsdl:types>
    	<wsdl:message name="pingOperationRequest">
    		<wsdl:part element="tns:pingStringInput" name="parameter" />
    	</wsdl:message>
    	<wsdl:portType name="PingServicePortType">
    		<wsdl:operation name="pingOperation">
    			<wsdl:input message="tns:pingOperationRequest" />
    
    	</wsdl:operation>
    </wsdl:portType>
    	<wsdl:binding name="PingSOAP" type="tns:PingServicePortType">
    		<soap:binding style="document"
    			transport="http://schemas.xmlsoap.org/soap/http" />
    		<wsdl:operation name="pingOperation">
    			<soap:operation soapAction="pingOperation" style="document" />
    <wsdl:input>
    				<soap:body use="literal" />
    </wsdl:input>
    	</wsdl:operation>
    </wsdl:binding>
    	<wsdl:service name="PingService">
    		<wsdl:port binding="tns:PingSOAP" name="PingServicePort">
    <soap:address
    				location="http://localhost:9080/WSSampleSei/PingService" />
    </wsdl:port>
    </wsdl:service>
    </wsdl:definitions>
    
  2. app_server_root¥bin¥ ディレクトリーから wsimport コマンドを実行します。
    [Windows]
    app_server_root¥bin¥wsimport -keep -verbose ping.wsdl
    [Linux] [AIX] [HP-UX] [Solaris] Linux および UNIX ベースのプラットフォームでは、親シェルにスクリプトを 提供 し、. /app_server_root>/bin ディレクトリーから次のコマンドを実行することにより、エクスポートされた変数を継承します。
    . ./setupCmdLine.sh (ピリオド間のスペースに注意してください。)
    次の wsimport コマンドを実行します。
    app_server_root/bin/wsimport -keep -verbose ping.wsdl 
wsimport コマンドを使用してテンプレート・ファイルを生成すると、 以下のファイルが生成されます。
com¥ibm¥was¥wssample¥sei¥ping¥ObjectFactory.java
com¥ibm¥was¥wssample¥sei¥ping¥package-info.java
com¥ibm¥was¥wssample¥sei¥ping¥PingServicePortType.java
com¥ibm¥was¥wssample¥sei¥ping¥PingStringInput.javacom¥ibm¥was¥wssample¥sei¥ping¥PingService.java

ObjectFactory.java ファイルには、Java コンテンツ・インターフェース、および関連の ping パッケージに生成された Java エレメント・インターフェース別にファクトリー・メソッドが含まれています。 package-info.java ファイルは targetNamespace の値を使用し、ディレクトリー構造を作成します。 PingServicePortType.java ファイルは、生成されたサービス・エンドポイント・インターフェース (SEI) クラスであり、ping メソッド定義を含みます。 PinStringInput.java ファイルには、JAXB 生成のタイプ値が含まれています。 これらの値は XML スキーマ・タイプからマップされる Java クラスです。 PingService.java ファイルは、生成されたサービス・プロバイダーのクラス・ファイルであり、 JAX-WS クライアントによって使用されます。

次の作業

JavaBeans インプリメンテーションを完了します



サブトピック
JAX-WS アプリケーション用の wsimport コマンド
関連概念
JAX-WS
タスク・トピック    

ご利用条件 | フィードバック

最終更新: Jan 21, 2008 4:10:06 PM EST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.wsfep.multiplatform.doc/info/ae/ae/twbs_jaxwsfromwsdl.html