IApplication (DoJa 3.5 (APIリファレンス))

概要

パッケージ

クラス

階層ツリー

非推奨 API

索引

ヘルプ

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

com.nttdocomo.ui
クラス IApplication

Object
  |
  +--com.nttdocomo.ui.IApplication

直系の既知のサブクラス:: MApplication

public abstract class IApplication
extends Object

アプリケーションの雛型を提供します。アプリケーションは必ずこのクラスを継承して作成しなければなりません。

このクラスは通常のアプリケーションのライフサイクルを定義します。また、JAM からダウンロード元の URL や ADF のパラメータを取得することができます。
[DoJa-2.0]
JAM から起動形態を取得することができます。また、他のアプリケーションから起動された際のパラメータを取得したり、他のアプリケーションにパラメータを渡して起動したりすることができます。
[DoJa-3.0]
アプリケーションがサスペンドした場合、どのような理由でサスペンドしたか、また、サスペンド中に音声着信などの事象が発生したかどうかを取得することができます。また、トラステッドiアプリケーションでは、 JAM に対してアプリケーションの自動起動時刻の設定および取得を行うことができます。

アプリケーションがサスペンドした場合、サスペンド状態から戻った直後に resume メソッドが呼ばれます。カレントフレームが存在する場合は、 レジュームイベントがそのフレームに投げられたあとに resumeメソッドが呼ばれます。ただし、アプリケーションプログラマはそれらの順序を意識したコーディングをしてはなりません。

このクラスを使用してアプリケーションクラスを作成する場合の注意を以下に示します。

アプリケーションプログラマは、IApplicationクラスのサブクラスのインスタンスを直接生成してはなりません。インスタンスは、アプリケーション実行環境が生成します。
このクラスを継承したクラスでコンストラクタを明示的に定義する場合は、アクセス指定子 public を指定してください。また、引数のあるコンストラクタを使ってアプリケーションのオブジェクトを生成できないことに注意してください。なお、コンストラクタを記述しない場合は、デフォルトコンストラクタが生成されます。
例1: 明示的にコンストラクタを記述しない場合
```
 public MyApp extends IApplication {
   public void start() {
     ...
   }
 }
 
```
例2: 明示的にコンストラクタを記述する例
```
  public MyApp2 extends IApplication {
     public MyApp2() {
       ...
     }
     public void start() {
     ...
     }
 }
 
```

ミニマムスペック：

ミニマムスペックでは、自動起動時刻の設定は、「1回限り」「毎日」「毎週」の日時指定タイプを指定できます。「毎月」「毎年」の日時指定タイプはサポートされないことがあります。
ミニマムスペックでは、自動起動時刻の設定は、4つまで指定できます。

フィールドの概要

static int LAUNCH_AS_LAUNCHER
           iアプリをランチャモードで起動することを示す起動種別です(=4)。

static int LAUNCH_BROWSER
           ブラウザを起動してページを表示することを示す起動種別です(=1)。

static int LAUNCH_IAPPLI
           iアプリを連携モードで起動することを示す起動種別です(=3)。

static int LAUNCH_MAIL_LAST_INCOMING
           最新の未読メールの閲覧画面を起動することを示す起動種別です(=10)。

static int LAUNCH_MAIL_RECEIVED
           メールの受信フォルダを起動することを示す起動種別です(=7)。

static int LAUNCH_MAIL_SENT
           メールの送信フォルダを起動することを示す起動種別です(=8)。

static int LAUNCH_MAIL_UNSENT
           メールの未送信フォルダを起動することを示す起動種別です(=9)。

static int LAUNCH_MAILMENU
           メールメニュー(受信メール、送信メール、メール設定、センター問い合わせ等のメニュー)を起動することを示す起動種別です(=5)。

static int LAUNCH_SCHEDULER
           スケジューラを起動することを示す起動種別です(=6)。

static int LAUNCH_VERSIONUP
           JAMを起動して実行中のiアプリのバージョンアップを行うことを示す起動種別です(=2)。

static int LAUNCHED_AFTER_DOWNLOAD
           ダウンロード直後（通常起動の1回目）に起動されたことを表す起動タイプです(=1)。

static int LAUNCHED_AS_CONCIERGE
           待ち受けアプリケーションとして起動されたことを表す起動タイプです(=3)。

static int LAUNCHED_AS_ILET
           ダウンロード即起動アプリとしてブラウザから起動されたことを表す起動タイプです(=9)。

