|
|
|
|
|
|
|
|
|
|
|
|
setDomainEnv.cmd コマンドを実行します。WebLogic Server ドメインのデフォルトの位置は、BEA_HOME\user_projects\domains\domainName です。BEA_HOME は BEA Products の最上位のインストール ディレクトリで、domainName はドメインの名前です。
setDomainEnv.sh コマンドを実行します。WebLogic Server ドメインのデフォルトの位置は、BEA_HOME/user_projects/domains/domainName です。BEA_HOME は BEA Products の最上位のインストール ディレクトリで、domainName はドメインの名前です。
build.xml というファイルを作成します。 clean というターゲットを 1 つ指定した簡単な build.xml ファイルの例を示します。
<delete>
<fileset dir="tmp" />
</delete>
</target>
clean ターゲットにより、temp サブディレクトリ内のすべてのファイルが削除されます。
build.xml ファイルで Ant タスクを指定する例は後の節で紹介します。
<taskdef> 要素および <target> 要素を使用して、適切なタスク定義とターゲットを build.xml に追加します。次の例では、jwsc Ant タスクをビルド ファイルに追加する方法を示します。ここでは、分かりやすくするためにタスクの属性を省いています。
classname="weblogic.wsee.tools.anttasks.JwscTask" />
<jwsc attributes go here...>
...
</jwsc>
</target>
<taskdef> 要素の name 属性値を変更すれば、WebLogic Web サービス Ant タスクに任意の名前を付けることができます。このマニュアルでは、整合性を考慮して jwsc、clientgen、および wsdlc という名前に統一しています。
build.xml ファイルと同じディレクトリで ant と入力し、ターゲットを指定して、Ant タスクまたは build.xml ファイルで指定されたタスクを実行します。
classpath 属性または要素を受け取ります。
jwsc Ant タスクの classpath 属性を使用して、新しいディレクトリを CLASSPATH 変数に追加する方法を示します。
classpath="${java.class.path};my_fab_directory"
...
</jwsc>
<classpath> 要素を使用して CLASSPATH に追加する方法を示します。
<classpath>
<pathelement path="${java.class.path}" />
<pathelement path="my_fab_directory" />
</classpath>
...
</jwsc>
<classpath> 要素を使用してタスク内でその変数を指定する方法を示します。
<pathelement path="${java.class.path}"/>
<pathelement path="${additional.path1}"/>
<pathelement path="${additional.path2}"/>
</path>
<classpath refid="myClassID" />
...
</jwsc>
\server\bin ディレクトリ (WL_HOME は WebLogic Server がインストールされている最上位ディレクトリ) にある ant (UNIX) または ant.bat (Windows) コンフィグレーション ファイルを使用して各種の Ant 固有変数を設定します。これらの Ant 変数を更新する必要がある場合、使用しているオペレーティング システム用のコンフィグレーション ファイルを変更します。
MyReturnType と MYRETURNTYPE) が指定されている場合、clientgen Ant タスクは、ユーザ定義データ型の Java 表現に対応する 2 つの別々の Java ソース ファイル セット (MyReturnType.java と MYRETURNTYPE.java) を適切に生成します。
MyReturnType.java と MYRETURNTYPE.java が同じ名前と判断されます。したがって、Windows でファイルをコンパイルすると、2 番目のクラス ファイルが最初のクラス ファイルを上書きしてしまい、クラス ファイルが 1 つしか残りません。しかし Ant タスクは 2 つのクラスがコンパイルされたものと認識しているので、次のようなエラーが発生することになります。
class MYRETURNTYPE is public, should be declared in a file named MYRETURNTYPE.java
public class MYRETURNTYPE
^
clientgen Ant タスクは、クライアント アプリケーションが WebLogic Web サービスと非 WebLogic Web サービスの両方の呼び出しに使用できるクライアント コンポーネント ファイルを既存の WSDL ファイルから生成します。クライアント コンポーネント ファイルには以下のものがあります。
Stub および Service インタフェースの Java ソース コード。
clientgen の生成されたアーティファクトを使用します。
classname="weblogic.wsee.tools.anttasks.ClientGenTask" />
classname="weblogic.wsee.tools.anttasks.ClientGenTask" />
wsdl="http://example.com/myapp/myservice.wsdl"
destDir="/output/clientclasses"
packageName="myapp.myservice.client"
serviceName="StockQuoteService" />
build_client ターゲットが実行されるときに、clientgen は、wsdl 属性で指定した WSDL ファイルを使用して、serviceName 属性で指定した Web サービスの呼び出しに必要なクライアントサイドのアーティファクトをすべて生成します。clientgen Ant タスクは、すべてのアーティファクトを /output/clientclasses ディレクトリに生成します。生成された Java コードは、すべて myapp.myservice.client パッケージにあります。clientgen が終了すると、javac Ant タスクは、clientgen が生成した Java コード、および生成されたアーティファクトを使用し、ユーザのビジネス コードを格納する独自のクライアント アプリケーションの Java コードをコンパイルします。
clientgen Ant タスクを実行します。しかし場合によっては、jwsc Ant タスクによって生成された WAR または JAR ファイルなどのアーカイブ ファイルにパッケージ化された静的な WSDL ファイル上で clientgen を実行することが必要になります。その場合は、以下の wsdl 属性の構文を使用する必要があります。
archive_file!WSDL_file"
archive_file はアーカイブ ファイルの完全な (または現在のディレクトリに対して相対的な) 名前、WSDL_file はアーカイブ ファイルのルート ディレクトリに対して相対的な WSDL ファイルの絶対パス名を表します。次に、例を示します。
wsdl="jar:file:output/myEAR/examples/webservices/simple/SimpleImpl.war!/WEB-INF/SimpleService.wsdl"
destDir="/output/clientclasses"
packageName="myapp.myservice.client"/>
clientgen を SimpleService.wsdl という静的な WSDL ファイル上で実行する方法を示しています。この WSDL ファイルは SimpleImpl.war という WAR ファイルの WEB-INF ディレクトリ内にパッケージ化されています。WAR ファイルは build.xml ファイルが格納されているディレクトリの output/myEAR/examples/webservices/simple サブディレクトリにあります。
clientgen Ant タスクの属性について説明します。
|
|
|
|
|
|
|
clientgen Ant タスクがクライアント ソース コード、WSDL ファイル、クライアント デプロイメント記述子ファイルを生成するディレクトリ。
META-INF、Web アプリケーションの場合は WEB-INF/classes、エンタープライズ アプリケーションの場合は APP-INF/classes) に設定する。スタンドアロン クライアントから Web サービスを呼び出す場合は、ユーザのクライアント アプリケーション コードと同じソース コード ディレクトリ階層内にクライアント コンポーネント ファイルを生成できる。
|
|
|
|
|
clientgen Ant タスクが、ポリシーをロードするメソッドを、生成された JAX-RPC スタブに格納するかどうかを指定する。これらのメソッドにより、クライアント アプリケーションはローカル ポリシー文をロードできる。
True を指定した場合、getXXXSoapPort() (XXX は Web サービス名) という 4 種類のメソッドが、JAX-RPC Service インタフェースの拡張機能として、生成されたクライアント スタブに追加される。クライアント アプリケーションは、これらのメソッドを使用すると、Web サービス自体でデプロイされたポリシー文を適用する代わりに、ローカル ポリシー文をロードして適用できる。クライアント アプリケーションは、着信 SOAP メッセージ、発信 SOAP メッセージ、または発着信双方の SOAP メッセージにローカル ポリシー文を適用するか、ローカル ポリシーを InputStream からロードするか URI からロードするかを指定できる。
True または False。デフォルト値は False で、追加メソッドは生成されないことを示す。
|
|
|
|
|
clientgen Ant タスクが、クライアント アプリケーションが Web サービスのオペレーションを非同期的に呼び出すために使用できるメソッドを、生成された JAX-RPC スタブに格納するかどうかを指定する。
True (デフォルト値) を指定し、WSDL に getQuote という Web サービス オペレーションがある場合、clientgen Ant タスクは、getQuoteAsync というメソッドを JAX-RPC スタブに生成する。クライアント アプリケーションは、元の getQuote メソッドの代わりにこのメソッドを呼び出す。この非同期的な種類のオペレーションには、クライアント アプリケーションが非同期プロパティやコンテキスト変数などを設定するための追加パラメータ (weblogic.wsee.async.AsyncPreCallContext データ型) も含まれる。
generateAsyncMethods 属性を True に設定しても、clientgen Ant タスクは非同期的な種類の JAX-RPC スタブを生成しない。
True または False。デフォルト値は True で、非同期メソッドが生成されることを示す。
|
|
|
|
|
True を指定すると、常に新しいアーティファクトが生成され、既存のアーティファクトがすべて上書きされる。
False を指定すると、既存のアーティファクトのタイムスタンプに基づき、変更のあったアーティファクトだけが上書きされる。
True または False。デフォルト値は True。
|
|
|
|
|
clientgen Ant タスクは、WSDL ファイルの targetNamespace に基づくパッケージ名を持つ Java ファイルを生成する。たとえば、targetNamespace が http://example.org の場合、パッケージには org.example またはそれに近い名前などが付けられる。パッケージ名を Ant タスクで自動的に付けるのではなく、任意に指定する場合は、この属性を指定する必要がある。
|
|
|
|
|
<service> 要素に一致する。
serviceName を CuteService に設定した場合、JAX-RPC マッピング ファイルは cuteService_java_wsdl_mapping.xml、WSDL のクライアントサイドのコピーは CuteService_saved_wsdl.wsdl となる。
|
|
<service> 要素が格納されている場合にのみ必須。
<service> 要素が WSDL ファイルに格納されている場合、Ant タスクはエラーを返す。
|
|
|
|
|
|
|
|
clientgen Ant タスクでドキュメントリテラル Web サービスのパラメータと戻り値の型が wrapped か bare かを判別するかどうかを指定する。
clientgen Ant タスクは、XML スキーマ要素の名前やオペレーションとパラメータの名前などに基づいて、ドキュメントリテラル Web サービスが wrapped パラメータを使用するか bare パラメータを使用するかを判別し、戻り値の型を識別する。これらのコンポーネント名がどのように照合されるかによって、clientgen Ant タスクは、パラメータが wrapped か bare かを推定する。ただし、Ant タスクでパラメータの型が常に bare と推定されるように指定することもできる。この場合、autoDetectWrapped 属性を False に設定する。
True または False。デフォルト値は True。
|
|
|
|
|
|
|
|
|
|
clientgen Ant タスクが、WSDL ファイルの XML スキーマのデータ型と同じ Java を生成しているときに、maxOccurs 属性が unbounded に指定された単一の要素を持つ単一の親シーケンスを格納した XML 複合型の存在が確認された場合、タスクは、親複合型または要素で最も下位の名前の Java 構造体をデフォルトで生成する。代わりにリテラル配列を生成するようにタスクの動作を変更するには、jaxRPCWrappedArrayStyle を False に設定する。
True または False。デフォルト値は True。
|
|
|
|
|
|
|
|
|
|
build.xml ファイルの別の場所で定義されているパスへの参照として指定する。
|
|
|
jwsc Ant タスクは、標準 (JSR-181) JWS アノテーションと WebLogic 固有の JWS アノテーションの両方を格納する Java Web サービス (JWS) ファイルを入力として取り、WebLogic Web サービスの作成に必要なアーティファクトをすべて生成します。生成されるアーティファクトには、以下のものがあります。
JWS_ClassNamePortType.java。JWS_ClassName は JWS クラス) など、標準の JSR-921 Web サービスを実装する Java ソース ファイル。webservices.xml と JAX-RPC マッピング ファイルに加え、jwsc Ant タスクでは、WebLogic 固有の Web サービス デプロイメント記述子 (weblogic-webservices.xml) も生成します。
jwsc Ant タスクは、Java ファイルおよび JWS ファイルをコンパイルします。次に、コンパイルされたクラスおよび生成されたアーティファクトを、デプロイ可能な JAR アーカイブ ファイルにパッケージ化します。最後に、その JAR ファイルを格納する、展開されたエンタープライズ アプリケーション ディレクトリを作成します。このエンタープライズ アプリケーションを WebLogic Server にデプロイします。既存のエンタープライズ アプリケーションを送り先のディレクトリとして jwsc に指定した場合、この Ant タスクは、既存の application.xml ファイルを新しい Web サービス情報で書き換えて更新します。
jwsc Ant タスクは通常、指定した JWS ファイルから Java クラスを実装した Web サービスを生成し、それを Web アプリケーションの WAR ファイルにパッケージ化します。ただし、以下の場合、ステートレス セッション EJB を実装した Web サービスが作成され、EJB JAR ファイルにパッケージ化されます。
weblogic.jws.Conversation、weblogic.jws.Conversational、weblogic.jws.ServiceClient のいずれかの JWS アノテーションを指定している場合。javax.ejb.SessionBean. を実装している場合。
jwsc Ant タスクが <jws> 子要素を使用してコンパイルする JWS ファイルを指定します。<jws> 要素には、Web サービスの呼び出しに使用する転送方法 (HTTP/S または JMS) を指定するための子要素 (省略可能) が 3 種類あります。
jwsc Ant タスクの完全な使用例については、「ユーザ定義のデータ型を使用する Web サービスの作成」を参照してください。
classname="weblogic.wsee.tools.anttasks.JwscTask" />
jwsc Ant タスクの使い方を示します。ここでは、build.xml Ant ファイルで、Web サービスを繰り返し開発する際に使用する build-service ターゲットに、このタスクを指定します。その他、WebLogic Web サービスを繰り返し開発する際に役立つ clean、deploy、client、run などのさまざまなターゲットを格納した build.xml ファイルの完全な例については、「一般的な Web サービスの使用例とサンプル」および「WebLogic Web サービスの反復的な開発」を参照してください。
jwsc の使い方を示します。
<jwsc
srcdir="src"
destdir="output/TestEar">
<jws file="examples/webservices/test/TestServiceImpl.java" />
</jwsc>
</target>
TestServiceImpl.java という JWS ファイルが build.xml ファイルを格納したディレクトリの src/examples/webservices/test サブディレクトリにあります。jwsc Ant タスクは、Web サービスのアーティファクトを output/TestEar サブディレクトリに生成します。jwsc Ant タスクでは、Web サービス JAR ファイルに加え、エンタープライズ アプリケーションを記述した application.xml ファイルも output/TestEar/META-INF ディレクトリに生成されます。
jwsc の使い方を示します。
<pathelement path="${myclasses-dir}"/>
<pathelement path="${java.class.path}"/>
</path>
<jwsc
srcdir="src" destdir="output/TestEar"
verbose="on" debug="on"
keepGenerated="yes"
classpathref="add.class.path">
<jws file="examples/webservices/test/TestServiceImpl.java" />
<jws file="examples/webservices/test/AnotherTestServiceImpl.java"/>
<jws file="examples/webservices/test/SecondTestServiceImpl.java" />
</jwsc>
</target>
jwsc が出力ディレクトリに既存の一時ファイルを生成しないように指定しています。また、classpathref 属性による標準 CLASSPATH への追加方法が示されています。ここでは、build.xml ファイルの別の場所で標準の Ant <path> ターゲットに指定されている add.class.path というパスを参照することで、CLASSPATH に追加しています。
<jwsc
srcdir="src"
destdir="output/TestEar">
contextPath="TestService" serviceUri="TestService"
portName="TestServicePort1"/>
</jws>
jwsc Ant タスクには、さまざまな属性と <jws> という子要素があります。<jws> 要素には、<WLHttpTransport>、<WLHttpsTransport>、<WLJMSTransport> という 3 種類の子要素 (省略可能) があります。転送要素の使用に関する概要については、「転送の子要素」を参照してください。
jwsc Ant タスクの階層を示しています。
jwsc Ant タスクの主な属性について説明します。
|
|
|
|
|
|
jwsc Ant タスクは、指定したディレクトリに、展開されたエンタープライズ アプリケーションを作成する。または、既存のアプリケーション ディレクトリを指定した場合は、アプリケーションを更新する。jwsc タスクは、Web サービスを実装する JAR ファイルまたは WAR ファイルをこのディレクトリに生成する他、META-INF ディレクトリの application.xml ファイルなどの必要なファイルを生成する。jwsc Ant タスクは、既存の application.xml ファイルがある場合はそれを更新し、既存のファイルがない場合は新たに作成する。別の application.xml をデフォルトから指定するには、applicationXML 属性を使用する。
|
|
|
|
no を指定すると、新しい Java ソース ファイルとアーティファクトが常に生成され、既存のアーティファクトがすべて上書きされる。
yes を指定すると、既存のアーティファクトのタイムスタンプに基づき、変更のあったアーティファクトだけが再生成される。
yes または no。デフォルト値は no。
|
|
|
|
sourcepath パス名は、絶対パスでも相対パスでも構わない。相対パスの場合は、Ant build.xml ファイルを格納するディレクトリを基準にする。
sourcepath が /src で、JWS ファイルが webservices.financial パッケージ内の MyType.java という JavaBean を参照している場合、MyType.java Java ファイルは /src/webservices/financial ディレクトリに格納されている。
srcdir 属性の値。つまり、デフォルトでは、JWS ファイルおよび JWS ファイルで参照されるオブジェクトは同じパッケージ内にある。デフォルトではない場合は、それに応じた sourcepath を指定する必要がある。
|
|
|
|
true (デフォルト値) に設定されている場合、WebLogic Server は、非同期 Web サービス機能を処理する内部モジュールを自動的にデプロイする。したがって、Web サービスでこの機能のいずれも使用しない場合は、WebLogic Server が不要な内部モジュールをデプロイしてリソースを無駄にしないように、この属性を false に設定することを考慮する。
true および false。デフォルト値は true。
|
|
|
|
on または off。デフォルト値は off で、冗長出力は無効。
|
|
|
|
<jws> 子要素の file 属性で指定) を格納している最上位ディレクトリの絶対パス。JWS ファイルは、そのパッケージ名に対応する srcdir ディレクトリのサブディレクトリ内にある。srcdir パス名は、絶対パスでも相対パスでも構わない。相対パスの場合は、Ant build.xml ファイルを格納するディレクトリを基準にする。
srcdir が /src で、MyService.java という JWS ファイルが webservices.financial パッケージ内にある場合、MyService.java JWS ファイルは /src/webservices/financial ディレクトリに格納されている。
|
|
|
|
|
|
|
|
build.xml ファイルの別の場所で定義されているパスへの参照として指定する。
|
|
|
|
build.xml ファイルの別の場所で定義されているパスへの参照として指定する。
|
|
|
|
off または on。デフォルト値は off で、メッセージは出力される。
|
|
|
|
on または off。デフォルト値は off。
|
|
|
|
on または off。デフォルト値は off。
|
|
|
|
yes または no。デフォルト値は yes。
|
|
|
|
yes または no。デフォルト値は no。
|
|
|
|
yes と no。デフォルト値は no。
|
|
|
|
true および false。デフォルト値は true。
|
|
|
|
java.io.tmpdir システム プロパティの値。
|
|
|
|
on と off。デフォルト値は off。
|
|
|
|
application.xml デプロイメント記述子の完全な名前および絶対パスを指定する。既存のファイルを指定した場合、jwsc Ant タスクは、Web サービス情報を含めるようにそのファイルを更新する。ファイルが存在しない場合、jwsc によってファイルが作成される。jwsc Ant タスクは、対応する weblogic-application.xml ファイルも同じディレクトリで作成または更新する。
jwsc は、destDir/META-INF/application.xml (destDir は jwsc 属性) ファイルを作成または更新する。
|
|
|
|
|
|
|
|
|
|
jwsc Ant タスクの <jws> 子要素では、特定の Web サービスを実装する JWS ファイルの名前を指定します。Ant タスクは、この Web サービス向けに Java コードとサポート アーティファクトを生成し、エンタープライズ アプリケーション内でデプロイ可能な JAR ファイルにパッケージ化します。
<jws> 要素を指定する必要があります。この要素を複数指定した場合、jwsc Ant タスクは、JWS ファイルごとに個別の Web サービスを生成します。それぞれの Web サービスは、個別の JAR ファイルにパッケージ化されます。
jwsc Ant タスクの <jws> 子要素の属性について説明します。
|
|
|
|
|
|
jwsc Ant タスクは、srcdir ディレクトリにあるファイルを検索する。
|
|
|
|
true または false。デフォルト値は false で、生成された JAR ファイルは JAR にアーカイブされ、展開ディレクトリ形式にはならない。
|
|
|
|
explode 属性が true に設定されている場合は展開ディレクトリ) で、デプロイ可能な Web サービスを格納しているファイルの名前。実際の JAR アーカイブ ファイルが生成されると、ファイル名には .jar または .war という拡張子も付けられる (拡張子がどちらになるかは、jwsc が EJB クラス実装を生成したか Java クラス実装を生成したかで異なる)。
file 属性で指定した JWS ファイルの名前。
|
|
|
|
com.bea.xml.XMLBeans パラメータまたは戻り値が記述されている XML スキーマ ファイルの絶対パス。
includeSchemas="po.xsd,customer.xsd"
com.bea.xml.XMLBeans データ型を使用している場合にのみサポートされる。XMLBeans データ型を使用していない場合、この属性を指定すると、jwsc Ant タスクはエラーを返す。
@SOAPBinding(
style=SOAPBinding.Style.DOCUMENT,
use=SOAPBinding.Use.LITERAL,
parameterStyle=SOAPBinding.ParameterStyle.BARE)
XMLBeans の詳細については、http://www.beasys.co.jp/dev2dev/technologies/xmlbeans/index.html を参照。
com.bea.xml.XMLBeans データ型を WebLogic Web サービスのパラメータまたは戻り値として使用することは非推奨。
|
XMLBeans データ型をパラメータまたは戻り値として使用する場合は必須
|
|
|
wsdlc Ant タスクで生成された JAR ファイルの絶対パス名。JAR ファイルには、この WSDL に基づいて Web サービスを実装する JWS インタフェース ファイルが含まれる。また、Java 表現と XML 表現の間でパラメータと戻り値を変換するためのデータ バインディング アーティファクトも含まれる。WSDL の XML スキーマ セクションは、データの XML 表現を定義する。
jwsc Ant タスクを実行し、この更新した JWS 実装ファイルの file 属性を使用して、デプロイ可能な Web サービスを生成する。
compiledWsdl 属性を使用しない。
|
|
|
|
destDir ディレクトリに生成される。ファイル名は JWS_ClassNameService.wsdl (JWS_ClassName は JWS クラス名)。JWS_ClassNameService は、生成された WSDL ファイルで Web サービスの名前にもなる。
true または false。デフォルト値は false で、WSDL ファイルだけでなく、すべてのアーティファクトが生成されることを示す。
|
|
@weblogic.jws.WLHttpTransport、@weblogic.jws.WLHttpsTransport、または @weblogic.jws.WLJMSTransport という形式のアノテーションを使用できます。JWS ファイルでは、いずれか 1 つのアノテーションのみを指定できます。ただし、JWS ファイルを記述している時点では、どの転送形式が JWS ファイルのニーズに適しているかを判別できない可能性があります。そのため、転送はビルド時に指定するのが最適な方法です。その際、<jws> の子要素のうち、以下の転送の子要素のいずれかを指定します。
jwsc Ant タスクに対する転送要素のいずれかまたは JWS ファイルの転送アノテーションとして転送を指定しなかった場合、Web サービスのデフォルト URL は、WLHttpTransport 要素のデフォルト値に対応します。また、jwsc に対して転送を指定すると、JWS ファイルの転送アノテーションがオーバーライドされます。
WLHttpTransport 要素では、生成された WSDL のポート名に加え、HTTP 転送形式で Web サービスを呼び出すために使用するコンテキスト パスおよび URL のサービス URI セクションを指定します。
<jws> 要素の <WLHttpTransport> 子要素の属性について説明します。
|
|
|
|
|
|
financial が、この Web サービスの contextPath に当たる。
HelloWorldImpl.java の場合、その contextPath のデフォルト値は HelloWorldImpl になる。
|
|
|
|
GetQuote が、この Web サービスの serviceUri に当たる。
HelloWorldImpl.java の場合、その serviceUri のデフォルト値は HelloWorldImpl になる。
|
|
|
|
<port> 要素の name 属性に対応している。
@javax.jws.WebService アノテーションに基づく。つまり、デフォルトの portName は、@WebService アノテーションの name 属性の値に SoapPort というテキストを付け加えた形になる。たとえば、@WebService.name が MyService に設定されている場合、デフォルトの portName は MyServiceSoapPort となる。
|
|
WLHttpsTransport 要素では、生成された WSDL のポート名に加え、セキュリティで保護された HTTPS 転送形式で Web サービスを呼び出すために使用するコンテキスト パスおよび URL のサービス URI セクションを指定します。
<jws> 要素の <WLHttpsTransport> 子要素の属性について説明します。
|
|
|
|
|
|
financial が、この Web サービスの contextPath に当たる。
HelloWorldImpl.java の場合、その contextPath のデフォルト値は HelloWorldImpl になる。
|
|
|
|
GetQuote が、この Web サービスの serviceUri に当たる。
HelloWorldImpl.java の場合、その serviceUri のデフォルト値は HelloWorldImpl になる。
|
|
|
|
<port> 要素の name 属性に対応している。
@javax.jws.WebService アノテーションに基づく。つまり、デフォルトの portName は、@WebService アノテーションの name 属性の値に SoapPort というテキストを付け加えた形になる。たとえば、@WebService.name が MyService に設定されている場合、デフォルトの portName は MyServiceSoapPort となる。
|
|
WLJMSTransport 要素では、生成された WSDL のポート名に加え、JMS 転送形式で Web サービスを呼び出すために使用するコンテキスト パスおよび URL のサービス URI セクションを指定します。また、JMS 転送用にコンフィグレーション済みの JMS キュー名および接続ファクトリ名も指定します。
<jws> 要素の <WLJMSTransport> 子要素の属性について説明します。
|
|
|
|
|
|
financial が、この Web サービスの contextPath に当たる。
HelloWorldImpl.java の場合、その contextPath のデフォルト値は HelloWorldImpl になる。
|
|
|
|
GetQuote が、この Web サービスの serviceUri に当たる。
HelloWorldImpl.java の場合、その serviceUri のデフォルト値は HelloWorldImpl になる。
|
|
|
|
<port> 要素の name 属性に対応している。
@javax.jws.WebService アノテーションに基づく。つまり、デフォルトの portName は、@WebService アノテーションの name 属性の値に SoapPort というテキストを付け加えた形になる。たとえば、@WebService.name が MyService に設定されている場合、デフォルトの portName は MyServiceSoapPort となる。
|
|
|
|
weblogic.wsee.DefaultQueue。その場合でも、Web サービスのデプロイ先となる WebLogic Server インスタンスで、この JMS キューを作成する必要がある。
|
|
wsdlc Ant タスクは、既存の WSDL ファイルを基に一連のアーティファクトを生成します。これらのアーティファクトをまとめて、WSDL ファイルで記述された Web サービスの部分的な Java 実装が提供されます。具体的には、この Ant タスクは以下のものを生成します。
@WebService や @SOAPBinding など) が含まれます。wsdlc Ant タスクは、WSDL ファイル内で最初に見つかった <service> 要素のアーティファクトを生成します。特定の WSDL <binding> を指定するには、srcBindingName 属性を使用します。
jwsc Ant タスクに対してこの JAR ファイルを指定する必要があるためです。
wsdlc Ant タスクで生成されます。 jwsc Ant タスクに対してこの JAR ファイルを指定する必要があるためです。
wsdlc Ant タスクを実行 (通常は 1 回だけ実行) したら、メソッドを目的どおりに実行するためにそのメソッドに Java コードを追加して、生成された JWS 実装ファイルを更新します。wsdlc Ant タスクは、WSDL ファイルを基に Web サービスの形式を認識していますが、その Web サービスをどのように実行するかについては認識していないので、最初は生成された JWS 実装ファイルにビジネス ロジックは含まれていません。
@WebService、@HandlerChain、@SOAPMessageHandler、および @SOAPMessageHandlers のみです。他の JWS-181 JWS アノテーションを指定した場合、JWS ファイルを Web サービスにコンパイルしようとすると、jwsc Ant タスクはエラーを返します。@WebService アノテーションで指定できるのは、serviceName 属性と endpointInterface 属性のみです。まれに、WSDL ファイルに複数の <service> 要素が指定されていることがあります。その場合は、serviceName 属性を使用して、wsdlc Ant タスクで使用していたものとは別の <service> WSDL 要素を指定します。wsdlc Ant タスクで生成された JWS インタフェースを指定するには、endpointInterface 属性を使用します。
jwsc Ant タスクを繰り返し実行して、Web サービスの完全な Java 実装を生成します。jwsc の compiledWsdl 属性を使用すると、JWS インタフェース ファイルとデータ バインディング アーティファクトを格納する wsdlc Ant タスクで生成された JAR ファイルを指定できます。この属性を指定すると、jwsc Ant タスクは、新しい WSDL ファイルを生成せず、JAR ファイル内の既存の WSDL ファイルを使用します。そのため、Web サービスをデプロイして、その WSDL を表示すると、デプロイされた WSDL は、ユーザが最初に開始した時点の WSDL とほとんど変わらないように見えます。
<address> 要素の location 属性の値です。デプロイされた WSDL は、デプロイされた Web サービスの実際のホスト名と URI を指定します。これは、ほぼ間違いなくオリジナルの WSDL の値とは違います。この違いは、静的 WSDL を基に実際の Web サービスをデプロイする際に現れると予想されます。
jwsc と組み合わせた wsdlc Ant タスクの完全な使用例については、「WSDL ファイルからの Web サービスの作成」を参照してください。
classname="weblogic.wsee.tools.anttasks.WsdlcTask"/>
build.xml ファイルの一部では、wsdlc と jwsc の 2 つの Ant タスクを組み合わせて WebLogic Web サービスをビルドする方法を示します。ビルド ファイルには、既存の WSDL ファイルに対して wsdlc Ant タスクを実行する generate-from-wsdl、および wsdlc Ant タスクで生成されたアーティファクトからデプロイ可能な Web サービスをビルドするために jwsc Ant タスクを実行する build-service という 2 種類のターゲットが指定されています。
<taskdef name="wsdlc"
classname="weblogic.wsee.tools.anttasks.WsdlcTask"/>
classname="weblogic.wsee.tools.anttasks.JwscTask" />
<wsdlc
srcWsdl="wsdl_files/TemperatureService.wsdl"
destJwsDir="output/compiledWsdl"
destImplDir="output/impl"
packageName="examples.webservices.wsdlc" />
srcdir="src"
destdir="output/wsdlcEar">
compiledWsdl="output/compiledWsdl/TemperatureService_wsdl.jar" />
wsdlc Ant タスクは、TemperatureService.wsdl ファイルを入力として取り、JWS インタフェースとデータ バインディング アーティファクトが格納された JAR ファイルを output/compiledWsdl ディレクトリに生成します。JAR ファイル名は TemperatureService_wsdl.jar です。この Ant タスクでは、途中まで作成済みの JWS インタフェースの実装を格納した JWS ファイルを output/impl/examples/webservices/wsdlc ディレクトリ (destImplDir 属性の値と、指定した packageName に対応するディレクトリ階層を組み合わせたもの) に生成します。途中まで作成済みの JWS 実装ファイルの名前は、最初の <service> 要素に対応する WSDL ファイルの <portType> 要素の名前に基づきます。たとえば、portType の名前が TemperaturePortType の場合、生成された JWS 実装ファイルは TemperaturePortTypeImpl.java という名前になります。
wsdlc を実行したら、途中まで作成済みの JWS 実装ファイルにビジネス ロジックを追加します。通常、この JWS ファイルを wsdlc 出力ディレクトリから、アプリケーションのソース コードを含む、より永続的なディレクトリに移動します。この例では、完全に記述された TemperaturePortTypeImpl.java JWS ファイルは src/examples/webservices/wsdlc/ ディレクトリに移動しています。次に、jwsc Ant タスクを実行し、この JWS ファイルを通常通りに指定します。ここで指定する必要がある唯一の追加属性が compiledWsdl です。この属性は、上記の例で示すように wsdlc Ant タスクで生成された JAR ファイルを指します。これは、JAR ファイルにコンパイルされているオリジナルの WSDL ファイルを使用するので、jwsc Ant タスクで WSDL ファイルを生成しないことを示します。
wsdlc Ant タスクの属性について説明します。
|
|
|
|
|
|
|
build.xml ファイルを格納するディレクトリを基準にする。
|
|
|
|
|
wsdlc Ant タスクは、WSDL ファイル内で最初に見つかった <service> 要素に対して実行される。したがって、この <service> 要素に関連付けられている <binding> 要素が複数ある場合でも、srcBindingName 属性を指定するだけで済む。
srcBindingName="MyBinding"
srcBindingName="{URI}BindingName"
MyBinding バインディングのネームスペース URI が www.examples.org であれば、次のように属性値を指定する。
srcBindingName="{www.examples.org}MyB inding"
|
|
<binding> 要素が格納されている場合のみ
|
|
|
wsdlc Ant タスクは、WSDL の targetNamespace に基づくパッケージ名を生成する。
|
|
|
|
|
WSDLFile_wsdl.jar (WSDLFile は WSDL ファイルのルート名)。たとえば、file 属性に対して指定した WSDL ファイルの名前が MyService.wsdl の場合、生成された JAR ファイルは MyService_wsdl.jar となる。
|
|
|
|
|
jwsc Ant タスクに対して、この更新された JWS ファイルを指定し、デプロイ可能な Web サービスを生成する。
|
|
|
|
|
|
|
|
|
|
wsdlc Ant タスクでドキュメントリテラル Web サービスのパラメータと戻り値の型が wrapped か bare かを判別するかどうかを指定する。
wsdlc Ant タスクは、XML スキーマ要素の名前やオペレーションとパラメータの名前などに基づいて、ドキュメントリテラル Web サービスが wrapped パラメータを使用するか bare パラメータを使用するかを判別し、戻り値の型を識別する。これらのコンポーネント名がどのように照合されるかによって、wsdlc Ant タスクは、パラメータが wrapped か bare かを推定する。ただし、Ant タスクでパラメータの型が常に bare と推定されるように指定することもできる。この場合、autoDetectWrapped 属性を False に設定する。
True または False。デフォルト値は True。
|
|
|
|
|
wsdlc Ant タスクが、WSDL ファイルの XML スキーマのデータ型と同じ Java を生成しているときに、maxOccurs 属性が unbounded に指定された単一の要素を持つ単一の親シーケンスを格納した XML 複合型の存在が確認された場合、タスクは、親複合型または要素で最も下位の名前の Java 構造体をデフォルトで生成する。代わりにリテラル配列を生成するようにタスクの動作を変更するには、jaxRPCWrappedArrayStyle を False に設定する。
True または False。デフォルト値は True。
|
|
|
|
|
wsdlc Ant タスクの実行を続行するかどうかを指定する。
true および false。デフォルト値は true。
|
|
|
