|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
web-services.xml デプロイメント記述子ファイルを生成します。
|
|
|
|
web-services.xml デプロイメント記述子ファイル、および Web サービスを実装する起点として使用できる Java ソース ファイルが含まれる。
|
|
|
|
|
|
|
|
|
setEnv.cmd コマンドを実行します。WebLogic Server ドメインのデフォルトの位置は、BEA_HOME\user_projects\domains\domainName です。BEA_HOME は BEA Products の最上位のインストール ディレクトリで、domainName はドメインの名前です。
setEnv.sh コマンドを実行します。WebLogic Server ドメインのデフォルトの位置は、BEA_HOME/user_projects/domains/domainName です。BEA_HOME は BEA Products の最上位のインストール ディレクトリで、domainName はドメインの名前です。
build.xml というファイルを作成します。 servicegen と clientgen の詳細が省かれた、簡単な build.xml ファイルです。
<target name="build-ear">
<servicegen attributes go here...>
...
</servicegen>
</target>
<target name="build-client" depends="build-ear">
<clientgen attributes go here .../>
</target>
<target name="clean">
<delete>
<fileset dir="."
includes="example.ear,client.jar" />
</delete>
</target>
</project>
build.xml ファイルで Ant タスクを指定する例は後の節で紹介します。
build.xml ファイルと同じディレクトリで ant と入力し、Ant タスクまたは build.xml ファイルで指定されたタスクを実行します。
clientgen Ant タスクの wsdl 属性を使用すると、Web サービスを記述する既存の WSDL ファイルから Web サービス固有のクライアント JAR ファイルを作成できます。
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
^
classpath 属性または要素を受け取ります。
servicegen Ant タスクの classpath 属性を使用して CLASSPATH 変数に追加する方法を示します。
classpath="${java.class.path};my_fab_directory"
...
</servicegen>
<classpath> 要素を使用して CLASSPATH に追加する方法を示します。
<classpath>
<pathelement path="${java.class.path}" />
<pathelement path="my_fab_directory" />
</classpath>
...
</servicegen>
<classpath> 要素を使用してタスク内でその変数を指定する方法を示します。
<pathelement path="${java.class.path}"/>
<pathelement path="${additional.path1}"/>
<pathelement path="${additional.path2}"/>
</path>
<classpath refid="myid" />
...
</servicegen>
build.sysclasspath をサポートしています。このプロパティのデフォルト値は ignore です。つまり、この節の説明どおりに build.xml ファイルで CLASSPATH を明示的に設定すると、Ant タスクはシステム CLASSPATH (あるいは Ant 実行時に有効な CLASSPATH) を無視して、ユーザが明示的に設定した CLASSPATH を使用します。この場合、Ant タスクの実行に必要なすべてのクラスを CLASSPATH の設定に必ず含めてください。このデフォルト動作を変更するには、build.sysclasspath プロパティを last に設定しシステム CLASSPATH をユーザが指定した CLASSPATH の最後に連結するか、あるいは first に設定しユーザが指定した CLASSPATH をシステム CLASSPATH の最後に連結します。
build.sysclasspath プロパティの詳細については、Ant 関連のマニュアルを参照してください。
\server\bin ディレクトリ (WL_HOME は WebLogic Platform がインストールされている最上位ディレクトリ) にある ant (UNIX) または ant.bat (Windows) コンフィグレーション ファイルを使用して各種の Ant 固有変数を設定します。これらの Ant 変数を更新する必要がある場合、使用しているオペレーティング システム用のコンフィグレーション ファイルを変更します。
setEnv.cmd コマンドを実行します。WebLogic Server ドメインのデフォルトの位置は、BEA_HOME\user_projects\domains\domainName です。BEA_HOME は BEA Products の最上位のインストール ディレクトリで、domainName はドメインの名前です。
setEnv.sh コマンドを実行します。WebLogic Server ドメインのデフォルトの位置は、BEA_HOME/user_projects/domains/domainName です。BEA_HOME は BEA Products の最上位のインストール ディレクトリで、domainName はドメインの名前です。
java コマンドを使用してユーティリティを実行します。
-ear myapps/myapp.ear \
-serviceName myService \
-packageName myservice.client \
-clientJar myapps/myService_client.jar
autotype Ant タスクは、Web サービス オペレーションのパラメータまたは戻り値として使用される非組み込みデータ型の以下のコンポーネントを生成します。
web-services.xml デプロイメント記述子ファイルに格納されるデータ型マッピング情報
autotype でデータ型コンポーネントを生成できる非組み込みデータ型のリストについては、「servicegen および autotype Ant タスクでサポートされる非組み込みデータ型」を参照してください。
autotype Ant タスクでは、以下のいずれかの入力を指定できます。
javaTypes 属性を指定)。 autotype Ant タスクは、web-services.xml ファイル用に、対応する XML スキーマ、シリアライゼーション クラス、およびデータ型マッピング情報を生成します。javaComponents 属性を指定)。Web サービスが Java クラスで実装される場合、この属性は Java クラスを指します。Web サービスがステートレス セッション EJB で実装される場合、この属性は EJB のリモート インタフェースを指します。autotype Ant タスクは、コンポーネントでパラメータまたは戻り値として使用される非組み込みデータ型を探してから、web-services.xml ファイル用に、対応する XML スキーマ、シリアライゼーション クラス、およびデータ型マッピング情報を生成します。非組み込みデータ型の Java クラスを CLASSPATH に必ず含めてください。schemaFile 属性を指定)。autotype Ant タスクは、web-services.xml ファイル用に、対応する Java 表現、シリアライゼーション クラス、およびデータ型マッピング情報を生成します。wsdlURI 属性を指定)。autotype Ant タスクは、web-services.xml ファイル用に、対応する Java 表現、シリアライゼーション クラス、およびデータ型マッピング情報を生成します。
destDir 属性を使用すると、生成されたコンポーネントが格納されるディレクトリの名前を指定できます。XML スキーマとデータ型マッピング情報は、types.xml というファイルに生成されます。このファイルは、既存の web-services.xml ファイルを非組み込みデータ型マッピング情報で手動更新するために使用するか、あるいは servicegen または clientgen Ant タスクの typeMappingFile 属性、または source2wsdd Ant タスクの typesInfo 属性と関連して使用できます。
autotype、servicegen、および clientgen Ant タスクによって生成されたシリアライゼーション クラスと Java および XML 表現はラウンドトリップできません。 詳細については、「生成されたデータ型コンポーネントの非ラウンドトリップ」を参照してください。
autotype Ant タスクの完全修飾名は、weblogic.ant.taskdefs.webservices.javaschema.JavaSchema です。
targetNamespace="http://www.foobar.com/autotyper"
packageName="a.package.name"
destDir="output" />
mypackage.MyType Java データ型の配列用の非組み込みデータ型コンポーネントを作成します。
targetNamespace="http://www.foobar.com/autotyper"
packageName="a.package.name"
destDir="output" />
[Lclassname; という構文は、java.lang.Class.getName() メソッドに関するドキュメントに記載されている Java クラス命名規約に従っています。
autotype Ant タスクを使用する方法と、シリアライゼーション クラスの生成された Java ファイルを保持するよう指定する方法を示します。
targetNamespace="http://www.foobar.com/autotyper"
packageName="a.package.name"
destDir="output"
keepGenerated="True" />
autotype Ant タスクの属性について説明します。
|
|
|
|
|
|
|
types.xml というファイルに生成される。
|
|
|
|
|
autotype Ant タスクが、Java データ型の XML 表現を記述する XML スキーマ ファイルを生成するときに、SOAP またはリテラルのどちらを使用するかを指定する。
autotype でリテラル エンコーディングを使用するように指定する必要がある。そうしないと、ユーザが後で Web サービスを呼び出すときに相互運用性の問題が発生する可能性がある。
soap および literal。デフォルト値は soap。
|
|
javaTypes または javaComponents 属性との組み合わせでのみ使用する。encoding 属性を schemaFile 属性と一緒に使用するとエラーが返される。
|
|
|
javaComponents="my.class1,my.class2"
autotype Ant タスクは、リストの Java クラスを参照し、見つかったすべての非組み込みデータ型のコンポーネントを自動的に生成する。
|
|
schemaFile、wsdl、javaTypes、または javaComponents のいずれかの属性を 1 つだけ指定する必要がある。
|
|
|
javaTypes="my.class1,my.class2"
[Lclassname; 構文を使用して Java データ型の配列を指定する。例については、「例」を参照。
|
|
schemaFile、wsdl、javaTypes、または javaComponents のいずれかの属性を 1 つだけ指定する必要がある。
|
|
|
autotype Ant タスクが、Web サービス オペレーションへのパラメータまたは戻り値として使用される非組み込みデータ型に対するシリアライゼーション クラスの Java ソース コードを保持する (したがって生成されたコンポーネントに入れる) 必要があるのか、それともコンパイルされたクラス ファイルだけを入れるのかを指定する。
True および False。デフォルト値は False。
|
|
|
|
|
True を指定すると、常に新しいコンポーネントが生成され、既存のコンポーネントがすべて上書きされる。
False を指定すると、既存のコンポーネントのタイムスタンプに基づき、変更のあったコンポーネントだけが上書きされる。
True または False。デフォルト値は True。
|
|
|
|
|
autotype Ant タスクは、指定されたパッケージの基本名に付加された個々の Java クラスに固有の名前を生成するが、生成された個々の Java クラスは同じパッケージ名の一部となる。
autotype Ant タスクが基本パッケージ名を生成する。
packageName 属性を使用して完全パッケージ名を指定することを推奨。packageBase 属性は、JAX-RPC に準拠している。
|
|
packageName を同時に指定することはできない。
|
|
|
autotype Ant タスクがパッケージ名を生成する。
javaTypes 属性を使用して、クラス名が同じであるがパッケージ名が異なる一連の Java データ型を指定した場合のみ。 この場合、packageName 属性も指定すると、autotype Ant タスクは、最後のクラスのシリアライゼーション クラスのみを生成する。
|
|
packageBase を同時に指定することはできない。
|
|
|
|
|
schemaFile、wsdl、javaTypes、または javaComponents のいずれかの属性を 1 つだけ指定する必要がある。
|
|
|
|
|
|
|
|
web-services.xml ファイルの <type-mapping> 要素と <types> 要素内のデータ型マッピング情報と同じ。
autotype Ant タスクは、このファイルにあるデータ型の非組み込みデータ型コンポーネントは生成しない。このタスクでは、このファイルの情報をその出力 types.xml ファイルの生成された情報に結合する。
|
|
|
|
|
|
|
schemaFile、wsdl、javaTypes、または javaComponents のいずれかの属性を 1 つだけ指定する必要がある。
|
autotype Ant タスクに相当するコマンドライン ユーティリティは weblogic.webservice.autotype です。ユーティリティのフラグの説明は、前の節で説明した Ant タスク属性の説明と同じです。
weblogic.webservice.autotype ユーティリティは次のフラグをサポートしています (フラグの説明は対応する属性を参照)。
-help (標準の使い方メッセージを出力する)dirpathnameuriclassnameclassnamenamenamenametrue_or_falsepathnametrue_or_false
clientgen Ant タスクは、クライアント アプリケーションが WebLogic Web サービスと非 WebLogic Web サービスの両方の呼び出しに使用できる Web サービス固有のクライアント JAR ファイルを生成します。通常、clientgen Ant タスクは既存の WSDL ファイルからクライアント JAR ファイルを生成するために使用します。ただし、WebLogic Web サービスの実装が含まれた EAR ファイルで使用することもできます。
clientgen Ant タスクを使用すると、クライアント JAR ファイルを既存の Web サービス (WebLogic Server 上で実行されている必要はない) の WSDL ファイルから、または WebLogic Web サービス実装を含んでいる EAR ファイルから生成できます。
clientgen Ant タスクは要求/応答または通知 WSDL オペレーションをサポートしていません。つまり、これらの種類のオペレーションを含む WSDL ファイルからクライアント JAR ファイルを作成しようとすると、Ant タスクはオペレーションを無視します。
autotype、servicegen、および clientgen Ant タスクによって生成されたシリアライゼーション クラスと Java および XML 表現はラウンドトリップできません。 詳細については、「生成されたデータ型コンポーネントの非ラウンドトリップ」を参照してください。
clientgen Ant タスクの完全修飾名は、weblogic.ant.taskdefs.webservices.clientgen.ClientGenTask です。
packageName="myapp.myservice.client"
clientJar="myapps/myService_client.jar"
/>
clientgen Ant タスクの属性について説明します。
|
|
|
|
|
|
|
clientgen タスクが、Web サービス オペレーションへのパラメータまたは戻り値として使用される非組み込みデータ型に対するシリアライゼーション クラスを生成してクライアント JAR ファイルに入れるかどうかを指定する。
True および False。 デフォルト値は True。
|
|
|
|
|
clientgen タスクが入れる JAR ファイルまたは展開ディレクトリの名前。
.jar サフィックスを使用する (myclientjar.jar など)。属性値に .jar サフィックスがない場合、clientgen タスクはディレクトリ名が参照されていると想定する。
clientgen タスクが新しい JAR ファイルまたはディレクトリを作成する。
|
|
|
|
|
clientgen の saveWSDL 属性が True (デフォルト値) に設定されている場合、clientgen Ant タスクは EAR ファイルの情報から WSDL ファイルを生成し、それを生成された JAR ファイルに格納する。clientgen は Web サービスをホストする WebLogic Server インスタンスのホスト名またはポート番号を認識しないため、clientgen は生成された WSDL の次のエンドポイント アドレスを使用する。
http://localhost:7001/contextURI/serviceURI
contextURI と serviceURI は、「WebLogic Web サービスのホーム ページおよび WSDL の URL」で説明した値と同じ。このエンドポイント アドレスが正しくなく、クライアント アプリケーションがクライアント JAR ファイルに格納されている WSDL ファイルを使用する場合、正確なエンドポイント アドレスを指定して手動で WSDL ファイルを更新する必要がある。
|
|
wsdl または ear の指定が必須。
|
|
|
clientgen Ant タスクで、標準メソッドに加えて、Web サービスの各オペレーションを非同期で呼び出す 2 つの特殊なメソッドを生成するよう指定する。この特殊なメソッドは、次のような形式になっている。
FutureResult startMethod (params,
AsyncInfo asyncInfo);
result endMethod (FutureResult
futureResult);
True および False。デフォルト値は False。
|
|
|
|
|
True および False。デフォルト値は False。
|
|
|
|
|
clientgen Ant タスクが J2ME/CDC 準拠のクライアント JAR ファイルを作成するかどうかを指定する。
True および False。デフォルト値は False。
|
|
|
|
|
clientgen Ant タスクが、Web サービス オペレーションへのパラメータまたは戻り値として使用される非組み込みデータ型に対するシリアライゼーション クラスの Java ソース コードを保持する (したがって生成された JAR ファイルに入れる) 必要があるのか、それともコンパイルされたクラス ファイルだけを入れるのかを指定する。
True および False。デフォルト値は False。
|
|
|
|
|
True を指定すると、常に新しいコンポーネントが生成され、既存のコンポーネントがすべて上書きされる。
False を指定すると、既存のコンポーネントのタイムスタンプに基づき、変更のあったコンポーネントだけが上書きされる。
True または False。デフォルト値は True。
|
|
|
|
|
|
|
|
|
|
True に設定されている場合、生成されたクライアント JAR ファイルに Web サービスの WSDL が保存される。この場合、クライアント アプリケーションは Web サービスへのスタブを作成するたびに WSDL をダウンロードする必要がなく、ネットワーク使用量が削減されるためにパフォーマンスが一般に向上する。
True および False。デフォルト値は True。
|
|
|
|
|
wsdl 属性を指定すると、Web サービス名は WSDL ファイル内の <service> 要素に対応する。ear 属性を指定すると、Web サービス名は web-services.xml デプロイメント記述子ファイル内の <web-service> 要素に対応する。
serviceName 属性が未指定の場合、clientgen タスクは WSDL または web-services.xml ファイル内で最初に見つかったサービス名のクライアント クラスを生成する。
|
|
|
|
|
clientgen タスクにより使用される。情報の形式は、web-services.xml ファイルの <type-mapping> 要素内のデータ型マッピング情報と同じ。
ear 属性を指定すると、このファイル内の情報により、web-services.xml ファイル内のデータ型マッピング情報がオーバーライドされる。
|
|
|
|
|
clientgen Ant タスクは、指定されたパッケージの基本名に付加された個々の Java クラスに固有の名前を生成するが、生成された個々の Java クラスは同じパッケージ名の一部となる。
typePackageName を同時に指定することはできない。
clientgen Ant タスクは対象のネームスペースに基づいてパッケージ名を自動的に生成する。つまり、XML スキーマに対象のネームスペースが定義されていない場合は、clientgen Ant タスクの typePackageName 属性 (推奨) または typePackageBase 属性のいずれかを必ず指定する。
typePackageName 属性で完全パッケージ名を指定する方が適切。typePackageBase 属性は、JAX-RPC に準拠している。
|
|
wsdl 属性を指定した場合で、WSDL ファイルの XML スキーマで対象ネームスペースが定義されていない場合のみ必須。
|
|
|
typePackageBase を同時に指定することはできない。
clientgen Ant タスクは対象のネームスペースに基づいてパッケージ名を自動的に生成する。 つまり、XML スキーマに対象のネームスペースが定義されていない場合は、clientgen Ant タスクの typePackageName 属性 (推奨) または typePackageBase 属性のいずれかを必ず指定する。
|
|
wsdl 属性を指定した場合で、WSDL ファイルの XML スキーマで対象ネームスペースが定義されていない場合のみ必須。
|
|
|
True および False。デフォルト値は True。
|
|
|
|
|
clientgen Ant タスクが、WSDL ファイルからクライアントを生成する際にオペレーションの名前を取得する場所を指定する。
<port> 要素の name 属性で指定された名前を取る (<port> は <service> 要素の子要素)。usePortNameAsMethodName を False に設定した場合、オペレーションは、WSDL ファイルの <portType> 要素の name 属性で指定された名前を取る (<portType> は <definitions> 要素の子要素)。
True および False。デフォルト値は False。
|
|
|
|
|
clientgen タスクが、Web サービスで使用されるいずれかの非組み込み Java データ型の実装を取得する場所を指定する。タスクは Java コードを生成するか、Web サービスの完全な実装を含む EAR ファイルからそれを取得する。
True (EAR ファイル内の Java コードを使用) および False。デフォルト値は False。
clientgen でデータ型コンポーネントを生成できる非組み込みデータ型のリストについては、「servicegen および autotype Ant タスクでサポートされる非組み込みデータ型」を参照。
|
|
ear 属性との組み合わせでのみ使用。
|
|
|
web-services.war。
|
|
ear 属性との組み合わせでのみ指定できる。
|
|
|
|
|
wsdl または ear の指定が必須。
|
clientgen Ant タスクに相当するコマンドライン ユーティリティは weblogic.webservice.clientgen です。ユーティリティのフラグの説明は、前の節で説明した Ant タスク属性の説明と同じです。
weblogic.webservice.clientgen ユーティリティは次のフラグをサポートしています (フラグの説明は該当の属性を参照)。
-help (標準の使い方メッセージを出力する)-wsdl uriear pathnameclientJar pathname-packageName name-warName name-serviceName name-typeMappingFile pathname-useServerTypes true_or_falsenamenametrue_or_falsetrue_or_falsetrue_or_falsetrue_or_falsetrue_or_falsetrue_or_falsetrue_or_falsetrue_or_false
servicegen Ant タスクは、EJB JAR ファイルまたは Java クラスのリストを入力として受け取り、必要な全 Web サービス コンポーネントを作成してデプロイ可能な EAR ファイルにパッケージ化します。
servicegen Ant タスクは、次のタスクを実行します。
servicegen Ant タスクの属性と参照した情報に基づいて、web-services.xml デプロイメント記述子ファイルを作成する。web-services.xml ファイルを更新する。この機能は、オートタイピングと呼ばれます。
servicegen により、Web サービスで使用する信頼性のある SOAP メッセージング、ハンドラ チェーン、データ セキュリティ (デジタル署名と暗号化) のデフォルトのコンフィグレーションを設定することもできます。
servicegen の destEar 属性に .ear サフィックスを持たない値を指定して、EAR ファイルではなく展開ディレクトリを作成することをお勧めします。その展開ディレクトリは、後で、Web サービスがデプロイできる状態になったときに EAR ファイルにパッケージ化できます。
autotype、servicegen、および clientgen Ant タスクによって生成されたシリアライゼーション クラスと Java および XML 表現はラウンドトリップできません。詳細については、「生成されたデータ型コンポーネントの非ラウンドトリップ」を参照してください。
servicegen Ant タスクの完全修飾名は、weblogic.ant.taskdefs.webservices.servicegen.ServiceGenTask です。
destEar="ears/myWebService.ear"
warName="myWAR.war"
contextURI="web_services" >
<service
ejbJar="jars/myEJB.jar"
targetNamespace="http://www.bea.com/examples/Trader"
serviceName="TraderService"
serviceURI="/TraderService"
generateTypes="True"
expandMethods="True" >
</service>
</servicegen>
servicegen Ant タスクには 4 つの属性と 1 つの子要素 (<service>) があります。1 つ以上の <service> 要素を指定する必要があります。
<service> 要素には、<client>、<reliability>、<handlerChain>、<security> という 4 つの省略可能な要素があります。
servicegen Ant タスクの階層を示しています。
servicegen Ant タスクは、Web サービスの全コンポーネントを自動的に生成およびアセンブルしてデプロイ可能な EAR ファイルにパッケージ化する主要なタスクです。
servicegen Ant タスクの属性について説明します。
|
|
|
|
|
|
|
contextURI 属性のデフォルト値は warName 属性の値になる。
|
|
|
|
|
.ear サフィックスを使用する (ears/mywebservice.ear など)。属性値に .ear サフィックスがない場合、servicegen タスクは展開ディレクトリを作成する。
servicegen タスクが新しいファイルまたはディレクトリを作成する。
|
|
|
|
|
servicegen Ant タスクが、Web サービス オペレーションへのパラメータまたは戻り値として使用される非組み込みデータ型に対するシリアライゼーション クラスの Java ソース コードを保持する (したがって生成された Web サービス EAR ファイルに入れる) 必要があるのか、それともコンパイルされたクラス ファイルだけを入れるのかを指定する。
True および False。デフォルト値は False。
|
|
|
|
|
destEar 属性で指定されている EAR ファイルにある既存の Web サービスにマージする必要があるかどうかを指定する。
True および False。デフォルト値は False。
|
|
|
|
|
True を指定すると、常に新しいコンポーネントが生成され、既存のコンポーネントがすべて上書きされる。
False を指定すると、既存のコンポーネントのタイムスタンプに基づき、変更のあったコンポーネントだけが上書きされる。
True または False。 デフォルト値は True。
|
|
|
|
|
web-services.war という WAR ファイル。
.war サフィックスを使用する (mywebserviceWAR.war など)。 属性値に .war サフィックスがない場合、servicegen タスクは展開ディレクトリを作成する。
|
|
|
<service> 要素は、ステートレス セッション EJB または Java クラスで実装される単一 Web サービスを記述します。
servicegen Ant タスクの <service> 要素の属性について説明します。単一 EAR ファイルにパッケージ化する各 Web サービスに、1 つの <service> 要素を含めてください。
|
|
|
|
|
|
|
servicegen Ant タスクはこの EJB を参照して全コンポーネントを自動生成する。
|
|
ejbJar 属性、javaClassComponents 属性、または JMS* 属性の指定が必須。
|
|
|
servicegen タスクはこのリスト上の EJB 以外の全 EJB を処理する。
ejbJar 属性で指定される EJB JAR ファイル内の ejb-jar.xml デプロイメント記述子内の <ejb-name> 要素に対応する。
|
|
ejbJar 属性との組み合わせでのみ使用される。
|
|
|
web-services.xml ファイルの生成時に、servicegen タスクが EJB または Java クラスの各メソッドに別々の <operation> 要素を作成するか、または method="*" 属性を含む 1 つの <operation> 要素のみを指定することで全メソッドを暗黙的に参照するかを指定する。
True および False。 デフォルト値は False。
|
|
|
|
|
servicegen タスクが、パラメータまたは戻り値として使用される非組み込みデータ型に対してシリアライゼーション クラスと Java 表現を生成するかを指定する。
True および False。 デフォルト値は True。
|
|
|
|
|
Authorization HTTP ヘッダを無視することを指定する。
True に設定すると、WebLogic Server は、たとえアクセス制御のセキュリティ制約が Web サービスを構成する EJB、Web アプリケーション、またはエンタープライズ アプリケーションに対して定義されていても、Web サービスを呼び出そうとしているクライアント アプリケーションの認証を行わない。 つまり、認証資格を提供しないクライアント アプリケーションでも、セキュリティ制約が定義されていれば、Web サービスを呼び出すことが可能となる。
True および False。 デフォルト値は False。
|
|
|
|
|
servicegen タスクはこのリスト上の EJB のみを処理する。
ejbJar 属性で指定される EJB JAR ファイル内の ejb-jar.xml デプロイメント記述子内の <ejb-name> 要素に対応する。
|
|
ejbJar 属性との組み合わせでのみ使用される。
|
|
|
javaClassComponents="my.FirstClass,my.SecondClass"
.class 拡張子を含めないこと。
servicegen Ant タスクはこの Java クラスを参照して必要な全コンポーネントを自動生成する。
|
|
ejbJar 属性、javaClassComponents 属性、または JMS* 属性の指定が必須。
|
|
|
send または receive。
send、クライアントが JMS 送り先からメッセージを受信する場合は receive を指定する。
|
|
|
|
|
ConnectionFactory の JNDI 名。
|
|
|
|
|
|
|
|
|
|
queue。
|
|
|
|
|
java.lang.String。
generateTypes 属性を True に設定する場合は、この非組み込みデータ型の Java 表現が必ず CLASSPATH で設定されているようにする。
|
|
|
|
|
send または receive のいずれか (JMSAction 属性の値によって異なる)。
|
|
|
|
|
http および https。 デフォルト値は http。
|
|
|
|
|
servicegen を呼び出す build.xml ファイルで複数の <service> 要素を指定し、その各要素の serviceName 属性を同じ値に設定すると、servicegen は複数の <service> 要素を単一の Web サービスにマージしようとする。
|
|
|
|
|
/TraderService のように、先頭に「/」を必ず指定すること。
protocol://host:port/contextURI/serviceURI
|
|
|
|
|
servicegen Ant タスクで RPC 指向とドキュメント指向のどちらの Web サービス オペレーションを生成するのかを指定する。
document と documentwrapped を使用すると、ドキュメント指向の Web サービス オペレーションを生成できる。
document を指定した場合、Web サービスはパラメータを 1 つしか取らない。このため、このオペレーションを実装するメソッドもパラメータを 1 つしか取らない。この場合、servicegen が複数のパラメータを持つメソッドに遭遇した場合、servicegen はそのメソッドを無視し、対応する Web サービス オペレーションが生成されない。
documentwrapped を指定した場合、Web サービス オペレーションはパラメータをいくつでも取ることができる。ただし、これらのパラメータの値は、SOAP メッセージの中に 1 つの複合データ型としてラップされる。Web サービスを実装するステートレス セッション EJB または Java クラスの複数のメソッドが同じパラメータ数とデータ型を取り、オペレーションをドキュメント指向にしたい場合、この属性値として document ではなく documentwrapped を指定する必要がある。
rpc、documentwrapped、および document。 デフォルト値は rpc。
style 属性は Web サービス全体に適用されるので、1 つの WebLogic Web サービスのすべてのオペレーションが RPC 指向またはドキュメント指向のいずれかである必要がある。同じ Web サービスで 2 つのスタイルを混在させることはできない。
|
|
|
|
|
web-services.xml 内のデータ型マッピング情報と同じ。
web-services.xml ファイルの <type-mapping> 要素に含める場合に使用する。servicegen タスクは、指定ファイル内の追加情報を、生成された web-services.xml ファイルに追加する。
|
|
|
|
|
|
|
|
|
|
useSOAP12="True" を指定した場合、デプロイされた WebLogic Web サービスの生成された WSDL には、メッセージ フォーマット プロトコルとして SOAP 1.1 用のバインディングを指定する標準ポートと、SOAP 1.2 を使用する第 2 ポートの 2 つのポートが含まれる。メッセージ フォーマット プロトコルに SOAP 1.2 を使用したい場合、クライアント アプリケーションは Web サービスの呼び出し時に第 2 ポートを使用できる。
True および False。デフォルト値は False。
|
|
|
<client> 要素は、クライアント アプリケーションが Web サービスの呼び出しに使用するクライアント JAR ファイルの作成方法を指定します。servicegen Ant タスクによりクライアント JAR ファイルを作成する場合にのみこの要素を指定します。
clientgen Ant タスクを使用して JAR ファイルを生成することができます。
<client> 要素の属性について説明します。
|
|
|
|
|
|
|
servicegen タスクは、Web サービスをパッケージ化するときに、クライアント JAR ファイルを EAR ファイルの Web サービス WAR ファイルの最上位ディレクトリに入れる。
serviceName_client.jar で、serviceName は Web サービスの名前 (serviceName 属性) を指す。
|
|
|
|
|
|
|
|
|
|
True に設定されている場合、生成されたクライアント JAR ファイルに Web サービスの WSDL ファイルが保存される。 この場合、クライアント アプリケーションは Web サービスへのスタブを作成するたびに WSDL ファイルをダウンロードする必要がなく、ネットワーク使用量が削減されるためにパフォーマンスが一般に向上する。
True および False。 デフォルト値は True。
|
|
|
|
|
servicegen タスクが、Web サービスで使用されるいずれかの非組み込み Java データ型の実装を取得する場所を指定する。タスクは Java コードを生成するか、Web サービスの完全な実装を含む EAR ファイルからそれを取得する。
True (EAR ファイル内の Java コードを使用) および False。デフォルト値は False。
|
|
|
<service> 要素の省略可能な <handlerChain> 子要素は、Web サービスにハンドラ チェーン コンポーネントを追加し、ハンドラ チェーンを Web サービスの各オペレーションと関連付けるよう指定します。1 つのハンドラ チェーンは 1 つまたは複数のハンドラで構成されます。ハンドラ チェーンの詳細については、「SOAP メッセージをインターセプトする SOAP メッセージ ハンドラの作成」を参照してください。
servicegen で設定すると、ハンドラ チェーンが Web サービスのすべてのオペレーションと関連付けられます。このハンドラ チェーンを一部のオペレーションのみと関連付けたい場合は、生成された web-services.xml ファイルを編集して、対応する <operation> 要素の handler-chain 属性を削除してください。これらの要素と属性の詳細については、「WebLogic Web サービス デプロイメント記述子の要素」を参照してください。
<handlerChain> 要素の属性について説明します。
|
|
|
|
|
|
|
web-services.xml ファイルを編集して、<handler> 要素に <init-params> 子要素を追加する必要がある。これらの要素の詳細については、「WebLogic Web サービス デプロイメント記述子の要素」を参照。
|
|
|
|
|
serviceNameHandlerChain で、serviceName は <service> 親要素の serviceName 属性を指す。
|
|
|
<service> 要素の省略可能な <reliability> 子要素は、信頼性のある SOAP メッセージングによって Web サービスのすべてのオペレーションを非同期に呼び出せるよう指定します。信頼性のある SOAP メッセージングの詳細については、「信頼性のある SOAP メッセージングの使い方」を参照してください。
servicegen で設定すると、信頼性のある SOAP メッセージングが Web サービスのすべてのオペレーションに対して有効になります。信頼性のある SOAP メッセージングを一部のオペレーションでのみ利用したい場合は、生成された web-services.xml ファイルを編集して、対応する <operation> 要素の <reliable-delivery> 子要素を削除してください。 これらの要素の詳細については、「WebLogic Web サービス デプロイメント記述子の要素」を参照。
<reliability> 要素の属性について説明します。
|
|
|
|
|
|
|
True に設定すると、Web サービスは重複呼び出しを排除できるようにクライアント アプリケーションからのメッセージ ID を保持する。False に設定した場合、Web サービスは重複呼び出しを管理しない。つまり、クライアントが呼び出しを再試行した場合、どちらの呼び出しも値を返すことができる。
True および False。デフォルト値は True。
|
|
|
|
|
|
|
|
<service> 要素の省略可能な <security> 子要素は、デジタル署名や暗号化などのデフォルト データ セキュリティを Web サービスに追加します。データ セキュリティの詳細については、「セキュリティのコンフィグレーション」を参照してください。
servicegen Ant タスクを使用してデータ セキュリティをコンフィグレーションする場合は、SOAP メッセージ本文全体のみを暗号化またはデジタル署名できます。デジタル署名または暗号化する対象として SOAP メッセージの特定の要素を指定したい場合は、「メッセージレベルのセキュリティのコンフィグレーション : 主な手順」を参照してください。この節では、Web サービスを呼び出す前に Administration Console で実行しておく必要のある一般的なセキュリティ コンフィグレーション作業についても説明しています。
<security> 要素の属性について説明します。
|
|
|
|
|
|
|
<security> 要素にユーザ名トークンが追加される。
True および False。デフォルト値は False。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
source2wsdd Ant タスクは、ステートレス セッション EJB または Java クラスを使用して実装される WebLogic Web サービスの Java ソース ファイルから web-services.xml デプロイメント記述子ファイルを生成します。生成される Web サービスを記述する WSDL を指定することもできます。
source2wsdd Ant タスクは、Web サービスの名前を、Web サービスを実装する Java クラスまたは EJB のクラス名に設定します。 この名前は、WSDL で公開される Web サービスのパブリック名にもなります。
source2wsdd Ant タスクは、EJB または Java クラスのメソッドのパラメータまたは戻り値として使用される非組み込みデータ型のデータ型マッピング情報を生成しません。EJB または Java クラスで非組み込みデータ型が使用される場合は、まず autotype Ant タスクを実行して必要なコンポーネントを生成し、その後に source2wsdd Ant タスクの typesInfo 属性を、autotype Ant タスクで生成された types.xml ファイルに設定します。
source2wsdd Ant タスクの sourcePath 属性をそれらのファイルが格納されているディレクトリに設定してください。
source2wsdd Ant タスクの完全修飾名は、weblogic.ant.taskdefs.webservices.autotype.JavaSource2DD です。
web-services.xml ファイルを ddfiles ディレクトリに生成する方法を示します。非組み込みデータ型についての情報は、autotype/types.xml ファイルに格納されています。サービスの呼び出しに使用される URI の Web サービス部分は /MyService です。
javaSource="source/MyService.java"
typesInfo="autotype/types.xml"
ddFile="ddfiles/web-services.xml"
serviceURI="/MyService"
/>
web-services.xml ファイルと、ステートレス セッション EJB で実装される Web サービスを記述する WSDL ファイル (wsdFiles/Temperature.wsdl) の両方を生成する方法を示します。 ejbLink 属性が指定されているため、javaSource 属性は EJB ソース ファイルを指す必要があります。source2wsdd Ant タスクは、ejblink 属性の値を web-services.xml ファイルの <stateless-ejb> 要素の <ejb-link> 子要素の値として使用します。
javaSource="source/TemperatureService.java"
ejbLink="TemperatureService.jar#TemperatureServiceEJB"
ddFile="ddfiles/web-services.xml"
typesInfo="autotype/types.xml"
serviceURI="/TemperatureService"
wsdlFile="wsdlFiles/Temperature.wsdl"
/>
source2wsdd Ant タスクの属性について説明します。
|
|
|
|
|
|
|
web-services.xml) の完全パス名。
|
|
|
|
|
<stateless-ejb> 要素の <ejb-link> 子要素の値を指定する。 この属性は、EJB から web-services.xml ファイルを生成する場合のみ指定する。
source2wsdd Ant タスクは、参照すべき EJB を特定するためではなく、生成する web-services.xml ファイルの <ejb-link> 要素で使用する値を特定するために、この値を利用する。EJB ソース ファイルの指定には javaSource 属性を使用する。
jar-name#ejb-name
jar-name は、ステートレス セッション EJB を含んでいる JAR ファイル (Web サービス EAR ファイル内に含まれている) の名前を指す。名前には、最上位の EAR ファイルへの相対パス名が含まれている必要がある。
ejb-name は、EJB JAR ファイル内の ejb-jar.xml デプロイメント記述子内の <ejb-name> 要素に対応するステートレス セッション EJB の名前を指す。
myapp.jar#StockQuoteBean
|
|
javaSource 属性には必ず EJB ソース ファイルを設定する必要がある。
|
|
|
<handler-chains>。 このファイルの詳細情報と内容の作成方法については、「SOAP メッセージ ハンドラ情報による web-services.xml ファイルの更新
web-services.xml ファイルに SOAP メッセージ ハンドラとハンドラ チェーンの情報が格納されない。
|
|
|
|
|
Authorization HTTP ヘッダを無視することを指定する。
True に設定すると、WebLogic Server は、たとえアクセス制御のセキュリティ制約が Web サービスを構成する EJB、Web アプリケーション、またはエンタープライズ アプリケーションに対して定義されていても、Web サービスを呼び出そうとしているクライアント アプリケーションの認証を行わない。 つまり、認証資格を提供しないクライアント アプリケーションでも、セキュリティ制約が定義されていれば、Web サービスを呼び出すことが可能となる。
True および False。デフォルト値は False。
|
|
|
|
|
|
|
|
|
|
source2wsdd Ant タスクで、生成された web-services.xml デプロイメント記述子の情報を、ddFile 属性で指定された既存のファイルにマージするかどうかを指定する。
True および False。デフォルト値は False。
|
|
|
|
|
True を指定すると、常に新しいコンポーネントが生成され、既存のコンポーネントがすべて上書きされる。
False を指定すると、既存のコンポーネントのタイムスタンプに基づき、変更のあったコンポーネントだけが上書きされる。
True または False。デフォルト値は True。
|
|
|
|
|
/TraderService のように、先頭に「/」を必ず指定すること。
web-services.xml デプロイメント記述子の <web-service> 要素の uri 属性の値になる。
|
|
|
|
|
|
|
|
|
|
web-services.xml ファイルの <type-mapping> 要素内のそれと同じ。
autotype Ant タスクを実行し、この情報が types.xml というファイルに生成されている。
|
|
|
|
|
web-services.xml デプロイメント記述子に加えて、Web サービスを記述する WSDL を生成するよう指定する。
|
|
|
wsdl2Service Ant タスクは既存の WSDL ファイルを入力として、次のものを生成します。
web-services.xml ファイル
generateImpl="True" 属性を指定し、このクラスにビジネス ロジック Java コードを追加して、実装を完了します。
wsdl2Service Ant タスクは、(<service> 要素で指定された) WSDL ファイルの 1 つの Web サービスのみに対応する Java インタフェースを生成します。serviceName 属性を使用すると、特定のサービスを指定できます。この属性を指定しない場合、wsdl2Service Ant タスクでは WSDL ファイルの最初の <service> 要素の Java インタフェースが生成されます。
wsdl2Service Ant タスクは、WSDL ファイルのオペレーションのパラメータまたは戻り値として使用される非組み込みデータ型のデータ型マッピング情報を生成しません。WSDL で非組み込みデータ型が使用される場合は、まず autotype Ant タスクを実行してデータ型マッピング情報を生成し、その後に wsdl2Service Ant タスクの typeMappingFile 属性を autotype Ant タスクで生成された types.xml ファイルに設定します。
wsdl2Service Ant タスクを使用して Web サービスの web-services.xml ファイルを生成するときは、作成された Java インタフェースを実装する Java クラスに対して、次の命名規約が使用されます。
packageName.serviceNameImpl
packageName および serviceName は、wsdl2Service Ant タスクの同名の属性の値です。 Ant タスクは、web-services.xml ファイルの <java-class> 要素の class-name 属性に、この情報を書き込みます。
web-services.xml ファイルを手動で更新する必要があります。
wsdl2Service Ant タスクの完全修飾名は、weblogic.ant.taskdefs.webservices.wsdl2service.WSDL2Service です。
wsdl="wsdls/myService.wsdl"
destDir="myService/implementation"
typeMappingFile="autotype/types.xml"
packageName="example.ws2j.service"
/>
wsdl2Service Ant タスクの属性について説明します。
|
|
|
|
|
|
|
web-services.xml) の完全パス名。
web-services.xml ファイルは destDir 属性で指定されたディレクトリに生成される。
|
|
|
|
|
web-services.xml ファイル、Web サービスの実装を表す Java インタフェース ファイル、および省略可能な実装クラス) が格納されるディレクトリの完全パス名。
|
|
|
|
|
wsdl2Service Ant タスクが、空の実装 Java クラス ファイルを生成するべきであることを指定する。
serviceNameImpl。serviceName は、wsdl2Service Ant タスクの同様な名前を持つ属性の値。生成された Java ファイルの名前は serviceNameImpl.java であり、このファイルは destDir 属性で指定されたディレクトリ内に生成される。
True および False。デフォルト値は False。
|
|
|
|
|
wsdl2Service Ant タスクが維持するかどうか (したがって destDir 属性で指定されたディレクトリに格納するかどうか) を指定する。デフォルトでは、コンパイルされたクラス ファイルだけが格納される。
True および False。デフォルト値は False。
|
|
|
|
|
True を指定すると、常に新しいコンポーネントが生成され、既存のコンポーネントがすべて上書きされる。
False を指定すると、既存のコンポーネントのタイムスタンプに基づき、変更のあったコンポーネントだけが上書きされる。
True または False。デフォルト値は True。
|
|
|
|
|
|
|
|
|
|
<service> 要素の name 属性の値。
wsdl2Service Ant タスクは WSDL ファイルで見つかった最初の <service> 要素の部分的な実装を生成する。
wsdl2Service Ant タスクは、WSDL ファイルの 1 つのサービスのみで部分的な WebLogic Web サービス実装を生成する。WSDL ファイルに複数の Web サービスが含まれている場合は、この属性の値を変えながら、wsdl2Service を複数回実行する必要がある。
|
|
|
|
|
web-services.xml ファイルの <type-mapping> 要素内のデータ型マッピング情報と同じ。
autotype Ant タスク (wsdl 属性を指定) を同じ WSDL ファイルに対して実行し、すべての非組み込みデータ型コンポーネントを生成する。生成されるコンポーネントの 1 つは、非組み込みデータ型のマッピング情報と非組み込みデータ型の XML スキーマが格納される types.xml というファイル。typeMappingFile 属性はこのファイルに設定する。
|
|
|
|
|
|
|
|
wsdlgen Ant タスクは、Web サービスを実装する EAR ファイルと WAR ファイルから WSDL ファイルを生成します。EAR ファイルには Web サービスを実装する EJB が格納され、WAR ファイルには web-services.xml デプロイメント記述子ファイルが格納されています。
wsdlgen Ant タスクの完全修飾名は、weblogic.ant.taskdefs.webservices.wsdlgen.WSDLGen です。
warName="myapps/myWAR.war"
serviceName="myService"
wsdlFile="wsdls/myService.WSDL"
/>
wsdlgen Ant タスクの属性について説明します。
|
|
|
|
|
|
|
|
|
|
|
|
http://localhost:7001。
|
|
|
|
|
True を指定すると、常に新しいコンポーネントが生成され、既存のコンポーネントがすべて上書きされる。
False を指定すると、既存のコンポーネントのタイムスタンプに基づき、変更のあったコンポーネントだけが上書きされる。
True または False。デフォルト値は True。
|
|
|
|
|
web-services.xml デプロイメント記述子ファイル内の <web-service> 要素に一致する。
serviceName 属性が未指定の場合、wsdlgen タスクは web-services.xml ファイル内で最初に見つかったサービス名の WSDL ファイルを生成する。
|
|
|
|
|
web-services.xml デプロイメント記述子ファイルが格納されている WAR ファイルの名前。
|
|
|
|
|
|
|
|
wsdlgen Ant タスクに相当するコマンドライン ユーティリティは weblogic.webservice.wsdlgen です。ユーティリティのフラグの説明は、前の節で説明した Ant タスク属性の説明と同じです。
weblogic.webservice.wsdlgen ユーティリティは次のフラグをサポートしています (フラグの説明は該当する属性を参照)。
-help (標準の使い方メッセージを出力する)namenameaddress
wspackage Ant タスクの用途は次のとおりです。
web-services.xml デプロイメント記述子ファイル。
clientgen、autotype、source2wsdd、wsdl2Service といった他の Ant タスクを使用して前述のコンポーネントを生成します。
wspackage Ant タスクを使用して既存の EAR ファイルにコンポーネントを追加する場合は、既存のコンポーネントがいっさい上書きされないように、必ず overwrite="false" 属性を指定してください。 output 属性を使用すると、既存の EAR ファイルの完全パス名を指定できます。
wspackage Ant タスクの完全修飾名は、weblogic.ant.taskdefs.webservices.wspackage.WSPackage です。
wspackage Ant タスクを使用して、WebLogic Web サービスの各コンポーネントを 1 つの新しい EAR ファイルにパッケージ化する方法を示します。
output="ears/myWebService.ear"
contextURI="web_services"
codecDir="autotype"
webAppClasses="example.ws2j.service.SimpleTest"
ddFile="ddfiles/web-services.xml"
/>
ears/myWebService.ear という既存の EAR ファイルにコンポーネントを追加する方法を示します。
output="ears/myWebService.ear"
overwrite="false"
filesToEar="myEJB2.jar"
/>
wspackage Ant タスクの属性について説明します。
|
|
|
|
|
|
|
|
|
|
|
|
contextURI 属性のデフォルト値は warName 属性の値になる。
|
|
|
|
|
web-services.xml) の完全パス名。
wspackage Ant タスクを使用するものと見なされる。この場合は、overwrite="false" も指定して、output 属性に既存の EAR ファイルを設定する必要がある。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
wspackage Ant タスクを使用して既存の EAR ファイルにコンポーネントを追加する場合、この属性には既存の EAR ファイルの完全パス名を指定する。
.ear サフィックスを使用する (ears/mywebservice.ear など)。 属性値に .ear サフィックスがない場合、wspackage タスクは展開ディレクトリを作成する。
wspackage タスクが新しいファイルまたはディレクトリを作成する。
|
|
|
|
|
web-services.xml ファイル、シリアライゼーション クラス、クライアント JAR ファイルなどがある。
True および False。デフォルト値は True。
False を指定すると、wspackage Ant タスクは EAR ファイル/ディレクトリの内容と情報を web-services.xml ファイルにマージしようとする。
overwrite="false" を指定する必要がある。
|
|
|
|
|
WEB-INF/lib ディレクトリにパッケージ化する必要のあるファイルのカンマ区切りリスト。
|
|
|
|
|
web-services.war。
|
|
|
|
|
WEB-INF/classes ディレクトリにパッケージ化する必要のあるクラス ファイルのカンマ区切りリスト。
|
|
|