static int LAUNCHED_FROM_BROWSER
           ブラウザからの連携によって起動されたことを表す起動タイプです(=5)。

static int LAUNCHED_FROM_EXT
           外部インタフェースから起動されたことを表す起動タイプです(=4)。

static int LAUNCHED_FROM_IAPPLI
           iアプリからの連携(連携モード)によって起動されたことを表す起動タイプです(=7)。

static int LAUNCHED_FROM_LAUNCHER
           iアプリからの連携(ランチャモード)によって起動されたことを表す起動タイプです(=8)。

static int LAUNCHED_FROM_MAILER
           メーラからの連携によって起動されたことを表す起動タイプです(=6)。

static int LAUNCHED_FROM_MENU
           通常のメニューから起動されたことを表す起動タイプです(=0)。

static int LAUNCHED_FROM_TIMER
           タイマ起動されたことを表す起動タイプです(=2)。

static int LAUNCHED_MSG_RECEIVED
           メッセージiアプリの受信フォルダから起動されたことを表す起動タイプです(=10)。

static int LAUNCHED_MSG_SENT
           メッセージiアプリの送信フォルダから起動されたことを表す起動タイプです(=11)。

static int LAUNCHED_MSG_UNSENT
           メッセージiアプリの未送信フォルダから起動されたことを表す起動タイプです(=12)。

static int SUSPEND_BY_IAPP
           サスペンドの理由を表す属性の一つで、アプリケーションからのメソッド呼び出しを契機としてサスペンドされたことを表します(=2)。

static int SUSPEND_BY_NATIVE
           サスペンドの理由を表す属性の一つで、アプリケーション以外からの割り込みによりサスペンドされたことを表します(=1)。

static int SUSPEND_CALL_IN
           サスペンド理由やサスペンド中の事象を表す属性の一つで、着信履歴に残る音声着信があったことを表します(=0x0400)。

static int SUSPEND_CALL_OUT
           サスペンド理由やサスペンド中の事象を表す属性の一つで、発信履歴に残る音声発信があったことを表します(=0x0200)。

static int SUSPEND_MAIL_RECEIVE
           サスペンド理由やサスペンド中の事象を表す属性の一つで、着信記録が残るメール着信があったことを表します(=0x1000)。

static int SUSPEND_MAIL_SEND
           サスペンド理由やサスペンド中の事象を表す属性の一つで、発信記録が残るメール発信があったことを表します(=0x0800)。

static int SUSPEND_MESSAGE_RECEIVE
           サスペンド理由やサスペンド中の事象を表す属性の一つで、着信記録が残るメッセージ(リクエスト、フリー)着信があったことを表します(=0x2000)。

static int SUSPEND_MULTITASK_APPLICATION
           サスペンド中の事象を表す属性の一つで、マルチタスク機能によって他のアプリケーションに切り替えられたことを表します(=0x8000)。

static int SUSPEND_PACKETIN
           サスペンド理由やサスペンド中の事象を表す属性の一つで、パケット着信(プッシュ)があったことを表します(=0x0100)。

static int SUSPEND_SCHEDULE_NOTIFY
           サスペンド理由やサスペンド中の事象を表す属性の一つで、スケジューラからの通知があったことを表します(=0x4000)。

コンストラクタの概要

IApplication()
          アプリケーションは、直接このクラスのインスタンスを生成してはなりません。

メソッドの概要

String[] getArgs()
          アプリケーションの起動パラメータを取得します。

static IApplication getCurrentApp()
          カレントのアプリケーションオブジェクトを取得します。

ScheduleDate getLaunchTime(int index)
           このアプリケーションの自動起動時刻を取得します。

int getLaunchType()
           アプリケーションの起動形態を取得します。

String getParameter(String name)
           ブラウザなどのネイティブアプリケーションまたはiアプリから起動された場合のパラメータを取得します。

String getSourceURL()
          アプリケーションがダウンロードされた元の URL を取得します。

int getSuspendInfo()
           直前のサスペンドの理由およびそのサスペンド中に起こった事象を取得します。

void launch(int target, String[] args)
           Javaアプリケーションから他のアプリケーションを起動します。

void resume()
          アプリケーションがサスペンド状態から戻った直後に呼ばれるメソッドです。

void setLaunchTime(int index, ScheduleDate date)
           このアプリケーションの自動起動時刻を設定します。

abstract void start()
          アプリケーションが起動したら呼ばれるメソッドです。

