com.nttdocomo.util
クラス Timer

java.lang.Object
  |
  +--com.nttdocomo.util.Timer

すべての実装インタフェース:

TimeKeeper

public final class Timer

extends java.lang.Object

implements TimeKeeper

タイマ クラスです。 ワンショットタイマとインターバルタイマをサポートしています。 タイマイベントを受け取るリスナとして TimerListener オブジェクトを登録することができます。 タイマイベントが発生すると、リスナオブジェクトの timerExpired メソッドが呼び出されます。

時間のスコープはアプリケーション単位です。

タイマは、開始時にネイティブのリソースを確保して、停止時に解放します。

[DoJa-2.0]
アプリケーションがサスペンドした場合、タイマは停止します。 すなわち、stop メソッドが呼ばれたのと同じ状態になります。

関連項目:

ShortTimer

コンストラクタの概要

Timer()
タイマオブジェクトを生成します。

メソッドの概要

void	dispose() タイマを破棄します。
int	getResolution() タイマの解像度を取得します。
void	setListener(TimerListener listener) タイマイベントを受け取るリスナオブジェクトを設定します。
void	setRepeat(boolean b) タイマイベントを繰り返し発生させるかどうかを設定します。
void	setTime(int time) タイマイベントの時間間隔を設定します。
void	start() タイマを開始します。
void	stop() タイマを停止します。

クラス java.lang.Object から継承したメソッド

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

Timer

public Timer()

タイマオブジェクトを生成します。 このコンストラクタでは、繰り返しなし(ワンショットタイマ), 設定時間 0ms、 リスナー登録なしに初期化します。

メソッドの詳細

getResolution

public int getResolution()

タイマの解像度を取得します。 タイマの解像度とは、一度タイマイベントが発生してから次にタイマイベントが発生するまでの 最小時間間隔のことを表し、この時間間隔はシステムによって異なります。

定義:

インタフェース TimeKeeper 内の getResolution

戻り値:

タイマの解像度をミリ秒単位で返します。

start

public void start()

タイマを開始します。

定義:

インタフェース TimeKeeper 内の start

例外:

UIException - インターバルタイマで start メソッドが呼び出された後に start メソッドを使用しようとした場合、 または、ワンショットタイマで start メソッドが呼び出された後でタイマ通知がくる前に start メソッドを使用しようとした場合に発生します(ILLEGAL_STATE)。

UIException - ネイティブのリソースが確保できなかった場合に投げられます(NO_RESOURCES)。

stop

public void stop()

タイマを停止します。 タイマが停止しているときにこのメソッドが呼ばれた場合はなにもしません。

定義:

インタフェース TimeKeeper 内の stop

dispose

public void dispose()

タイマを破棄します。 このメソッドを呼び出した後に dispose 以外のメソッドを呼び出した場合は UIException が発生します(ILLEGAL_STATE)。 このメソッドを呼び出した後に dispose メソッドを呼び出した場合は何もしません。

定義:

インタフェース TimeKeeper 内の dispose

setRepeat

public void setRepeat(boolean b)

タイマイベントを繰り返し発生させるかどうかを設定します。 デフォルトでは一度だけ発生させるように設定されます。

パラメータ:

b - 繰り返し発生させる場合は true を、一度だけ発生させる場合は false を指定します。

例外:

UIException - startメソッドが呼び出された後にこのメソッドを呼び出そうとした場合に発生します(ILLEGAL_STATE)。

setTime

public void setTime(int time)

タイマイベントの時間間隔を設定します。

パラメータ:

time - タイマイベントの時間間隔をミリ秒単位で指定します。

例外:

UIException - startメソッドが呼び出された後にこのメソッドを呼び出そうとした場合に発生します(ILLEGAL_STATE)。

IllegalArgumentException - [DoJa-2.0] 引数のtimeが負の値の場合に発生します。

setListener

public void setListener(TimerListener listener)

タイマイベントを受け取るリスナオブジェクトを設定します。 タイマイベントが発生すると、指定されたリスナオブジェクトの timeExpired メソッドが呼び出されます。 リスナは一つだけしか設定できません。 複数指定された場合は最後に設定されたものだけが有効になります。
[DoJa-1.0]
タイマを開始した後にリスナを設定した場合の動作は機種依存です。
[DoJa-2.0]
タイマを開始した後にリスナを設定した場合は、リスナを設定した次のタイマイベントからそのリスナに通知されます。

パラメータ:

listener - リスナオブジェクトを指定します。