com.docomostar.system
クラス Bookmark

Object
  com.docomostar.system.Bookmark

public final class Bookmark
extends Object

携帯電話のネイティブのブックマーク管理機能にアクセスする手段を提供します。 このクラスのインスタンスは、 携帯電話のネイティブのブックマークの 1 つのエントリを表しますが、 インスタンスを取得する手段はありません。

このクラスに定義されているクラスメソッドの使い方や、 ネイティブのデータへのアクセス方法に関する規定の大原則については com.docomostar.system パッケージの記述を参照して下さい。 ただし、エントリ取得機能 (selectEntry、getEntry) は提供されず、 エントリ登録機能 (addEntry(String, String)) についても、 下記の点が大原則と異なります。

addEntry の戻り値について:

このクラスにおいては、addEntry の戻り値には意味がないので、 常にダミーのエントリ ID が返されます。

エントリ登録時の文字列の扱いについて:

タイトル文字列は大原則通りに振る舞いますが、 URL 文字列は、指定する内容によっては例外が発生することがあります。 詳細については addEntry(String, String) を参照して下さい。

ミニマムスペック:

• ミニマムスペックでは、 1件あたりのブックマークのURLは256バイトまで登録できます。 バイト数は、デフォルトのエンコーディングで評価されます。
• ミニマムスペックでは、 1件あたりのブックマークのタイトルは24バイトまで登録できます。
  • [Star-1.1 まで] バイト数は、デフォルトのエンコーディングで評価されます。
  • [Star-1.2 以降] バイト数は、含まれている文字の種類や端末の設定、あるいは端末のマルチリンガル言語サポート有無によって、 デフォルトのエンコーディング、または UTF-8 で評価されます。

導入されたバージョン:

Star-1.0

メソッドの概要

static int

addEntry(String url, String title) ユーザ操作によりブックマークエントリを新規登録します。

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

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

メソッドの詳細

addEntry

public static int addEntry(String url,
                           String title)
                    throws InterruptedOperationException

ユーザ操作によりブックマークエントリを新規登録します。

URL は非 null であり、 スキームが http または https で、 実装がサポートするバイト数以下でなければなりません。 そうでない場合、例外が発生します。 バイト数はデフォルトのエンコーディングで評価します。 一方、 タイトル文字列にはnullを指定することができます。

ADFにAccessUserInfoキーの指定が必要です。 上記以外の動作の詳細については、このクラスの説明、 ならびに、その説明から引用されている com.docomostar.system パッケージに記述されている説明を参照して下さい。

データ保存領域の容量を超えているために登録できない場合は、 ユーザが登録操作をキャンセルした場合と同様の値を返します。

パラメータ:

url - URL(通常文字列)を指定します。

title - タイトル(通常文字列)を指定します。

戻り値:

登録が成功した場合、有効でないエントリIDとして、 -1 以外の値を返します。 ユーザが登録操作をキャンセルした場合、-1 を返します。

例外:

NullPointerException -
引数 url が null の場合に発生します。

IllegalArgumentException -
引数 url が実装がサポートするバイト数を超えている場合に発生します。

IllegalArgumentException -
引数 url のスキームが http または https でない場合に発生します。

IllegalArgumentException -
引数 url に、 ネイティブのブックマーク機能で登録できない文字が含まれていた場合に発生します。

SecurityException -
ADF にAccessUserInfoキーの指定がないアプリケーションが このメソッドを呼び出した場合に発生します。

SecurityException -
ロック機能などのネイティブ独自のセキュリティ設定により、 ブックマークを登録できない場合に発生します。

InterruptedOperationException -
競合条件などにより、登録操作が異常終了した場合に発生します。