void terminate()
          アプリケーションを終了するための唯一のメソッドです。

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

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

フィールドの詳細

LAUNCHED_FROM_MENU

public static final int LAUNCHED_FROM_MENU

通常のメニューから起動されたことを表す起動タイプです(=0)。

導入されたバージョン:: DoJa-2.0
関連項目:: 定数フィールド値

LAUNCHED_AFTER_DOWNLOAD

public static final int LAUNCHED_AFTER_DOWNLOAD

ダウンロード直後（通常起動の1回目）に起動されたことを表す起動タイプです(=1)。

導入されたバージョン:: DoJa-2.0
関連項目:: 定数フィールド値

LAUNCHED_FROM_TIMER

public static final int LAUNCHED_FROM_TIMER

タイマ起動されたことを表す起動タイプです(=2)。

[DoJa-3.0]
ADFのLaunchAtキーによる起動に加えて、 iアプリメニューでの設定による自動起動、 setLaunchTime メソッドでの設定による起動の場合も含みます。

導入されたバージョン:: DoJa-2.0
関連項目:: 定数フィールド値

LAUNCHED_AS_CONCIERGE

public static final int LAUNCHED_AS_CONCIERGE

待ち受けアプリケーションとして起動されたことを表す起動タイプです(=3)。

導入されたバージョン:: DoJa-2.0
関連項目:: 定数フィールド値

LAUNCHED_FROM_EXT

public static final int LAUNCHED_FROM_EXT

外部インタフェースから起動されたことを表す起動タイプです(=4)。

導入されたバージョン:: DoJa-2.0
関連項目:: 定数フィールド値

LAUNCHED_FROM_BROWSER

public static final int LAUNCHED_FROM_BROWSER

ブラウザからの連携によって起動されたことを表す起動タイプです(=5)。

導入されたバージョン:: DoJa-2.0
関連項目:: 定数フィールド値

LAUNCHED_FROM_MAILER

public static final int LAUNCHED_FROM_MAILER

メーラからの連携によって起動されたことを表す起動タイプです(=6)。

導入されたバージョン:: DoJa-2.0
関連項目:: 定数フィールド値

LAUNCHED_FROM_IAPPLI

public static final int LAUNCHED_FROM_IAPPLI

iアプリからの連携(連携モード)によって起動されたことを表す起動タイプです(=7)。

導入されたバージョン:: DoJa-3.0
関連項目:: getLaunchType(), 定数フィールド値

LAUNCHED_FROM_LAUNCHER

public static final int LAUNCHED_FROM_LAUNCHER

iアプリからの連携(ランチャモード)によって起動されたことを表す起動タイプです(=8)。

導入されたバージョン:: DoJa-3.0
関連項目:: getLaunchType(), 定数フィールド値

LAUNCHED_AS_ILET

public static final int LAUNCHED_AS_ILET

ダウンロード即起動アプリとしてブラウザから起動されたことを表す起動タイプです(=9)。

導入されたバージョン:: DoJa-3.0
関連項目:: getLaunchType(), 定数フィールド値

LAUNCHED_MSG_RECEIVED

public static final int LAUNCHED_MSG_RECEIVED

メッセージiアプリの受信フォルダから起動されたことを表す起動タイプです(=10)。

導入されたバージョン:: DoJa-3.0
関連項目:: getLaunchType(), 定数フィールド値

LAUNCHED_MSG_SENT

public static final int LAUNCHED_MSG_SENT

メッセージiアプリの送信フォルダから起動されたことを表す起動タイプです(=11)。

導入されたバージョン:: DoJa-3.0
関連項目:: getLaunchType(), 定数フィールド値

LAUNCHED_MSG_UNSENT

public static final int LAUNCHED_MSG_UNSENT

メッセージiアプリの未送信フォルダから起動されたことを表す起動タイプです(=12)。

導入されたバージョン:: DoJa-3.0
関連項目:: getLaunchType(), 定数フィールド値

SUSPEND_BY_NATIVE

public static final int SUSPEND_BY_NATIVE

サスペンドの理由を表す属性の一つで、アプリケーション以外からの割り込みによりサスペンドされたことを表します(=1)。

導入されたバージョン:: DoJa-3.0
関連項目:: getSuspendInfo(), 定数フィールド値

SUSPEND_BY_IAPP

public static final int SUSPEND_BY_IAPP

サスペンドの理由を表す属性の一つで、アプリケーションからのメソッド呼び出しを契機としてサスペンドされたことを表します(=2)。

