com.nttdocomo.util
クラス Timer

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

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

TimeKeeper

public final class Timer

extends java.lang.Object

implements TimeKeeper

タイマ クラスです。ワンショットタイマとインターバルタイマをサポートしています。タイマイベントを受 け取るリスナとして TimerListener オブジェクトを登録することができます。タイマイベントが発生する と、リスナオブジェクトの timerExpired メソッドが呼び出されます。 時間のスコープはアプリケーション単位です。 タイマは、開始時にネイティブのリソースを確保して、停止時に解放します。

関連項目:

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()

タイマを開始します。ネイティブのリソースが確保できなかった場合は例外が発生します。 タ イマが開始後にこのメソッドが呼ばれた場合は、UIException(ILLEGAL_STATE)が発生し ます。

定義:

インタフェース TimeKeeper 内の start

例外:

UIException - リソースが確保できなかった場合、start メソッドが呼び出された後に start メ ソッドが呼び出された場合に投げられます。ステータスは以下のようになります。

 NO_RESOURCES
 	リソースが確保できなかった場合に投げられます。
 ILLEGAL_STATE
 	インターバルタイマの場合にstart メソッドが呼び出された後にstart メソッドを使用しよう
 としたとき、またはワンショットタイマの場合に、start メソッドが呼び出された後でタイマ通知が
 くる前にstart メソッドを使用しようとしたとき、または、dispose()メソッドが呼び出された後にこ
 のメソッドを使用しようとしたときに投げられます。
 

stop

public void stop()

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

定義:

インタフェース TimeKeeper 内の stop

例外:

UIException - dispose メソッドが呼び出された後に、このメソッドを使用しようとした場合に 投げられます。ステータスは、ILLEGAL_STATE です。

dispose

public void dispose()

タイマを破棄します。 dispose() を呼び出した後にそのオブジェクトに対して何らかのメソッド を呼び出した場合、UIException が投げられます。dispose メソッドを呼び出したあとに、 dispose メソッドを呼び出した場合は、なにもしません。

定義:

インタフェース TimeKeeper 内の dispose

setRepeat

public void setRepeat(boolean b)

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

パラメータ:

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

例外:

UIException - dispose メソッドが呼び出された後、または、start メソッドが呼び出された後 に、このメソッドを使用しようとした場合に投げられます。ステータスは、ILLEGAL_STATE で す。

setTime

public void setTime(int time)

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

パラメータ:

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

例外:

UIException - dispose メソッドが呼び出された後、または、start メソッドが呼び出された後 に、このメソッドを使用しようとした場合に投げられます。ステータスは、ILLEGAL_STATE で す。

setListener

public void setListener(TimerListener listener)

タイマイベントを受け取るリスナオブジェクトを設定します。 タイマイベントが発生すると、指定 されたリスナオブジェクトの timerExpired メソッドが呼び出されます。 リスナは一つだけし か設定できません。複数指定された場合は最後に設定されたものだけが有効になります。 またタイマを開始した後にリスナを設定してはいけません。

戻り値:

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