com.docomostar.system.TorucaStore
|
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||
Object
public final class TorucaStore
携帯電話のネイティブのトルカデータ管理機能にアクセスする手段を提供します。
トルカ機能では、
トルカデータの登録や取得を行うクラスと
トルカデータそのものを表すクラスが区別されています。
このクラスはトルカデータの登録や取得を行いますが、
トルカデータそのものはTorucaクラスのオブジェクトとして表されます。
このクラスのインスタンスは、ネイティブのトルカデータの 1 つのエントリを表しますが、 このエントリから取得できるのは、 エントリ ID とトルカデータそのものを表すオブジェクトのみです。
このクラスに定義されているクラスメソッドの使い方や、
ネイティブのデータへのアクセス方法に関する規定の大原則は
com.docomostar.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
ADF に AccessUserInfo キーの指定が必要です。 キーの指定がない場合には、例外 SecurityException が発生します。
上記以外の動作の詳細については、このクラスの説明、
ならびにその説明から引用されている
com.docomostar.system パッケージに記述されている
「エントリ取得時の振る舞い」の説明を参照して下さい。
このメソッドによりトルカデータを取得しても、ネイティブの既読・未読情報は変化しません。
SecurityException -
SecurityException -
InterruptedOperationException -
public static TorucaStore getEntry(int id)
throws StoreException
ADF に AccessUserInfo キーの指定が必要です。 キーの指定がない場合には、例外 SecurityException が発生します。
上記以外の動作の詳細については、このクラスの説明、
ならびにその説明から引用されている
com.docomostar.system パッケージに記述されている
「エントリ取得時の振る舞い」の説明を参照して下さい。
このメソッドによりトルカデータを取得しても、ネイティブの既読・未読情報は変化しません。
id - 取得するトルカデータのエントリIDを指定します。
SecurityException -
SecurityException -
StoreException -
public static int[] findByHostAndIpid(String host,
String ipid)
throws InterruptedOperationException
検索対象はトルカカードです。 検索項目は URL と IP-ID の AND 検索です。 検索条件は以下の通りです。
また、下記のトルカデータはStar アプリから検索できません。
ADF に AccessUserInfo キーの指定が必要です。
検索条件としてコンテンツ開発者が独自で指定している ID ( IP-ID )に不正な値を設定した場合、 null を返します。 また、 該当するトルカデータが存在しない場合にも、 null を返します。
host - トルカデータ内の URL の FQDN を指定します。ipid - コンテンツ開発者が独自で指定している
ID (IP-ID ) を指定します。
SecurityException -
SecurityException -
InterruptedOperationException -
public static int addEntry(Toruca toruca)
throws InterruptedOperationException
ADFにAccessUserInfoキーの指定が必要です。
上記以外の動作の詳細については、このクラスの説明、
ならびにその説明から引用されている
com.docomostar.system
パッケージに記述されている説明を参照して下さい。
このメソッドによりトルカデータを登録すると、 ネイティブの既読・未読情報は既読として登録されます。
データ保存領域の容量を超えているために登録できない場合は、 ユーザが登録操作をキャンセルした場合と同様の値を返します。
toruca - 登録するトルカデータを指定します。
NullPointerException -
IllegalArgumentException -
SecurityException -
SecurityException -
InterruptedOperationException -
public int getId()
public Toruca getToruca()
常に同じオブジェクトへの参照を返します。
public static int getRemainingBytes(Toruca toruca)
引数に指定されたトルカデータについて、 トルカ仕様に準拠したフォーマットに整形した後のトルカデータ全体のバイト数を計算し、 その値とトルカ仕様上の最大バイト数とを比較して、 トルカデータの残りに設定できるバイト数を返します。 ただし、トルカ仕様上の最大バイト数は、 引数に渡されたトルカデータのトルカ種別によって異なります。 トルカ種別がトルカカードである場合には、 ヘッダ部とスニップデータ部の合計サイズに対する超過は無視され、 トルカデータ全体の最大サイズに対して設定可能な残りバイト数を返します。
toruca - トルカデータを指定します。
NullPointerException -
|
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||
NTT DOCOMO,INC.
本製品または文書は著作権法により保護されており、その使用、複製、再頒布および逆コンパイルを制限するライセンスのもとにおいて頒布されます。NTTドコモ（その他に許諾者がある場合は当該許諾者も含めて）の書面による事前の許可なく、本製品および関連する文書のいかなる部分も、いかなる方法によっても複製することが禁じられます。フォントを含む第三者のソフトウェアは、著作権法により保護されており、その提供者からライセンスを受けているものです。
Sun、Sun Microsystems、Java、J2MEおよびJ2SEは、米国およびその他の国における米国 Sun Microsystems,Inc.の商標または登録商標です。サンのロゴマークは、米国 Sun Microsystems, Inc.の登録商標です。
FeliCaは、ソニー株式会社が開発した非接触ICカードの技術方式です。FeliCaは、ソニー株式会社の登録商標です。
「ｉモード」、「ｉアプリ／アイアプリ」、「ｉ-αppli」ロゴ、「DoJa」はNTTドコモの商標または登録商標です。
その他記載された会社名、製品名などは該当する各社の商標または登録商標です。