導入されたバージョン:: DoJa-3.0
関連項目:: getSuspendInfo(), 定数フィールド値

SUSPEND_PACKETIN

public static final int SUSPEND_PACKETIN

サスペンド理由やサスペンド中の事象を表す属性の一つで、パケット着信(プッシュ)があったことを表します(=0x0100)。
サスペンドの契機となったパケット着信も含みます。すなわち、パケット着信後にメールやメッセージ(R,F)を受信するためにサスペンドする場合がありますが、どちらの場合でもサスペンドが発生すると、 getSuspendInfo()の戻り値には SUSPEND_PACKETIN が設定されています。

導入されたバージョン:: DoJa-3.0
関連項目:: getSuspendInfo(), 定数フィールド値

SUSPEND_CALL_OUT

public static final int SUSPEND_CALL_OUT

サスペンド理由やサスペンド中の事象を表す属性の一つで、発信履歴に残る音声発信があったことを表します(=0x0200)。

導入されたバージョン:: DoJa-3.0
関連項目:: getSuspendInfo(), 定数フィールド値

SUSPEND_CALL_IN

public static final int SUSPEND_CALL_IN

サスペンド理由やサスペンド中の事象を表す属性の一つで、着信履歴に残る音声着信があったことを表します(=0x0400)。

導入されたバージョン:: DoJa-3.0
関連項目:: getSuspendInfo(), 定数フィールド値

SUSPEND_MAIL_SEND

public static final int SUSPEND_MAIL_SEND

サスペンド理由やサスペンド中の事象を表す属性の一つで、発信記録が残るメール発信があったことを表します(=0x0800)。
FOMA 端末では SMS 発信も含みます。

導入されたバージョン:: DoJa-3.0
関連項目:: getSuspendInfo(), 定数フィールド値

SUSPEND_MAIL_RECEIVE

public static final int SUSPEND_MAIL_RECEIVE

サスペンド理由やサスペンド中の事象を表す属性の一つで、着信記録が残るメール着信があったことを表します(=0x1000)。
FOMA 端末では SMS 着信も含みます。

導入されたバージョン:: DoJa-3.0
関連項目:: getSuspendInfo(), 定数フィールド値

SUSPEND_MESSAGE_RECEIVE

public static final int SUSPEND_MESSAGE_RECEIVE

サスペンド理由やサスペンド中の事象を表す属性の一つで、着信記録が残るメッセージ(リクエスト、フリー)着信があったことを表します(=0x2000)。

導入されたバージョン:: DoJa-3.0
関連項目:: getSuspendInfo(), 定数フィールド値

SUSPEND_SCHEDULE_NOTIFY

public static final int SUSPEND_SCHEDULE_NOTIFY

サスペンド理由やサスペンド中の事象を表す属性の一つで、スケジューラからの通知があったことを表します(=0x4000)。
アラームからの通知を含みます。

導入されたバージョン:: DoJa-3.0
関連項目:: getSuspendInfo(), 定数フィールド値

SUSPEND_MULTITASK_APPLICATION

public static final int SUSPEND_MULTITASK_APPLICATION

サスペンド中の事象を表す属性の一つで、マルチタスク機能によって他のアプリケーションに切り替えられたことを表します(=0x8000)。
マルチタスク機能を搭載している FOMA 端末でのみ使用されます。

導入されたバージョン:: DoJa-3.5
関連項目:: getSuspendInfo(), 定数フィールド値

LAUNCH_BROWSER

public static final int LAUNCH_BROWSER

ブラウザを起動してページを表示することを示す起動種別です(=1)。

launch(int target, String[] args) メソッドのtarget引数として利用できます。その場合、args[0]にはブラウザで表示するページの URL を表す String オブジェクトを指定します。
[DoJa-3.0]
指定したURLが255バイトを超える場合、 URLのスキームがhttpまたはhttpsでない場合、 IllegalArgumentExceptionが発生します。バイト数はデフォルトのエンコーディングで評価します。

導入されたバージョン:: DoJa-2.0
関連項目:: launch(int, String[]), 定数フィールド値

LAUNCH_VERSIONUP

public static final int LAUNCH_VERSIONUP

JAMを起動して実行中のiアプリのバージョンアップを行うことを示す起動種別です(=2)。

launch(int target, String[] args) メソッドのtarget引数として利用できます。その場合、argsに指定された値は無視されます。nullを指定してもかまいません。

