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)で繰り返し実行するタイマーを生成します。 |
2 | public javax.ejb.Timer createTimer ( java.util.Date expiration, java.io.Serializable info) | 指定した日時(expiration)に1回だけ実行するタイマーを生成します。 |
3 | public javax.ejb.Timer createTimer ( long initialDuration, long intervalDuration, java.io.Serializable info) | 監視開始から指定された監視持続時間(initialDuration)経過後に1回、その後一定間隔(intervalDuration)で繰り返し実行するタイマーを生成します。 |
4 | public javax.ejb.Timer createTimer ( long duration, java.io.Serializable info) | 監視開始から指定された監視持続時間(duration)経過後に1回だけ実行するタイマーを生成します。 |
5 | public java.util.Collection getTimers () | このメソッドを実行したEJBアプリケーションに紐付けられている活動中のタイマーオブジェクトをすべて取得します。 |
javax.ejb.TimerServiceインタフェースにはcreateTimerメソッドの他にgetTimersメソッドが規定されています。getTimersメソッドを実行するとそのEJBアプリケーションが生成したタイマーのコレクションを取得することができます。タイマーオブジェクトが同一かどうかを確認する場合は、タイマー(javax.ejb.Timer)オブジェクトが持つequalsメソッドを使用してください。(“==”演算子での比較はオブジェクトの同一性を保証しません。)