パッケージ jakarta.ejb
インターフェース Timer
public interface Timer
Timer インターフェースには、Enterprise Bean タイマーサービスを介して作成されたタイマーに関する情報が含まれています。- 導入:
- EJB 2.1
方法の概要
修飾子と型メソッド説明voidcancel()タイマーとそれに関連するすべての期限切れ通知をキャンセルします。タイマーの直列化可能なハンドルを取得します。getInfo()作成時にタイマーに関連付けられた情報を取得します。次のタイマー満了が発生するようにスケジュールされている時点を取得します。このタイマーに対応するスケジュール式を取得します。long次にスケジュールされているタイマーの期限切れまでに経過するミリ秒数を取得します。booleanこのタイマーがカレンダーベースのタイマーかどうかを返します。booleanこのタイマーに永続的なセマンティクスがあるかどうかを返します。
メソッドの詳細
cancel
タイマーとそれに関連するすべての期限切れ通知をキャンセルします。- 例外:
IllegalStateExceptionSE- インスタンスがこのメソッドへのアクセスを許可しない状態にあるときにこのメソッドが呼び出された場合。NoSuchObjectLocalException- 期限切れまたはキャンセルされたタイマーで呼び出された場合。EJBException- システムレベルの障害のためにこの方法を完了できなかった場合。
getTimeRemaining
long getTimeRemaining() throws IllegalStateExceptionSE, NoSuchObjectLocalException, NoMoreTimeoutsException, EJBException次にスケジュールされているタイマーの期限切れまでに経過するミリ秒数を取得します。- 戻り値:
- 次にスケジュールされているタイマーの有効期限が切れるまでに経過するミリ秒数。
- 例外:
IllegalStateExceptionSE- インスタンスがこのメソッドへのアクセスを許可しない状態にあるときにこのメソッドが呼び出された場合。NoMoreTimeoutsException- タイマーに将来のタイムアウトがないことを示しますNoSuchObjectLocalException- 期限切れまたはキャンセルされたタイマーで呼び出された場合。EJBException- システムレベルの障害のためにこの方法を完了できなかった場合。
getNextTimeout
DateSE getNextTimeout() throws IllegalStateExceptionSE, NoSuchObjectLocalException, NoMoreTimeoutsException, EJBException次のタイマー満了が発生するようにスケジュールされている時点を取得します。- 戻り値:
- 次のタイマー満了が発生するようにスケジュールされている時点。
- 例外:
IllegalStateExceptionSE- インスタンスがこのメソッドへのアクセスを許可しない状態にあるときにこのメソッドが呼び出された場合。NoMoreTimeoutsException- タイマーに将来のタイムアウトがないことを示しますNoSuchObjectLocalException- 期限切れまたはキャンセルされたタイマーで呼び出された場合。EJBException- システムレベルの障害のためにこの方法を完了できなかった場合。
getSchedule
ScheduleExpression getSchedule() throws IllegalStateExceptionSE, NoSuchObjectLocalException, EJBExceptionこのタイマーに対応するスケジュール式を取得します。タイマーはカレンダーベースのタイマーでなければなりません。自動またはプログラムで作成された可能性があります。- 戻り値:
- タイマーのスケジュール式。
- 例外:
IllegalStateExceptionSE- インスタンスがこのメソッドへのアクセスを許可しない状態にあるときにこのメソッドが呼び出された場合。カレンダーベースのタイマーではないタイマーで呼び出された場合にもスローされます。NoSuchObjectLocalException- 期限切れまたはキャンセルされたタイマーで呼び出された場合。EJBException- システムレベルの障害のためにこの方法を完了できなかった場合。- 導入:
- EJB 3.1
isPersistent
このタイマーに永続的なセマンティクスがあるかどうかを返します。- 戻り値:
- タイマーが永続的かどうかを示すブール。
- 例外:
IllegalStateExceptionSE- インスタンスがこのメソッドへのアクセスを許可しない状態にあるときにこのメソッドが呼び出された場合。NoSuchObjectLocalException- 期限切れまたはキャンセルされたタイマーで呼び出された場合。EJBException- システムレベルの障害のためにこの方法を完了できなかった場合。- 導入:
- EJB 3.1
isCalendarTimer
このタイマーがカレンダーベースのタイマーかどうかを返します。- 戻り値:
- タイマーがカレンダーベースかどうかを示すブール。
- 例外:
IllegalStateExceptionSE- インスタンスがこのメソッドへのアクセスを許可しない状態にあるときにこのメソッドが呼び出された場合。NoSuchObjectLocalException- 期限切れまたはキャンセルされたタイマーで呼び出された場合。EJBException- システムレベルの障害のためにこの方法を完了できなかった場合。- 導入:
- EJB 3.1
getInfo
作成時にタイマーに関連付けられた情報を取得します。これは、タイマー作成メソッドに渡されたinfo文字列、またはScheduleアノテーションのinfo要素である可能性があります。- 戻り値:
- タイマーの作成時に渡された Serializable オブジェクト、またはタイマーの作成時に渡された info 引数が null の場合は null。
- 例外:
IllegalStateExceptionSE- インスタンスがこのメソッドへのアクセスを許可しない状態にあるときにこのメソッドが呼び出された場合。NoSuchObjectLocalException- 期限切れまたはキャンセルされたタイマーで呼び出された場合。EJBException- システムレベルの障害のためにこの方法を完了できなかった場合。
getHandle
タイマーへの直列化可能なハンドルを取得します。このハンドルは、後でタイマー参照を取得するために使用できます。- 戻り値:
- タイマーへのシリアライズ可能なハンドル。
- 例外:
IllegalStateExceptionSE- インスタンスがこのメソッドへのアクセスを許可しない状態にあるときにこのメソッドが呼び出された場合。非永続タイマーで呼び出された場合にもスローされます。NoSuchObjectLocalException- 期限切れまたはキャンセルされたタイマーで呼び出された場合。EJBException- システムレベルの障害のためにこの方法を完了できなかった場合。