導入されたバージョン:: DoJa-3.0
関連項目:: launch(int, String[]), 定数フィールド値

LAUNCH_IAPPLI

public static final int LAUNCH_IAPPLI

iアプリを連携モードで起動することを示す起動種別です(=3)。

iアプリに引数を渡すことができます。

launch(int target, String[] args) メソッドのtarget引数として利用できます。その場合、 args[0]に起動先アプリケーションのADFのURLを指定し、 args[1]以降に、起動先アプリケーションに渡すパラメータの名前と値の組を順番に指定します。 n 番目のパラメータの名前を args[n*2+1] に、その値を args[n*2+2] に指定します。 args[1]以降の偶数個の連続した非nullの値をパラメータの名前と値の組として認識し、それ以外は無視します。アプリケーションに渡すパラメータ(名前と値の組)は最大16個であり、パラメータの名前と値の両方を含めて、その合計のバイト数は255バイトまでです。パラメータの数が16を超える場合(args[1]以降に非nullの値が34以上連続してある場合)、またはその合計バイト数が255バイトを超える場合、 IllegalArgumentExceptionが発生します。バイト数はデフォルトのエンコーディングで評価します。同じ名前のパラメータが複数ある場合、起動先アプリケーションでは最初に現われたものが取得できます。
起動先アプリケーションでは、 getParameter(String) メソッドの引数にパラメータの名前を指定することにより、そのパラメータの値を取得できます。
指定したURLのアプリケーションが存在しない場合、 SecurityExceptionが発生します。

導入されたバージョン:: DoJa-3.0
関連項目:: launch(int, String[]), 定数フィールド値

LAUNCH_AS_LAUNCHER

public static final int LAUNCH_AS_LAUNCHER

iアプリをランチャモードで起動することを示す起動種別です(=4)。

iアプリに引数を渡すことはできません。

launch(int target, String[] args) メソッドのtarget引数として利用できます。その場合、 args[0]に起動先アプリケーションのIDを文字列で指定します。指定されたIDの文字列は、 Integer.parseInt(String)メソッドにより評価されます。 Integer.parseInt(String)メソッドがNumberFormatExceptionをスローする場合、このメソッドもNumberFormatExceptionをスローします (NumberFormatExceptionはIllegalArgumentExceptionのサブクラスです)。
指定したIDのアプリケーションが存在しない場合、アプリケーションを強制終了させるか尋ねるダイアログが出ます。強制終了させられなかった場合、SecurityExceptionが発生します。

導入されたバージョン:: DoJa-3.0
関連項目:: launch(int, String[]), 定数フィールド値

LAUNCH_MAILMENU

public static final int LAUNCH_MAILMENU

メールメニュー(受信メール、送信メール、メール設定、センター問い合わせ等のメニュー)を起動することを示す起動種別です(=5)。

launch(int target, String[] args) メソッドのtarget引数として利用できます。その場合、 argsに指定された値は無視されます。nullを指定してもかまいません。
この起動種別は、パーミッションとしてネイティブメーラの利用が許可されているトラステッドiアプリケーションからのみ使用可能です。パーミッションとしてネイティブメーラの利用が許可されていないアプリケーションから使用された場合、アプリケーションは強制終了します。

[DoJa-3.5]
PDC 端末では、launch メソッドでのユーザ確認で起動を許可された場合、アプリケーションを終了してメーラを起動します。
FOMA 端末では、launch メソッドでのユーザ確認で起動を許可された場合、アプリケーションをサスペンドしてメーラを起動します。メーラの終了後、アプリケーションはレジュームします。

導入されたバージョン:: DoJa-3.0
関連項目:: launch(int, String[]), 定数フィールド値

LAUNCH_SCHEDULER

public static final int LAUNCH_SCHEDULER

スケジューラを起動することを示す起動種別です(=6)。
端末によってはサポートされない場合があります。

launch(int target, String[] args) メソッドのtarget引数として利用できます。その場合、argsにnullを指定すると端末の日付でスケジューラが起動します。 null以外を指定した場合の動作は機種依存です。

スケジューラの起動をサポートしていない端末の場合、 launchメソッドはUnsupportedOperationExceptionをスローします。
launchメソッドによりスケジューラの起動に成功しても、アプリケーションは終了せず、サスペンドします。スケジューラの終了後、レジュームします。

導入されたバージョン:: DoJa-3.0
関連項目:: launch(int, String[]), 定数フィールド値

LAUNCH_MAIL_RECEIVED

