|
|
|
|
この短いチュートリアルでは、タイマー コントロールを使用して Web サービスを作成およびテストします。このチュートリアルは高度な内容を含んでおり、Workshop for WebLogic の基本について理解していることが前提となっています。ワークスペース、プロジェクト、およびパッケージを作成する方法、テスト クライアントを使用して Web サービスを実行したりオペレーションをテストしたりする方法などを理解している必要があります。Workshop for WebLogic を操作するのが初めての方は、このチュートリアルを読む前に「チュートリアル : 入門」および「チュートリアル : Web サービス」をお読みになることをお勧めします。
注意 : このチュートリアルでは、新しいワークスペースを作成する必要があります。ワークスペースを既に開いている場合、IDE が再起動されます。開始する前に、この再起動による中断を回避するため、スタンドアロン モードでヘルプを起動し、このトピックを新しいブラウザで指定しておくことをお勧めします。詳細については、「スタンドアロン モードでのヘルプの使用」を参照してください。
この手順のタスクは次のとおりです。
このチュートリアルでは、クライアントの Web サービスを 2 秒ごとにコールバックするタイマー コントロール (com.bea.control.TimerControl 基本クラスのインスタンス) の宣言とインスタンス化を行う Web サービスを作成します。この例では、以下の 2 つの Web サービス オペレーション (Web メソッド) を使用します。
コールバックを受信すると、サンプル プログラムによってコンソール ウィンドウにテキストが表示されるだけです。通常は、プログラムのロジックがコールバックのルーチン内に挿入されていて、適切なアクションを実行します。
タイマー コントロールは会話形式の (ステートレスではない) Web サービス内でのみ作成できます。このチュートリアルでの Web サービスの作成手順は、以下のとおりです。
@WebMethod
public void hello() {
}
Web サービスとタイマー コントロール アノテーションを設定する
この時点で、Web サービスを格納したパッケージを含むプロジェクトが存在しています。エディタのペインには、Web サービスのソース .java ファイルが表示されているはずです。
会話形式の Web サービスは java.io.Serializable インタフェースを実装する必要があります。このインタフェースを Web サービスに設定するには、次の手順に従います。
public class TimerService implements Serializable {
クラス宣言行のマーカー バーにエラー マーカーが表示されます。エラー マーカーを右クリックして、[クイック フィックス] を選択します。
[クイック フィックス] プルダウンが表示されます。
[Serializable をインポートします] をクリックして〔Enter〕を押すと、新しい import 行が生成されてエラーが解決します。
タイマー コントロールを生成するには、次の手順に従います。
@Control private TimerControl timerControl;右側の [アノテーション] ビューに TimerControl アノテーションのプロパティが表示されます。
@TimerControl.TimerSettings(repeatsEverySeconds=2) @Control private TimerControl timerControl;また、[アノテーション] ビューに新しいプロパティ値が表示されます。
2 秒ごとに Web サービスをコールバックする timerControl というタイマー コントロールが作成されました。次に、2 つの Web メソッド (タイマー コントロールを開始するメソッドと停止するメソッド) を定義します。
タイマーを開始する Web メソッドを定義するには、次の手順に従います。
timerControl.start();
System.out.println("**************");
System.out.println("Timer started");
System.out.println("**************");
Web メソッドは以下のようになります。
@Conversation(value=Conversation.Phase.START)
@WebMethod
public void start()
{
timerControl.start();
System.out.println("**************");
System.out.println("Timer started");
System.out.println("**************");
}タイマーを停止する Web メソッドを定義するには、次の手順に従います。
timerControl.stop();
System.out.println("**************");
System.out.println("Timer stopped");
System.out.println("**************");
return "ok";
Web メソッドは以下のようになります。
@Conversation(value=Conversation.Phase.FINISH)
@WebMethod
public String stop()
{
timerControl.stop();
System.out.println("**************");
System.out.println("Timer stopped");
System.out.println("**************");
return "ok";
}
タイマー コントロールのタイマー期限切れの通知に反応するイベント ハンドラを定義するには、次の手順に従います。
System.out.println("***********************************");
System.out.println("Callback received from timer firing");
System.out.println("***********************************");
イベント ハンドラは以下のようになります。
@EventHandler(field="timerControl", eventSet=TimerControl.Callback.class, eventName="onTimeout")
protected void timerControl_Callback_onTimeout(long p0, Serializable p1) {
{
System.out.println("***********************************");
System.out.println("Callback received from timer firing");
System.out.println("***********************************");
}
ここまでで、以下の内容を含む Web サービスが作成されました。
Web サービスのソースは、以下のようになっているはずです。
package timer;
import java.io.Serializable;
import javax.jws.*;
import org.apache.beehive.controls.api.bean.Control;
import com.bea.control.TimerControl;
import weblogic.jws.Conversation;
import org.apache.beehive.controls.api.events.EventHandler;
@WebService
public class TimerService implements Serializable{
@Control
@TimerControl.TimerSettings(repeatsEverySeconds=2)
private TimerControl timerControl;
@WebMethod
@Conversation(value=Conversation.Phase.START)
public void start() {
timerControl.start();
System.out.println("**************");
System.out.println("Timer started");
System.out.println("**************");
}
@WebMethod
@Conversation(value=Conversation.Phase.FINISH)
public String stop() {
timerControl.stop();
System.out.println("**************");
System.out.println("Timer stopped");
System.out.println("**************");
return "ok";
}
@EventHandler(field = "timerControl", eventSet = TimerControl.Callback.class, eventName = "onTimeout")
protected void timerControl_Callback_onTimeout(long p0, Serializable p1) {
System.out.println("***********************************");
System.out.println("Callback received from timer firing");
System.out.println("***********************************");
}
}
Web サービスとタイマー コントロールをテストするには、次の手順に従います。
以下に、操作上のポイントをまとめます。
開始内容とコールバックの結果を確認するには、WebLogic Server コンソール ウィンドウ (ヘッダ バーが「WebLogic Server - 9.2」である [コマンド プロンプト] ウィンドウ) に切り替えます。コンソール ウィンドウは、デフォルトでは、ステータス バーにアイコン化されています。コンソール ウィンドウを開くと、以下のメッセージが表示されており、タイマーが開始しているのが確認できます。
************** Timer started **************これは、start オペレーションによって生成されます。2 秒ごとにタイマーが発動するため、このメッセージはすぐにスクロールされてしまいます。
次に、コンソール ウィンドウにタイマーが発動していることが表示されます。タイマーが発動するごとに、以下のようなステータス情報のブロックが表示されます。
*********************************** Callback received from timer firing ***********************************
これは、2 秒ごとのタイマーの発動時にコールバックを受信するイベント ハンドラによって生成されます。
2 秒ごとのタイマー発動を示すメッセージがコンソール ウィンドウに表示されなくなり、以下の行が表示されます。
************** Timer stopped **************
これで、stop オペレーションが成功しました。
  |
