この短いチュートリアルでは、タイマー コントロールを使用して Web サービスを作成およびテストします。
注意 : このチュートリアルでは、新しいワークスペースを作成する必要があります。ワークスペースをすでに開いている場合、IDE が再起動されます。開始する前に、この再起動による中断を回避するため、スタンドアロン モードでヘルプを起動し、このトピックを新しいブラウザで指定しておくことをお勧めします。詳細については、「スタンドアロン モードでのヘルプの使用」を参照してください。
このチュートリアルのタスクは以下のとおりです。
コールバックを受信すると、サンプル プログラムによってコンソール ウィンドウにテキストが表示されるだけです。通常は、プログラムのロジックがコールバックのルーチン内に挿入されていて、適切なアクションを実行します。
この手順では、Workshop が使用する WebLogic Server ドメインを追加します。このサーバ ドメインには、アプリケーションで必要なランタイム ライブラリが含まれており、アプリケーションはこのサーバにデプロイされます。
この時点で、エディタ ペインの Web サービスのデザイン ビュー ([Designer] ペイン) には、Web サービスを格納したパッケージを含むプロジェクトが表示されています。
会話形式の Web サービスは java.io.Serializable インタフェースを実装する必要があります。このインタフェースを Web サービスに設定するには、次の手順に従います。
- Web サービスのソース ファイルを編集するため、デザイナを右クリックして [ソースの編集] を選択します。Web サービスのクラス定義の行に、以下のように implements Serializable を挿入します。
public class TimerService implements Serializable {
クラス宣言行のマーカー バーにエラー マーカーが表示されます。エラー マーカーを右クリックして、[クイック・フィックス] を選択します。
-
[クイック・フィックス] プルダウンが表示されます。
[Import 'Serializable' (java.io)] をクリックして〔Enter〕を押すと、新しい import 行が生成されてエラーが解決します。[ファイル｜保存] を選択してファイルを保存します。
デフォルトでは、Web サービスを作成したときに hello() メソッドが挿入されています。このメソッドは不要なメソッドです。
- [TimerService.java [Designer]] タブをクリックします。hello() メソッドを右クリックして、[削除] を選択します。
[はい] をクリックして削除を確認します。
タイマー コントロールを生成するには、次の手順に従います。
- Designer ペイン内を右クリックし、[新しいコントロール参照] をクリックします。
[コントロールの選択] ダイアログで [タイマー コントロール] を選択し、[OK] をクリックします。
- [TimerService.java] タブをクリックし、以下のコードが挿入されていることを確認します。
@Control
private TimerControl timerControl;
- コントロール宣言 private
TimerControl timerControl; 内の任意の箇所にカーソルを置きます。
- [プロパティー] ビューをクリックします。
- [プロパティー] ビューで、repeatsEverySeconds の場所を特定します。
[repeatesEverySeconds] の [値] カラムに、値 2 を入力して、〔Enter〕を押します。
- [ソース コード エディタ] ウィンドウでコントロールのアノテーションが以下のように更新されます。
@Control
@TimerControl.TimerSettings(repeatsEverySeconds=2)
private TimerControl timerControl;
〔Ctrl〕+〔S〕を押して作業を保存します。
2 秒ごとに Web サービスをコールバックする timerControl というタイマー コントロールが作成されました。次に、2 つの Web メソッド (タイマー コントロールを開始するメソッドと停止するメソッド) を定義します。
タイマーを開始する Web メソッドを定義するには、次の手順に従います。
- [TimerService.java [Designer]] タブをクリックし、[Designer] タブ内で右クリックし、[新しい Web メソッド] を選択します。
エディタ内に新しいオペレーション (Web メソッド) が作成されます。その際、メソッドのデフォルト名が強調表示されます。
- このメソッドの名前を「start」とし、〔Enter〕を押します。
- start メソッドの名前を右クリックし、プルダウンから [会話の開始] を選択します。
- ここでソース コードを編集し、メソッド本体の return; 文を以下のように置き換えて、タイマーの start メソッドが呼び出されるようにします。
timerControl.start();
System.out.println("**************");
System.out.println("Timer started");
System.out.println("**************");
Web メソッドは以下のようになります。
@WebMethod
@Conversation(Conversation.Phase.START)
public void start()
{
timerControl.start();
System.out.println("**************");
System.out.println("Timer started");
System.out.println("**************");
}
タイマーを停止する Web メソッドを定義するには、次の手順に従います。
- 上記と同様の手順で、stop という名前の Web メソッドを挿入します。メソッド名を右クリックし、[会話の終了] を選択します。
- ソース コード エディタで、メソッド宣言を変更して String 値が返されるようにします。
- タイマー停止のメソッドを呼び出すため、メソッド本体の return; 文を以下のように置き換えます。
timerControl.stop();
System.out.println("**************");
System.out.println("Timer stopped");
System.out.println("**************");
return "ok";
Web メソッドは以下のようになります。
@WebMethod
@Conversation(Conversation.Phase.FINISH)
public String stop()
{
timerControl.stop();
System.out.println("**************");
System.out.println("Timer stopped");
System.out.println("**************");
return "ok";
}
定義した時間が経過したことをタイマー コントロールが通知したときに反応するイベント ハンドラを追加するには、次の手順に従います。
- [Designer] ペインまたはソース コード ペインを右クリックし、[挿入｜コントロール イベント ハンドラ] を選択します。
[イベント ハンドラの挿入] ダイアログで、[timerControl] をクリックして [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 メソッド)
- タイマーを停止するオペレーション (Web メソッド)
- 期限切れになった時点 (この例では 2 秒ごと) で呼び出すイベント ハンドラ
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;
private static final long serialVersionUID = 1L;
@WebMethod
@Conversation(Conversation.Phase.START)
public void start() {
timerControl.start();
System.out.println("**************");
System.out.println("Timer started");
System.out.println("**************");
}
@WebMethod
@Conversation(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("***********************************");
}
}
