Interstage Application Server/Interstage Web Server J2EE ユーザーズガイド
目次 索引 前ページ次ページ

第3部 EJB編> 第10章 EJBサービスの機能> 10.5 EJBサービスで使用できる時間監視機能> 10.5.5 EJBタイマーサービス

10.5.5.2 監視の開始方法

 EJBタイマーサービス(javax.ejb.TimerService)のインタフェースに規定されているcreateTimerメソッドを実行して、タイマーオブジェクト(javax.ejb.Timer)を生成します。タイマーオブジェクトが生成された時から監視時間のカウントダウンが始まります。createTimerメソッドには以下の表に記載した種類があります。指定時間の単位はミリ秒です。

■javax.ejb.TimerServiceインタフェースに規定されているAPI

項番

メソッド名

説明

1

public javax.ejb.Timer createTimer (
    java.util.Date initialExpiration,
    long intervalDuration,
    java.io.Serializable info)

指定した日時(initialExpiration)に1回、その後一定間隔(intervalDuration)で繰り返し実行するタイマーを生成します。
実行時に渡したい情報がある場合は、infoに指定します(ない場合はnullを指定します)。

2

public javax.ejb.Timer createTimer (
    java.util.Date expiration,
    java.io.Serializable info)

指定した日時(expiration)に1回だけ実行するタイマーを生成します。
実行時に渡したい情報がある場合は、infoに指定します(ない場合はnullを指定します)。

3

public javax.ejb.Timer createTimer (
    long initialDuration,
    long intervalDuration,
    java.io.Serializable info)

監視開始から指定された監視持続時間(initialDuration)経過後に1回、その後一定間隔(intervalDuration)で繰り返し実行するタイマーを生成します。
実行時に渡したい情報がある場合は、infoに指定します(ない場合はnullを指定します)。

4

public javax.ejb.Timer createTimer (
    long duration,
    java.io.Serializable info)

監視開始から指定された監視持続時間(duration)経過後に1回だけ実行するタイマーを生成します。
実行時に渡したい情報がある場合は、infoに指定します(ない場合はnullを指定します)。

5

public java.util.Collection getTimers ()

このメソッドを実行したEJBアプリケーションに紐付けられている活動中のタイマーオブジェクトをすべて取得します。

【補足】
 javax.ejb.TimerServiceインタフェースにはcreateTimerメソッドの他にgetTimersメソッドが規定されています。getTimersメソッドを実行するとそのEJBアプリケーションが生成したタイマーのコレクションを取得することができます。タイマーオブジェクトが同一かどうかを確認する場合は、タイマー(javax.ejb.Timer)オブジェクトが持つequalsメソッドを使用してください。(“==”演算子での比較はオブジェクトの同一性を保証しません。)


目次 索引 前ページ次ページ

Copyright 2008 FUJITSU LIMITED