com.nttdocomo.system.TorucaStore
|
||||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
Object
携帯電話のネイティブのトルカデータ管理機能にアクセスする手段を提供します。
トルカ機能では、
トルカデータの登録や取得を行うクラスと
トルカデータそのものを表すクラスが区別されています。
このクラスはトルカデータの登録や取得を行いますが、
トルカデータそのものはTorucaクラスのオブジェクトとして表されます。
このクラスのインスタンスは、ネイティブのトルカデータの 1 つのエントリを表しますが、 このエントリから取得できるのは、 エントリ ID とトルカデータそのものを表すオブジェクトのみです。
このクラスに定義されているクラスメソッドの使い方や、
ネイティブのデータへのアクセス方法に関する規定の大原則は
com.nttdocomo.system パッケージの記述を参照して下さい。
ただし、エントリ登録機能 (addEntry(Toruca)) については、
下記の点が大原則と異なります。
Toruca.setURL(String)）に例外が発生します。
Toruca.setURL(String)）に例外が発生します。
また、エントリ登録機能について、 トルカ仕様に準拠していないトルカデータが指定された場合には例外が発生します。 具体的には以下の場合になります。
| メソッドの概要 | |
static int |
addEntry(Toruca toruca)
ユーザ操作によりトルカデータをトルカデータフォルダに新規登録します。 |
static int[] |
findByHostAndIpid(String host,
String ipid)
コンテンツ開発者が独自で指定しているID(IP-ID )と、 URL の FQDN を指定して、 検索条件に合致したトルカデータのエントリIDを取得します。 |
static TorucaStore |
getEntry(int id)
トルカデータのエントリ ID を指定して、 ユーザ操作なしにトルカデータのエントリを取得します。 |
int |
getId()
トルカデータのエントリIDを取得します。 |
static int |
getRemainingBytes(Toruca toruca)
トルカデータに設定できる残りバイト数を返します。 |
Toruca |
getToruca()
トルカデータを取得します。 |
static TorucaStore |
selectEntry()
ユーザ操作によりトルカデータフォルダ内に保存されているトルカデータのエントリを取得します。 |
| クラス Object から継承したメソッド |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| メソッドの詳細 |
public static TorucaStore selectEntry()
throws InterruptedOperationException
[DoJa-4.1 (902iS) まで]
パーミッションとして携帯電話情報の参照が許可されているトラステッドiアプリのみこのメソッドを呼び出すことができます。
[DoJa-5.0 (903i) 以降]
ADF に AccessUserInfo キーの指定が必要です。
パーミッションとして携帯電話情報の参照が許可されている場合でも、
このメソッドを呼び出すことができます（推奨されていません）。
ADF に AccessUserInfo キーの指定がなく、かつパーミッションとして携帯電話情報の参照が許可されていない場合には、例外 SecurityException が発生します。
上記以外の動作の詳細については、このクラスの説明、
ならびにその説明から引用されている
com.nttdocomo.system パッケージに記述されている
「エントリ取得時の振る舞い」の説明を参照して下さい。
このメソッドによりトルカデータを取得しても、ネイティブの既読・未読情報は変化しません。
IllegalStateException - [DoJa-5.0 (903i) 以降]
ダウンロード即起動アプリがこのメソッドを呼び出した場合に発生します。
IllegalStateException - 待ち受け実行時の非活性化状態で呼び出された場合に発生します。
SecurityException - [DoJa-5.0 (903i) 以降]
ADFにAccessUserInfoキーの指定がなく、
かつ、パーミッションとして携帯電話情報の参照が許可されていないアプリケーションがこのメソッドを呼び出した場合に発生します。
SecurityException - パーミッションとして携帯電話情報の参照が許可されているが、
iアプリ個別のユーザ設定により許可されない場合に発生します。
SecurityException - ロック機能などのネイティブ独自のセキュリティ設定により、
トルカデータのエントリを取得できない場合に発生します。
InterruptedOperationException - 競合条件などにより、選択操作が異常終了した場合に発生します。
public static TorucaStore getEntry(int id)
throws StoreException
[DoJa-4.1 (902iS) まで]
パーミッションとして携帯電話情報の参照が許可されているトラステッドiアプリのみこのメソッドを呼び出すことができます。
[DoJa-5.0 (903i) 以降]
ADF に AccessUserInfo キーの指定が必要です。
パーミッションとして携帯電話情報の参照が許可されている場合でも、
このメソッドを呼び出すことができます（推奨されていません）。
ADF に AccessUserInfo キーの指定がなく、かつパーミッションとして携帯電話情報の参照が許可されていない場合には、例外 SecurityException が発生します。
上記以外の動作の詳細については、このクラスの説明、
ならびにその説明から引用されている
com.nttdocomo.system パッケージに記述されている
「エントリ取得時の振る舞い」の説明を参照して下さい。
このメソッドによりトルカデータを取得しても、ネイティブの既読・未読情報は変化しません。
id - 取得するトルカデータのエントリIDを指定します。
IllegalStateException - [DoJa-5.0 (903i) 以降]
ダウンロード即起動アプリがこのメソッドを呼び出した場合に発生します。
SecurityException - [DoJa-5.0 (903i) 以降]
ADFにAccessUserInfoキーの指定がなく、
かつ、パーミッションとして携帯電話情報の参照が許可されていないアプリケーションがこのメソッドを呼び出した場合に発生します。
SecurityException - パーミッションとして携帯電話情報の参照が許可されているが、
i アプリ個別のユーザ設定により許可されない場合に発生します。
SecurityException - StoreException -
public static int[] findByHostAndIpid(String host,
String ipid)
throws InterruptedOperationException
検索対象はトルカカードです。 検索項目は URL と IP-ID の AND 検索です。 検索条件は以下の通りです。
また、下記のトルカデータはiアプリから検索できません。
ADF に AccessUserInfo キーの指定が必要です。
検索条件としてコンテンツ開発者が独自で指定している ID ( IP-ID )に不正な値を設定した場合、 null を返します。 また、 該当するトルカデータが存在しない場合にも、 null を返します。
host - トルカデータ内の URL の FQDN を指定します。ipid -
コンテンツ開発者が独自で指定している
ID (IP-ID ) を指定します。
IllegalStateException - ダウンロード即起動アプリがこのメソッドを呼び出した場合に発生します。
IllegalStateException - 待ち受け実行時の非活性化状態で呼び出された場合に発生します。
SecurityException - ADF に AccessUserInfo
キーの指定がないアプリケーションがこのメソッドを呼び出した場合に発生します。
SecurityException - ロック機能などのネイティブ独自のセキュリティ設定により、
トルカデータのエントリを取得できない場合に発生します。
InterruptedOperationException - 競合条件などにより、選択操作が異常終了した場合に発生します。
public static int addEntry(Toruca toruca)
throws InterruptedOperationException
ADFにAccessUserInfoキーの指定が必要です。
上記以外の動作の詳細については、このクラスの説明、
ならびにその説明から引用されている
com.nttdocomo.system
パッケージに記述されている説明を参照して下さい。
このメソッドによりトルカデータを登録すると、 ネイティブの既読・未読情報は既読として登録されます。
データ保存領域の容量を超えているために登録できない場合は、 ユーザが登録操作をキャンセルした場合と同様の値を返します。
toruca - 登録するトルカデータを指定します。
IllegalStateException - ダウンロード即起動アプリがこのメソッドを呼び出した場合に発生します。
IllegalStateException - 待ち受け実行時の非活性化状態で呼び出された場合に発生します。
NullPointerException - 引数 toruca が null の場合に発生します。
IllegalArgumentException - IllegalArgumentException - SecurityException - ADFにAccessUserInfoキーの指定がないアプリケーションがこのメソッドを呼び出した場合に発生します。
SecurityException - ロック機能などのネイティブ独自のセキュリティ設定により、
トルカデータを登録できない場合に発生します。
InterruptedOperationException - 競合条件などにより、登録操作が異常終了した場合に発生します。
public int getId()
public Toruca getToruca()
常に同じオブジェクトへの参照を返します。
public static int getRemainingBytes(Toruca toruca)