![]() ![]() ![]() ![]() |
以下の節では、WebLogic Web サービスの反復的な開発プロセスについて説明します。
WebLogic Web サービスのプログラミング モデルは JWS ファイル (JWS アノテーションを使用して Web サービスの形式や動作を指定した Java ファイル) と、JWS ファイルを実行する Ant タスクを中心に展開されます。JWS アノテーションは JDK バージョン 5.0 で導入されたメタデータ機能に基づいており (JSR-175 で規定)、Web Services Metadata for the Java Platform 仕様 (JSR-181) で定義された標準のアノテーションと追加のアノテーションがあります。サポートされている JWS アノテーションの完全なリストについては、『WebLogic Web サービス リファレンス』の「Web Service Annotation Support」を参照してください。このプログラミング モデルの詳細については、『WebLogic Web サービス入門』の「WebLogic Web サービスの構造」を参照してください。
以下の節では、Web サービスを繰り返し開発する主要な手順を、Java から開始する場合、または既存の WSDL ファイルから開始する場合について説明します。
反復的な開発とは、希望どおりに動作するまで、Web サービスを繰り返しコーディング、コンパイル、パッケージ化、デプロイ、およびテストできるように、開発環境を設定することです。WebLogic Web サービス プログラミング モデルでは、Ant タスクを使用して、反復的な開発のほとんどの手順を実行します。一般に、すべての手順に対応するターゲットを含んだ 1 つの build.xml
ファイルを作成して、そのターゲットを繰り返し実行します。JWS ファイルを新しい Java コードで更新したら、その更新が期待どおりに動作することをテストします。
WebLogic Server ドメインを作成したら、コンフィグレーション ウィザードで Web サービス固有の拡張テンプレートを使用してドメインを更新し、特定の WebLogic Web サービス機能で必要になるリソースを自動的にコンフィグレーションできます。この拡張テンプレートの使用は必須ではありませんが、これを使用することで JMS および JDBC リソースのコンフィグレーションを大幅に簡略化できます。
Web サービス拡張テンプレートを使用すると、以下の機能で必要になるリソースを自動的にコンフィグレーションできます。
ドメインを更新してこれらの Web サービス機能用に自動的にコンフィグレーションするには、次の手順に従います。
WL_HOME
/common/templates/applications/wls_webservice.jar
WL_HOME
は WebLogic Server のメイン ディレクトリです。
コンフィグレーション ウィザードを使用して WebLogic Server ドメインを作成および更新する詳細な手順については、『コンフィグレーション ウィザードを使用した WebLogic ドメインの作成』を参照してください。
この節では、Java から開始して WebLogic Web サービスを開発する一般的な手順について説明します。つまり、JWS ファイルを最初からコーディングして、サービスについて記述する WSDL ファイルを後で生成するという手順です。このプロセスの具体的な例については、「一般的な Web サービスの使用例とサンプル」を参照してください。
以下に示すのは推奨の手順に過ぎません。独自の開発環境を設定してある場合は、WebLogic Web サービスを開発するために既存の環境を更新する際のガイドとして、この手順を利用できます。
注意 : | この手順では、WebLogic Web サービスの分割開発ディレクトリ環境は使用しません。この開発環境を使用していて、Web サービスの開発をそこに統合する場合の詳細については、Web サービスの WebLogic 分割開発ディレクトリ環境への統合」を参照してください。 |
jwsc Ant タスクによって出力ディレクトリ内に生成される。 この出力ディレクトリには、エンタープライズ アプリケーションのディレクトリ構造も生成される。この展開されたディレクトリは、後で反復的な開発プロセスの一環として WebLogic Server にデプロイする。「jwsc WebLogic Web サービス Ant タスクの実行」を参照。
|
||
jwsc Ant タスクの実行 (手順 6) から始まる手順を繰り返す。
|
Web サービスを呼び出すクライアント アプリケーションの記述については、「Web サービスの呼び出し」を参照してください。
この節では、既存の WSDL ファイルに基づいて WebLogic Web サービスを開発する一般的な手順について説明します。このプロセスの具体的な例については、「WebLogic Web サービスの開発」を参照してください。
以下に示すのは推奨の手順に過ぎません。独自の開発環境を設定してある場合は、WebLogic Web サービスを開発するために既存の環境を更新する際のガイドとして、この手順を利用できます。
この手順では既存の WSDL ファイルがすでにあることを前提としています。
注意 : | この手順では、WebLogic Web サービスの分割開発ディレクトリ環境は使用しません。この開発環境を使用していて、Web サービスの開発をそこに統合する場合の詳細については、Web サービスの WebLogic 分割開発ディレクトリ環境への統合」を参照してください。 |
wsdlc Ant タスクによって出力ディレクトリ内に生成される。「wsdlc WebLogic Web サービス Ant タスクの実行」を参照。
|
||
wsdlc Ant タスクでは途中まで作成済みの JWS ファイルが生成されるが、Web サービスが希望どおりに動作するようするには、独自のビジネス コードを追加する必要がある。「wsdlc で生成される途中まで作成済みの JWS 実装クラス ファイルの更新」を参照。
|
||
wsdlc Ant タスクによって生成されたアーティファクトと更新した JWS 実装ファイルを指定して、Web サービスを実装するエンタープライズ アプリケーションを生成する。「jwsc WebLogic Web サービス Ant タスクの実行」を参照。
|
||
<address> 要素の location 属性の値と同じ (ただし、ホストとポートの値が、サービスをデプロイした WebLogic Server インスタンスのホストとポートに対応する場合を除く)。これは、wsdlc Ant タスクが JWS 実装ファイル内の @WLHttpTransport アノテーションの contextPath および serviceURI の値を生成し、それらの値を合わせると、元の WSDL で指定されたエンドポイント アドレスと同じ URI が構成されるため。
|
||
jwsc Ant タスクの実行 (手順 6) から始まる手順を繰り返す。
|
Web サービスを呼び出すクライアント アプリケーションの記述については、「Web サービスの呼び出し」を参照してください。
Ant では、XML で記述されたビルド ファイル (デフォルト名は build.xml
) を使用します。このファイルには、<project>
ルート要素と、Web サービス開発プロセスのさまざまな段階を指定した 1 つまたは複数のターゲットが含まれています。各ターゲットには、1 つまたは複数のタスク、または実行可能なコードが含まれています。この節では、基本的な Ant ビルド ファイルの作成方法について説明し、その後の節では、Web サービス開発プロセスのさまざまな段階 (jwsc
Ant タスクを実行して JWS ファイルを処理する、Web サービスを WebLogic Server にデプロイする、など) の実行方法を指定したターゲットをビルド ファイルに追加する方法について説明します。
以下のスケルトンの build.xml
ファイルでは、以降の節で追加される他のすべてのターゲットを呼び出す、デフォルトの all
ターゲットを指定しています。
<project default="all">
<target name="all"
depends="clean,build-service,deploy" />
<target name="clean">
<delete dir="output" />
</target>
<target name="build-service"><!-- ここに jwsc タスク、関連するタスクを追加 -->
</target>
<target name="deploy">
<!-- ここに wldeploy タスクを追加 --></dftarget>
</project>
jwsc
Ant タスクは、JWS アノテーションを含む JWS ファイルを入力として取り、WebLogic Web サービスの作成に必要なアーティファクトをすべて生成します。JWS ファイルは、最初から自分でコーディングしたものでも、wsdlc
Ant タスクによって生成されたものでもかまいません。jwsc
によって生成されるアーティファクトには、以下のものがあります。
これらのアーティファクトは、wsdlc
Ant タスクによってすでに生成され、JAR ファイル内にパッケージ化されているため、wsdlc
Ant タスクによって生成された JWS ファイルに対して jwsc
Ant タスクを実行しても生成されません。この場合、
jwsc
Ant タスクの属性を使用して、この wsdlc
生成 JAR ファイルを指定します。
必要なアーティファクトをすべて生成した後、jwsc
Ant タスクは、Java ファイル (JWS ファイルも含む) をコンパイルし、コンパイルされたクラスと生成されたアーティファクトを、デプロイ可能な JAR アーカイブ ファイルにパッケージ化して、最後に、その JAR ファイルを格納する、展開されたエンタープライズ アプリケーション ディレクトリを作成します。
jwsc
Ant タスクを実行するには、以下の taskdef
および build-service
ターゲットを build.xml
ファイルに追加します。
<taskdef name="jwsc"
classname="weblogic.wsee.tools.anttasks.JwscTask" />
<target name="build-service">
<jwsc
srcdir="src_directory
"
destdir="ear_directory
"
>
<jws file="JWS_file
"
compiledWsdl="WSDLC_Generated_JAR"
type="WebService_type"/>
</jwsc>
</target>
ear_directory
- 生成されたすべてのアーティファクトを格納するエンタープライズ アプリケーション ディレクトリ。 src_directory
- JWS ファイルのパッケージ名に対応するサブディレクトリを含む最上位ディレクトリ。JWS_file
- src_directory
属性の値に対して相対的な JWS ファイルのパス名。wsdlc
Ant タスクによって生成された JAR ファイル。注意 : | この属性は、「WSDL から開始する」使用例でのみ指定します。この手順は「WSDL ファイルから開始する WebLogic Web サービスの開発 : 主な手順」で説明されています。 |
必須の taskdef
要素では、jwsc
Ant タスクの完全修飾クラス名を指定します。
jwsc
Ant タスクの srcdir
および destdir
属性のみが必須です。つまり、デフォルトでは、JWS ファイルが参照する Java ファイル (JavaBean 入力パラメータやユーザ定義の例外など) は JWS ファイルと同じパッケージ内にあると想定されています。これに当てはまらない場合は、sourcepath
属性を使用して、これらの他の Java ファイルの最上位ディレクトリを指定します。詳細については、『WebLogic Web サービス リファレンス』の「jwsc」を参照してください。
以下の build.xml
の抜粋では、JWS ファイルに対して jwsc
Ant タスクを実行する基本的な例を示します。
<taskdef name="jwsc"
classname="weblogic.wsee.tools.anttasks.JwscTask" />
<target name="build-service">
<jwsc
srcdir="src"
destdir="output/helloWorldEar">
<jws
file="examples/webservices/hello_world/HelloWorldImpl.java"
type="JAXRPC"/>
</jwsc>
</target>
以下の例は前の例と似ていますが、compiledWsdl
属性を使用して、wsdlc
が生成したアーティファクト (「WSDL から開始する」使用例) を含む JAR ファイルを指定している点が異なります。
<taskdef name="jwsc"
classname="weblogic.wsee.tools.anttasks.JwscTask" />
<target name="build-service">
<jwsc
srcdir="src"
destdir="output/wsdlcEar">
<jws
file="examples/webservices/wsdlc/TemperaturePortTypeImpl.java"
compiledWsdl="output/compiledWsdl/TemperatureService_wsdl.jar"
type="JAXRPC"/>
</jwsc>
</target>
この例では、TemperaturePortTypeImpl.java
ファイルが、独自のビジネス ロジックを含めて更新した、途中まで作成されていた JWS ファイルです。compiledWsdl
属性が指定されて JAR ファイルを指し示しているので、jwsc
Ant タスクでは、JAR に含まれているアーティファクトを再生成することはありません。
このタスクを実際に実行するには、コマンドラインで次のように入力します。
prompt> ant build-service
この節では、jwsc
Ant タスクの非常に簡単な使用例を紹介します。ただし、このタスクには、非常に有用なツールにするための追加の属性と子要素を含めます。以下のような使用方法が考えられます。
@WLXXXTransport
アノテーションをすべてオーバーライドすることも可能です。
jwsc
Ant タスクの詳細および例については、『WebLogic Web サービス リファレンス』の「jwsc」を参照してください。
wsdlc
Ant タスクは WSDL ファイルを入力として取り、WebLogic Web サービスの実装を構成するアーティファクトを生成します。以下のようなアーティファクトがあります。
wsdlc
Ant タスクは JWS SEI とデータ バインディング アーティファクトを一緒に JAR ファイルにパッケージ化します。この JAR ファイルを後で jwsc
Ant タスクに指定します。この JAR ファイルを更新する必要はありません。更新するファイルは JWS 実装クラスのみです。
wsdlc
Ant タスクを実行するには、以下の taskdef
および generate-from-wsdl
ターゲットを build.xml
ファイルに追加します。
<taskdef name="wsdlc"
classname="weblogic.wsee.tools.anttasks.WsdlcTask"/>
<target name="generate-from-wsdl">
<wsdlc
srcWsdl="WSDL_file
"
destJwsDir="JWS_interface_directory
"
destImplDir="JWS_implementation_directory
"
packageName="Package_name
"
type="WebService_type"/>
</target>
WSDL_file
- 部分的な実装を生成する元となる WSDL ファイルの名前 (絶対パスまたは相対パスを含める)。 JWS_interface_directory
- JWS SEI およびデータ バインディング アーティファクトを含む JAR ファイルの生成先となるディレクトリ。
生成される JAR ファイルの名前は WSDLFile
_wsdl.jar
です (WSDLFile
は WSDL ファイルのルート名)。たとえば、file 属性に対して指定した WSDL ファイルの名前が MyService.wsdl
の場合、生成される JAR ファイルは MyService_wsdl.jar
となります。
JWS_implementation_directory
- 途中まで作成済みの JWS 実装ファイルの生成先となる最上位ディレクトリ。ファイルはパッケージ名に対応するサブディレクトリ階層に生成されます。
生成される JWS ファイルの名前は PortType
Impl.java
です。PortType
は、Web サービスを生成する WSDL ファイル内の <portType>
要素の name
属性です。たとえば、ポート タイプ名が MyServicePortType
の場合、JWS 実装ファイルは MyServicePortTypeImpl.java
という名前になります。
Package_name
- 生成される JWS SEI および実装ファイルの生成先となるパッケージ。この属性を指定しない場合、wsdlc
Ant タスクは、WSDL の targetNamespace
に基づいてパッケージ名を生成します。WebService_type
- Web サービスの種類。この値は、JAXWS または JAXRPC に設定できます。
必須の taskdef
要素では、wsdlc
Ant タスクの完全修飾クラス名を指定します。
wsdlc
Ant タスクでは、srcWsdl
および destJwsDir
属性のみが必須です。ただし、通常は、プログラミングを容易にするために、途中まで作成済みの JWS ファイルを生成します。WSDL ファイルの targetNamespace
が、読み取り可能なパッケージ名への変換に適していない場合に備えて、パッケージ名を明示的に指定することをお勧めします。
以下の build.xml
の抜粋では、WSDL ファイルに対して wsdlc
Ant タスクを実行する例を示します。
<taskdef name="wsdlc"
classname="weblogic.wsee.tools.anttasks.WsdlcTask"/>
<target name="generate-from-wsdl">
<wsdlc
srcWsdl="wsdl_files/TemperatureService.wsdl"
destJwsDir="output/compiledWsdl"
destImplDir="impl_output"
packageName="examples.webservices.wsdlc"
type="JAXRPC" />
</target>
TemperatureService.wsdl
という名前で、build.xml
ファイルを格納するディレクトリの wsdl_files
サブディレクトリにある。output/compiledWsdl
ディレクトリに生成され、JAR ファイルの名前は TemperatureService_wsdl.jar
。 examples.webservices.wsdld
。 impl_output/examples/webservices/wsdlc
ディレクトリに生成される。 TemperaturePortType
の場合、JWS 実装ファイルの名前は TemperaturePortTypeImpl.java
になる。
このタスクを実際に実行するには、コマンドラインで次のように入力します。
prompt> ant generate-from-wsdl
詳細については、『WebLogic Web サービス リファレンス』の「wsdlc」を参照してください。
wsdlc
Ant タスクは、destImplDir 属性で指定されたディレクトリに、途中まで作成済みの JWS 実装ファイルを生成します。ファイルの名前は PortType
Impl.java
です (PortType
は元の WSDL にある portType の名前)。このクラス ファイルには、独自のビジネス ロジックを除いて、Web サービスへコンパイルするために必要なすべてのものが含まれています。
JWS クラスは、WSDL ファイルに対応する JWS Web サービス エンドポイント インタフェースを実装しています。この JWS SEI も wsdlc
によって生成され、他のアーティファクト (WSDL 内の XML スキーマ データ型の Java 表現など) が含まれている JAR ファイル内に置かれています。JWS クラスのパブリック メソッドは WSDL ファイル内のオペレーションに対応しています。
wsdlc
Ant タスクは、JWS 実装クラスに @WebService
および @WLHttpTransport
アノテーションを自動的に含めます。属性の値は WSDL 内の関連する値に対応しています。たとえば、@WebService
の serviceName
属性は、WSDL ファイル内の <service>
要素の name
属性と同じです。@WLHttpTransport
の contextPath
および serviceUri
属性は共に、WSDL 内の <address>
要素の location
属性で指定されたエンドポイント アドレスを構成します。
JWS ファイルを更新するときは、該当の Web サービス オペレーションが希望どおりに動作するように、メソッドに Java コードを追加します。通常、生成される JWS ファイルには、コードを追加すべき場所に次のようなコメントがあります。
//ここを独自の実装で置き換える
また、他の JWS アノテーションをファイルに追加することもできますが、以下のような制限があります。
javax.jws
パッケージのアノテーションは、@WebService
、@HandlerChain
、@SOAPMessageHandler
、および @SOAPMessageHandlers
のみ。javax.jws
パッケージの他の JWS アノテーションを指定し、JWS ファイルを Web サービスにコンパイルしようとすると、jwsc
Ant タスクはエラーを返します。@WebService
アノテーションでは、serviceName
および endpointInterface
属性のみを指定できる。まれに、WSDL ファイルに複数の <service>
要素が指定されていることがあります。その場合は、serviceName
属性を使用して、wsdlc
Ant タスクで使用していたものとは別の <service>
WSDL 要素を指定します。wsdlc
Ant タスクで生成された JWS SEI を指定するには、endpointInterface
属性を使用します。
JWS ファイルを更新したら、wsdlc
の出力ディレクトリにそのまま置いておかないで、正式なソースの場所に移動することをお勧めします。
以下の例は、「サンプル WSDL ファイル」の WSDL から wsdlc
が生成した JWS 実装ファイルです。太字のテキストは、Web サービスの 1 つのオペレーション (getTemp
) を実装する Java コードを追加する場所を示しています。
package examples.webservices.wsdlc;
import javax.jws.WebService;
import weblogic.jws.*;
/**
* TemperaturePortTypeImpl クラスは、Web サービスのエンドポイント インタフェース
* TemperaturePortType を実装する */
@WebService(
serviceName="TemperatureService",
endpointInterface="examples.webservices.wsdlc.TemperaturePortType")
@WLHttpTransport(
contextPath="temp",
serviceUri="TemperatureService",
portName="TemperaturePort")
public class TemperaturePortTypeImpl implements TemperaturePortType {
public TemperaturePortTypeImpl() {
}
public float getTemp(java.lang.String zipcode)
{
// ここを独自の実装で置き換える
return 0;
}
}
Web サービスはエンタープライズ アプリケーションとしてパッケージ化されるので、Web サービスのデプロイとは、該当する EAR ファイルまたは展開されたディレクトリをデプロイすることになります。
Administration Console の使用から weblogic.Deployer
Java ユーティリティの使用まで、WebLogic アプリケーションのデプロイには多様な方法があります。開発環境とは異なり、プロダクション環境にアプリケーションをデプロイする際には、他にもさまざまな問題を考慮する必要があります。デプロイメントの詳細については、『WebLogic Server アプリケーションのデプロイメント』を参照してください。
このガイドでは、開発の性質上、Web サービスの 2 つのデプロイ方法についてのみ説明します。
反復的な開発プロセスの一環として Web サービスをデプロイする最も簡単な方法は、wldeploy
WebLogic Ant タスクを実行するターゲットを、jwsc
Ant タスクが含まれる同じ build.xml
ファイルに追加することです。Java コードを追加してサービスを再生成するたびに、サービスの再デプロイとテストを繰り返し行えるように、Web サービスをデプロイするターゲットとアンデプロイするターゲットの両方を追加することができます。
wldeploy
Ant タスクを使用するには、以下のターゲットを build.xml
ファイルに追加します。
<target name="deploy">
<wldeploy action="deploy"
name="DeploymentName"
source="Source" user="AdminUser"
password="AdminPassword"
adminurl="AdminServerURL"
targets="ServerName"/>
</target>
jwsc
Ant タスクが展開されたエンタープライズ アプリケーション ディレクトリを生成します。t3://localhost:7001
。
たとえば、以下の wldeploy
タスクでは、エンタープライズ アプリケーションの展開されたディレクトリ (カレント ディレクトリに対して相対的な output/ComplexServiceEar
にある) が myServer
WebLogic Server インスタンスにデプロイされることを指定します。デプロイメント名は ComplexServiceEar
です。
<target name="deploy">
<wldeploy action="deploy"
name="ComplexServiceEar"
source="output/ComplexServiceEar" user="weblogic"
password="weblogic" verbose="true"
adminurl="t3://localhost:7001"
targets="myserver"/>
</target>
Web サービスを実際にデプロイするには、コマンドラインで deploy
ターゲットを実行します。
prompt> ant deploy
ソース コードに変更を加えてから Web サービスを再デプロイできるように、Web サービスを簡単にアンデプロイするターゲットを追加することもできます。
<target name="undeploy">
<wldeploy action="undeploy"
name="ComplexServiceEar"
user="weblogic"
password="weblogic" verbose="true"
adminurl="t3://localhost:7001"
targets="myserver"/>
</target>
Web サービスをアンデプロイするときは、source
属性を指定する必要はなく、名前によってアンデプロイします。
Administration Console を使用して Web サービスをデプロイするには、最初に、ブラウザで次の URL を使用して Web サービスを呼び出します。
http://[host
]:[port
]/console
次にデプロイメント アシスタントを使用して、エンタープライズ アプリケーションをデプロイします。Administration Console の詳細については、Administration Console オンライン ヘルプを参照してください。
Web サービスの WSDL をブラウザで表示して、Web サービスが適切にデプロイされていることを確認できます。
次の URL は、Web サービスの WSDL をブラウザで表示する方法を示しています。
http://[host
]:[port
]/[contextPath
]/[serviceUri
]?WSDL
host
- WebLogic Server が動作しているコンピュータの名前 (localhost
など)。port
- WebLogic Server がリスンしているポート番号 (デフォルト値は 7001
)。contextPath
- Web サービスのコンテキスト ルート。コンテキスト ルートを設定する場所としては、@WLHttpTransport
アノテーションの contextPath
属性、jwsc
の <WLHttpTransport>
、<module>
、または <jws>
要素があり、オーバーライドの順位が決まっています。詳細については、『WebLogic Web サービス リファレンス』の「Defining the Context Path of a WebLogic Web Service」を参照してください。serviceUri
- Web サービスを実装する JWS ファイルの @WLHttpTransport
JWS アノテーションの serviceUri
属性の値、または jwsc
Ant タスクの <WLHttpTransport>
子要素の値。serviceUri よりも <WLHttpTransport> が優先されます。JWS ファイルまたは jwsc
Ant タスクにおいて serviceUri
属性を 1 つも指定しない場合、Web サービスの serviceUri
はデフォルト値 (*.java
拡張子の付かない JWS ファイルの名前) になります。
たとえば、Web サービスを実装する JWS ファイルで以下の @WLHttpTransport
アノテーションを指定したとします。
...
@WLHttpTransport(contextPath="complex",
serviceUri="ComplexService",
portName="ComplexServicePort")
/**
* この JWS ファイルは WebLogic Web サービスの基本となる
*
*/
public class ComplexServiceImpl {
...
ここでは、jwsc
Ant タスクの <WLHttpTransport>
要素と同等の属性は設定せず、したがって contextPath
や serviceURI
の値はオーバーライドされないこととします。そして、Web サービスが ariel
というホストのデフォルトのポート番号 (7001
) で実行されているとすると、その Web サービスの WSDL を表示する URL は次のようになります。
http://ariel:7001/complex/ComplexService?WSDL
デプロイ済みの Web サービスの WSDL (「動的な WSDL」ともいう) には、特定の Web サービス ポートにアドレス (URI) を割り当てる <address>
要素が含まれています。たとえば、次に示す WSDL の抜粋には、ComplexService
というデプロイ済みの WebLogic Web サービスの一部が記述されています。
<definitions name="ComplexServiceDefinitions"
targetNamespace="http://example.org">
...
<service name="ComplexService">
<port binding="s0:ComplexServiceSoapBinding" name="ComplexServicePort"><s1:address location="http://myhost:7101/complex/ComplexService"/>
</port>
</service>
</definitions>
この例では、ComplexService
Web サービスに ComplexServicePort
というポートが含まれており、そのアドレスは http://myhost:7101/complex/ComplexService
となっています。
WebLogic Server では、このアドレスの complex/ComplexService
の部分が、@WL
XXX
Transport
アノテーションの contextPath
および serviceURI
属性、または jwsc
の各要素に基づいて決定されます (「Web サービスの WSDL の参照」を参照)。一方、アドレスのプロトコルとホストの部分 (この例では http://myhost:7101
) を決定する方法は、以下に示すようにより複雑です。この節では、分かりやすいように、アドレスのプロトコルとホストの部分をまとめて「サーバ アドレス」と呼ぶことにします。
WebLogic Server がデプロイ済みの Web サービスの動的な WSDL 内にパブリッシュするサーバ アドレスは、その Web サービスを HTTP/S や JMS で呼び出せるかどうか、プロキシ サーバをコンフィグレーションしているかどうか、Web サービスがクラスタにデプロイされているかどうか、Web サービスが実際にはコールバック サービスであるかどうかによって異なります。
以下では、これらのコンフィグレーションの違いに応じたサーバ アドレスの決定方法について説明します。また、ニーズに合わせてコンフィグレーションを変更するための手順説明へのリンクも示します。
なお、ここでは、クラスタとスタンドアロン サーバを、WebLogic Server Administration Console を使用してコンフィグレーションすることを前提としています。
Frontend Host
、Frontend HTTP Port
、および Frontend HTTPS Port
が設定されている場合は、動的な WSDL のサーバ アドレスにこれらの値が使用されます。
Administration Console オンライン ヘルプの「クラスタの HTTP 設定のコンフィグレーション」を参照してください。
Frontend Host
、Frontend HTTP Port
、および Frontend HTTPS Port
の値が設定されている場合は、サーバ アドレスにこれらの値が使用されます。
Administration Console オンライン ヘルプの「HTTP プロトコルのコンフィグレーション」を参照してください。
Cluster Address
が設定されている場合は、動的な WSDL のサーバ アドレスにこの値が使用されます。
Administration Console オンライン ヘルプの「クラスタのコンフィグレーション」を参照してください。
Listen Address
が設定されている場合は、サーバ アドレスにこの値が使用されます。
Administration Console オンライン ヘルプの「リスン アドレスのコンフィグレーション」を参照してください。
Frontend Host
、Frontend HTTP Port
、および Frontend HTTPS Port
が設定されている場合は、動的な WSDL のサーバ アドレスにこれらの値が使用されます。
Administration Console オンライン ヘルプの「クラスタの HTTP 設定のコンフィグレーション」を参照してください。
Frontend Host
、Frontend HTTP Port
、および Frontend HTTPS Port
の値が設定されている場合は、サーバ アドレスにこれらの値が使用されます。
Administration Console オンライン ヘルプの「HTTP プロトコルのコンフィグレーション」を参照してください。
Cluster Address
が設定されている場合は、サーバ アドレスにこの値が使用されます。
Administration Console オンライン ヘルプの「クラスタのコンフィグレーション」を参照してください。
Listen Address
が設定されている場合は、サーバ アドレスにこの値が使用されます。
Administration Console オンライン ヘルプの「リスン アドレスのコンフィグレーション」を参照してください。
必須ではありませんが、Web サービスがデプロイされているクラスタまたは個々のサーバのいずれかの Frontend Host
、FrontEnd HTTP Port
、および Frontend HTTPS Port
がプロキシ サーバを指すように明示的に設定することをお勧めします。
Administration Console オンライン ヘルプの「クラスタの HTTP 設定のコンフィグレーション」または「HTTP プロトコルのコンフィグレーション」を参照してください。
WebLogic Web サービスのデプロイメントが完了したら、WebLogic Administration Console に含まれている Web サービス テスト クライアントを使用して、コードを記述することなくサービスをテストできます。複合型を持つ Web サービスや、WebLogic Server の高度な機能 (会話など) を使用する Web サービスも含めて、Web サービスを素早く簡単にテストできます。テスト クライアントはリクエストの完全なログを自動的に保持しているので、ユーザは以前の呼び出しに戻って結果を表示することができます。
デプロイした Web サービスを Administration Console を使用してテストするには、次の手順に従います。
http://[host]:[port]/console
この節では、Web サービスの開発を WebLogic 分割開発ディレクトリ環境に統合する方法について説明します。この WebLogic 機能について理解していること、標準の Java Platform, Enterprise Edition (Java EE) バージョン 5 アプリケーションおよびモジュール (EJB や Web アプリケーションなど) の開発用にこのタイプの環境を設定済みであること、Web サービスの開発が含まれるように build.xml
ファイルを更新しようとしていることを前提としています。
WebLogic 分割開発ディレクトリ環境の詳細については、『WebLogic Server アプリケーションの開発』の「分割開発ディレクトリ環境の作成」および WebLogic Server と一緒にインストールされる splitdir/helloWorldEar
サンプルを参照してください。サンプルは、WL_HOME/
samples/server/examples/src/examples
ディレクトリにあります。WL_HOME
は WebLogic Server がインストールされている最上位ディレクトリです。
たとえば、メイン プロジェクト ディレクトリが /src/helloWorldEar
である場合、/src/helloWorldEar/helloWebService
というディレクトリを作成します。
prompt> mkdir /src/helloWorldEar/helloWebService
helloWebService
ディレクトリの下に、JWS ファイルのパッケージ名に対応するディレクトリ階層を作成します。
たとえば、JWS ファイルが examples.splitdir.hello
パッケージにパッケージ化されている場合は、examples/splitdir/hello
というディレクトリ階層を作成します。
prompt> cd /src/helloWorldEar/helloWebService
prompt> mkdir examples/splitdir/hello
/src/helloWorldEar/helloWebService/examples/splitdir/hello
) に JWS ファイルを置きます。 build.xml
ファイル内に、「jwsc WebLogic Web サービス Ant タスクの実行」の説明に従って jwsc
WebLogic Web サービス Ant タスクの呼び出しを追加して、Web サービスをビルドする新しいターゲットを作成します。
jwsc
の srcdir
属性は、JWS ファイルを格納する最上位ディレクトリ (この例では helloWebService
) を指すようにします。jwsc
の destdir
属性は、wlcompile
に指定するのと同じ送り先ディレクトリを指すようにします。次の例を参照してください。
<target name="build.helloWebService">
<jwsc
srcdir="helloWebService"
destdir="destination_dir
"
keepGenerated="yes" >
<jws file="examples/splitdir/hello/HelloWorldImpl.java"
type="JAXRPC" />
</jwsc>
</target>
この例の destination_dir
は、他の分割開発ディレクトリ環境の Ant タスク (wlappc
や wlcompile
など) も使用する送り先ディレクトリを表します。
build.xml
ファイルのメインの build ターゲットを更新します。<!-- helloWorldEar アプリケーション全体をビルドする -->
<target name="build"
description="Compiles helloWorldEar application and runs appc"
depends="build-helloWebService,compile,appc" />
注意 : | エンタープライズ アプリケーションを実際にビルドするときは、wlappc Ant タスクを実行する前に、jwsc Ant タスクを実行するようにしてください。wlappc を正常に実行するには、jwsc によって生成されるアーティファクトの一部が必要になるためです。この例の場合は、appc ターゲットよりも前に build-helloWebService ターゲットを指定する必要があります。 |
wlcompile
および wlappc
Ant タスクを使用してエンタープライズ アプリケーション全体をコンパイルおよび検証する場合は、両方の Ant タスクで Web サービスのソース ディレクトリを除外するようにしてください。これは、jwsc
Ant タスクで Web サービスのコンパイルとパッケージ化をすでに扱っているからです。次に例を示します。<target name="compile">
<wlcompile srcdir="${src.dir}" destdir="${dest.dir}"
excludes="appStartup,helloWebService">
...
</wlcomplile>
...
</target>
<target name="appc">
<wlappc source="${dest.dir}" deprecation="yes" debug="false"
excludes="helloWebService"/>
</target>
META-INF
プロジェクト ソース ディレクトリにある application.xml
ファイルを更新して、<web>
モジュールを追加し、jwsc
Ant タスクによって生成される WAR ファイルの名前を指定します。
たとえば、helloWorld Web サービスの application.xml
ファイルに以下のように追加します。
<application>
...
<module>
<web>
<web-uri>examples/splitdir/hello/HelloWorldImpl.war</web-uri>
<context-root>/hello</context-root>
</web>
</module>
...
</application>
注意 : | jwsc Ant タスクでは通常、Web サービスを実装する JWS ファイルから Web アプリケーション WAR ファイルが生成されます。ただし、JWS ファイルに javax.ejb.SessionBean が明示的に実装されている場合は例外です。その場合は、application.xml ファイルに <ejb> モジュール要素を追加する必要があります。 |
これで、分割開発ディレクトリ環境は、Web サービスの開発を含むように更新されました。エンタープライズ アプリケーション全体を再ビルドしてデプロイするときに、Web サービスも EAR の一部としてデプロイされます。Web サービスは、「Web サービスの WSDL の参照」で説明されている標準的な方法で呼び出します。
![]() ![]() ![]() |