public static final int LAUNCH_MAIL_RECEIVED

メールの受信フォルダを起動することを示す起動種別です(=7)。

PDC 端末では、launch メソッドでのユーザ確認で起動を許可された場合、アプリケーションを終了してメーラを起動します。
FOMA 端末では、launch メソッドでのユーザ確認で起動を許可された場合、アプリケーションをサスペンドしてメーラを起動します。メーラの終了後、アプリケーションはレジュームします。

導入されたバージョン:: DoJa-3.5
関連項目:: launch(int, String[]), 定数フィールド値

LAUNCH_MAIL_SENT

public static final int LAUNCH_MAIL_SENT

メールの送信フォルダを起動することを示す起動種別です(=8)。

導入されたバージョン:: DoJa-3.5
関連項目:: launch(int, String[]), 定数フィールド値

LAUNCH_MAIL_UNSENT

public static final int LAUNCH_MAIL_UNSENT

メールの未送信フォルダを起動することを示す起動種別です(=9)。

導入されたバージョン:: DoJa-3.5
関連項目:: launch(int, String[]), 定数フィールド値

LAUNCH_MAIL_LAST_INCOMING

public static final int LAUNCH_MAIL_LAST_INCOMING

最新の未読メールの閲覧画面を起動することを示す起動種別です(=10)。メーラを起動して、最新の未読メール(MailAgent.getLastIncoming() メソッドで取得できるメール)を閲覧する画面を表示します。最新の未読メールが存在しない場合は、何もせずに戻ります。

導入されたバージョン:: DoJa-3.5
関連項目:: launch(int, String[]), MailAgent.getLastIncoming(), 定数フィールド値

コンストラクタの詳細

IApplication

public IApplication()

アプリケーションは、直接このクラスのインスタンスを生成してはなりません。

メソッドの詳細

getArgs

public final String[] getArgs()

アプリケーションの起動パラメータを取得します。このメソッドで、ADF で指定されたパラメータを取得することができます。

戻り値:: アプリケーションの起動パラメータを表す文字列の配列を返します。 ADF でパラメータが指定されていない場合は長さ 0 の配列を返します。

getParameter

public final String getParameter(String name)

ブラウザなどのネイティブアプリケーションまたはiアプリから起動された場合のパラメータを取得します。このメソッドで、HTML ページやメール、起動元のiアプリで指定されたパラメータを取得することができます。

パラメータ:: name - 取得するパラメータの名前を指定します。
戻り値:: パラメータを表す文字列を返します。パラメータがない場合はnullを返します。
導入されたバージョン:: DoJa-2.0

getSourceURL

public final String getSourceURL()

アプリケーションがダウンロードされた元の URL を取得します。たとえば、アプリケーションが格納されたJAR形式ファイルが、 http://www.foo.com/download/prog/App1.jar でロードされた場合、戻り値は、"http://www.foo.com/download/prog/" になります。

戻り値:: ダウンロード元の URL を表す文字列を返します。

getLaunchType

public final int getLaunchType()

アプリケーションの起動形態を取得します。

戻り値:: アプリケーションの起動形態を返します。
導入されたバージョン:: DoJa-2.0

getCurrentApp

public static final IApplication getCurrentApp()

カレントのアプリケーションオブジェクトを取得します。

戻り値:: カレントのアプリケーションオブジェクトを返します。

start

public abstract void start()

アプリケーションが起動したら呼ばれるメソッドです。

resume

public void resume()

アプリケーションがサスペンド状態から戻った直後に呼ばれるメソッドです。レジューム処理が必要な場合、IApplicationを継承したクラスで、このメソッドをオーバライドします。

terminate

public final void terminate()

アプリケーションを終了するための唯一のメソッドです。 IApplicationのスコープでSystem.exit()が呼ばれた場合には SecurityExceptionが発生します。

launch

public final void launch(int target,
                         String[] args)

Javaアプリケーションから他のアプリケーションを起動します。このメソッドが呼ばれると現在実行中のJavaアプリケーションはサスペンドされ、ユーザ確認のダイアログが表示されます。ユーザが他のアプリケーションの起動を許可した場合、基本的には現在実行中のJavaアプリケーションを終了して他のアプリケーションを起動しますが、起動するアプリケーションの種類によってはJavaアプリケーションをサスペンドしたまま他のアプリケーションを起動します。ユーザが起動を許可しなかった場合は、このメソッドから戻ってJavaアプリケーションの実行を継続します。

