javax.microedition.midlet
クラス MIDlet

java.lang.Object
  javax.microedition.midlet.MIDlet

public abstract class MIDlet
extends Object

MIDlet は MID Profile アプリケーション自身を示します。 アプリケーション管理ソフトウェアが MIDlet をコントロールし、アプリケーションディスクリプタから設定を取得し、状態変更に関する通知および要求することを可能にするために、アプリケーションはこのクラスを拡張（extends）しなければなりません。 このクラスのメソッドは、アプリケーション管理ソフトウェアが MIDlet を作成、開始、休止、破棄することを可能にします。 MIDlet は、実行および制御をアプリケーション管理ソフトウェアが行うためにデザインされたインタフェースを持つ、１セットのクラスです。 「状態（state）」は、アプリケーション管理ソフトウェアがランタイム環境内の複数の MIDlet の活動を管理することを可能にします。 いずれかの MIDlet を個別に開始および休止することにより所定の時間にアクティブに選択することができます。 アプリケーション管理ソフトウェアは、MIDlet の状態を維持し、状態を変更するために、MIDlet のメソッドを呼び出します。 MIDlet は、アプリケーション管理ソフトによって呼び出される、内部の活動およびリソースの使用状況を更新するこれらのメソッドをインプリメントします。 MIDlet はいくつかの状態変更を自身で始めることができ、適切なメソッドの呼び出しによりそれらの状態変更をアプリケーション管理ソフトウェアに通知します。

注釈:このメソッドの呼び出しによって、インタフェースシグナル状態を変更します。 状態変更を行うメソッドの呼び出しが返るまで、状態変更は完全ではありません。 これらのメソッドは迅速に処理が返されることが意図されています。

MIDlet

protected MIDlet()

サブクラスのための protected コンストラクタです。

startApp

protected abstract void startApp()
                          throws MIDletStateChangeException

その MIDlet が開始し、アクティブ状態になったことを通知します。 アクティブ状態の MIDlet は、リソースを所有することができます。 MIDlet が休止状態の場合にメソッドを呼び出します。

継続的な失敗と一時的な失敗の２種類の失敗はサービスが開始するのを防ぐことができます。 一時的な失敗は、MIDletStateChangeException 例外を throw すべきです。 一時的ではない失敗については、notifyDestroyed() メソッドを呼び出すべきです。

例外:

MIDletStateChangeException - MIDlet を現在開始することができないが、今後開始することができる可能性がある場合に throw します。

pauseApp

protected abstract void pauseApp()

その MIDlet が休止し、休止状態に入ることを通知します。 休止状態の MIDlet はリソースを開放し、不活性となります。 MIDlet がアクティブ状態の場合にメソッドを呼び出します。

もし、この destroyApp の処理中に実行時例外が throw された場合、直ちに破棄状態へ移行します。 この際、クリーンナップが許可されるなら、MIDlet の destroyApp(boolean) メソッドを呼び出します。

destroyApp

protected abstract void destroyApp(boolean unconditional)
                            throws MIDletStateChangeException

MIDlet に破棄状態に移行し、終了することを伝えます。 破棄状態では、MIDlet はリソースを全て開放し、（必要に応じて）全ての永続的な状態を保存します。 このメソッドは休止状態あるいはアクティブ状態から呼ばれます。

MIDlet は、終了する前に、リソースを開放するか、必要な情報あるいは状態を保存など、要求された全てのオペレーションを実行完了しなければなりません。

注釈： MIDlet は、MIDletStateChangeException を throw することにより、破棄状態へ移行しないように要求することができます。 ただし、これが有効なのは unconditional が false の場合のみです。 この値が true の場合、MIDlet はこのメソッドがどのように終了するかに関わらず、破棄状態へ移行すると仮定します。 それが無条件の要求ではない場合、MIDlet は MIDletStateChangeException を throw することにより、現在の状態に留まることを望んでいることを示すことができます。 この要求が受け入れられると、destroyApp メソッドを後に再び呼び出します。

もし、この destroyApp の処理中に実行時例外が throw された場合、その実行時例外は無視して破棄状態へ移行します。

パラメータ:

unconditional - 必ずクリーンナップおよびリソースの開放を行う必要がある場合は true を、破棄状態に必ずしも遷移しなくてもよい場合は false を渡します。 この場合、MIDlet は破棄状態に移行しないことを望む場合には MIDletStateChangeException を throw します。

例外:

MIDletStateChangeException - MIDlet が実行しつづけることを望む場合に throw します。 この要求は unconditional が true の場合、無視されます。

notifyDestroyed

public final void notifyDestroyed()

MIDlet が破棄状態へ移行し始めたことをアプリケーション管理ソフトウェアに通知するために使用します。 アプリケーション管理ソフトウェアは MIDlet の destroyApp メソッドを呼び出すことはありません。 また、MIDlet によって確保された全てのリソースは再利用できるものとみなします。 MIDlet は、そのために必要とされるオペレーション（リソースの開放やクリーンナップ処理等）を実行する必要があるのであれば、destroyApp(boolean) メソッドを呼び出されたのと同じように処理を記述しなければなりません。

notifyPaused

public final void notifyPaused()

MIDlet がアクティブ状態から休止状態に入ることをアプリケーション管理ソフトウェアに通知します。 MIDlet が破棄状態へ移行する場合および MIDlet がまだ開始されていない場合は、このメソッドの呼び出しは効果がありません。

アクティブ状態の場合、MIDlet によって呼び出すことができます。

MIDlet が notifyPause() メソッドを呼び出す場合、今後再びアクティブ状態に移行する際に startApp() メソッドを呼び出します。 また、自身が破棄状態に移行する際には destroyApp(boolean) メソッドが呼び出されます。

getAppProperty

public final String getAppProperty(String key)

アプリケーション管理ソフトから指定された名前のプロパティを取り出すためのメカニズムを MIDlet に提供します。 プロパティはアプリケーションディスクリプタファイル（JAD ファイル）とマニフェストの組み合わせから取り出されます。 もし、ディスクリプタのアトリビュートがマニフェストのアトリビュートと同じ名前で設定されている場合、ディスクリプタの値が使用されマニフェストの値は無視されます。

パラメータ:

key - プロパティの名前を渡します。

戻り値:

対応するプロパティの値が文字列で返します。 対応する値が存在しなければ null を返します。

例外:

NullPointerException - name に null を渡すと throw します。

resumeRequest

public final void resumeRequest()

アクティブ状態へ移行したいことを MIDlet が示すためのメカニズムを提供します。 アプリケーション管理ソフトウェアはアクティブ状態にどのアプリケーションを移行させるか決定するために、このメソッドの呼び出しを使用することができます。

アプリケーション管理ソフトウェアがこのアプリケーションをアクティブ状態へ移行させることを決定した場合、startApp() メソッドを呼び出します。

このメソッドを呼び出すアプリケーションは一般に休止状態にあります。 休止状態でも、アプリケーションはタイマーまたはコールバックのような非同期イベントを扱うことができます。