[DoJa-2.0]
利用可能なアプリケーションの種類は、 LAUNCH_BROWSERです。これ以外を指定した場合、IllegalArgumentException をスローします。
[DoJa-3.0]
利用可能なアプリケーションの種類は、 LAUNCH_BROWSER、 LAUNCH_VERSIONUP、 LAUNCH_IAPPLI、 LAUNCH_AS_LAUNCHER、 LAUNCH_MAILMENU、 LAUNCH_SCHEDULER のいずれかです。これ以外を指定した場合、IllegalArgumentException をスローします。ただし、LAUNCH_SCHEDULERは端末によってはサポートされないことがあります。詳細はLAUNCH_SCHEDULERを参照して下さい。
[DoJa-3.5]
利用可能なアプリケーション、ならびに、引数targetに指定可能な値は、

ブラウザ (LAUNCH_BROWSER)
バージョンアップ (LAUNCH_VERSIONUP)
iアプリ (LAUNCH_IAPPLI、 LAUNCH_AS_LAUNCHER)
メーラ (LAUNCH_MAILMENU、 LAUNCH_MAIL_RECEIVED、 LAUNCH_MAIL_SENT、 LAUNCH_MAIL_UNSENT、 LAUNCH_MAIL_LAST_INCOMING)
スケジューラ (LAUNCH_SCHEDULER)

のいずれかです。 targetにこれらの値を指定した場合の振る舞いや、argsの意味については、それぞれの値の説明を参照して下さい。当該箇所に特に言及されていない場合には、期待されている長さより長い配列をargsに指定しても、配列中の冗長な部分は無視され、通常通りに振る舞います。 targetに上記以外の値を指定した場合、 IllegalArgumentException をスローします。
なお、LAUNCH_SCHEDULERは端末によってはサポートされないことがあります。詳細はLAUNCH_SCHEDULERを参照して下さい。

パラメータ:: target - 起動するアプリケーションの種類を指定します。; args - 起動するアプリケーションに渡す引数を指定します。引数の意味は起動するアプリケーションによって異なります。
例外:: UnsupportedOperationException - スケジューラ機能が未サポートで、かつ、引数 target に LAUNCH_SCHEDULER が指定された場合に発生します。; IllegalArgumentException - 引数 target に不正な値が指定された場合に発生します。; NullPointerException - [DoJa-3.0] argsに引数の指定が必要な場合に、 argsや必要なargsの要素がnullである場合に発生します。; IllegalArgumentException - 引数argsに不正な値が指定された場合に発生します。; IllegalStateException - (ブラウザ起動、メーラ起動以外)
[DoJa-3.0] ダウンロード即起動アプリから呼び出された場合に発生します。; IllegalStateException - (ブラウザ起動以外)
[DoJa-3.0] 待ち受け実行時の非活性化状態で呼び出された場合に発生します。; IllegalStateException - (ブラウザ起動)
待ち受け実行時にブラウザを起動しようとした場合に発生します。; SecurityException - (ブラウザ起動)
ADFにUseBrowserキーの指定がない場合に発生します。; SecurityException - (iアプリ起動[連携モード])
[DoJa-3.0] 異なるホストから提供されている起動先アプリケーションを指定した場合に発生します。具体的には、引数に指定されたURLのホスト名(FQDN)と、このアプリケーションのADFのURLのホスト名(FQDN)が一致していない場合に発生します。; SecurityException - (iアプリ起動[連携モード])
[DoJa-3.0] ADFにLaunchAppキーの指定が無い場合に発生します。; SecurityException - (iアプリ起動[連携モード])
[DoJa-3.0] 起動先のアプリケーションとして自分自身を指定した場合に発生します。; SecurityException - (iアプリ起動[連携モード])
[DoJa-3.0] 起動先のアプリケーションが存在しない場合に発生します。; SecurityException - (iアプリ起動[連携モード])
[DoJa-3.0] トラステッドiアプリケーションが、一般(非トラステッド)iアプリケーションを指定した場合に発生します。; SecurityException - (iアプリ起動[ランチャモード])
[DoJa-3.0] ADFにLaunchAppキーの指定が無い場合に発生します。; SecurityException - (iアプリ起動[ランチャモード])
[DoJa-3.0] 起動先のアプリケーションとして自分自身のIDを指定した場合に発生します。; SecurityException - (iアプリ起動[ランチャモード])
[DoJa-3.0] 起動先アプリケーションとして指定したIDに該当するアプリケーションが無い場合に発生します。; SecurityException - (iアプリ起動[ランチャモード])
[DoJa-3.0] ADFのLaunchByAppキーで許可されていないアプリケーションを起動先アプリケーションとして指定してした場合に発生します。; SecurityException - (スケジューラ起動)
ADFのAccessUserInfoキーの指定が無い場合に発生します。
導入されたバージョン:: DoJa-2.0

getSuspendInfo

public int getSuspendInfo()

直前のサスペンドの理由およびそのサスペンド中に起こった事象を取得します。サスペンド中に起こった事象の取得については、端末によってはサポートされない場合があります。

値はビット論理和により得られます。サスペンドが起こっていない場合には、0 を返します。
アプリケーションのメソッド呼び出しを契機とするによるサスペンドの場合、 SUSPEND_BY_IAPPビットが設定されています。メール着信など外部からの割り込みによるサスペンドの場合、 SUSPEND_BY_NATIVEビットが設定されています。サスペンドが起こっていない場合を除き、この2つのビットの一方が必ず1に設定されています。両方が1に設定されていることはありません。

取得できる事象には、 SUSPEND_PACKETIN、 SUSPEND_CALL_OUT、 SUSPEND_CALL_IN、 SUSPEND_MAIL_SEND、 SUSPEND_MAIL_RECEIVE、 SUSPEND_MESSAGE_RECEIVE、 SUSPEND_SCHEDULE_NOTIFY があります。
例えば、パケット着信があり、メールの受信を行った場合、
SUSPEND_BY_NATIVE | SUSPEND_PACKETIN | SUSPEND_MAIL_RECEIVE
が返ります。

[DoJa-3.5]
FOMA 端末では、取得できる事象に SUSPEND_MULTITASK_APPLICATION もあります。

戻り値:: サスペンドの理由およびサスペンド中の事象を返します。
導入されたバージョン:: DoJa-3.0

setLaunchTime

public void setLaunchTime(int index,
                          ScheduleDate date)

このアプリケーションの自動起動時刻を設定します。「1回限り」「毎日」「毎週」 (オプションで「毎月」「毎年」)の起動時刻を設定できます。 iアプリメニューから設定できる起動時刻や ADFのLaunchAtキーで指定される起動時刻とは無関係です。

引数 date に null を指定すると、スケジュールを削除します。また、すでにスケジュールが設定されているスケジュール番号を指定した場合、スケジュールは上書きされます。自動起動がおこなれても設定したスケジュールの内容は削除されません。アプリケーションがバージョンアップされると、このメソッドで設定した起動時刻の設定はすべて削除されます。

自動起動の試みは起動の成否にかかわらず、次の起動予定時刻に対して1回しか行われません。次の起動予定時刻を過ぎた端末の時計を起動予定時刻前に戻しても、すでに実装により自動起動の試みが行われた場合 (電源オフ中に自動起動が失敗していると判断済みの場合も含む)には、起動予定時刻になっても自動起動は行われません。これは「1回限り」の起動でも繰り返し起動でも同じです。

パーミッションとしてｉアプリ自動起動APIの利用が許可されているトラステッドiアプリケーションのみこのメソッドを呼び出すことができます。

ミニマムスペックでは、自動起動時刻の設定は、「1回限り」「毎日」「毎週」の日時指定タイプを指定できます。「毎月」「毎年」の日時指定タイプはサポートされないことがあります。また、最低4つまでのスケジュール時刻が指定できます。

パラメータ:: index - 設定するスケジュール番号を指定します。スケジュール番号は0から始まります。; date - 起動スケジュールを指定します。 nullを指定すると、スケジュールを削除します。過去の時刻を指定しても例外は発生しません。
例外:: IllegalArgumentException - 範囲外のスケジュール番号を指定した場合に発生します。; IllegalArgumentException - サポートされない日時指定タイプの起動時刻を指定した場合に発生します。; IllegalArgumentException - サポートされない範囲の日時の起動時刻 (例えば、1900年など)を指定した場合に発生します。
導入されたバージョン:: DoJa-3.0
関連項目:: getLaunchTime(int)

getLaunchTime

public ScheduleDate getLaunchTime(int index)

このアプリケーションの自動起動時刻を取得します。 setLaunchTime メソッドで設定した自動起動時刻が取得できます。 iアプリメニューから設定できる起動時刻や ADFのLaunchAtキーで指定される起動時刻は取得できません。