com.nttdocomo.system
クラス Bookmark

Object
  |
  +--com.nttdocomo.system.Bookmark

public final class Bookmark
extends Object

携帯電話のネイティブのブックマーク機能にアクセスする手段を提供します。

ブックマークデータの新規登録機能を提供します。 ネイティブデータへのアクセス機能の基本については、 XObjectクラスの説明を参照してください。

ブックマークを新規に登録するためには、 addEntryメソッドに タイトルおよびURLを通常の文字列で渡します。 登録はネイティブのユーザインタフェースを介して行われ、 登録に成功した場合、 addEntryメソッドは戻り値としてダミーのエントリIDを返します。

ミニマムスペック:

導入されたバージョン:
DoJa-3.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キーの指定が必要です。 このメソッドを呼び出すとサスペンドします。

パラメータ:
url - URL(通常文字列)を指定します。
title - タイトル(通常文字列)を指定します。
戻り値:
登録が成功した場合、ダミーのエントリIDとして、 -1 以外の値を返します。 端末 ユーザが登録操作をキャンセルした場合、-1 を返します。
例外:
IllegalStateException - ダウンロード即起動アプリがこのメソッドを呼び出した場合に発生します。
IllegalStateException - 待ち受け実行時の非活性化状態で呼び出された場合に発生します。
NullPointerException - 引数 url が null の場合に発生します。
IllegalArgumentException - 引数 url が端末がサポートするバイト数を超えている場合に発生します。
IllegalArgumentException - 引数 url のスキームが http または https でない場合に発生します。
IllegalArgumentException - 引数 url に、 ネイティブのブックマーク機能で登録できない文字が含まれていた場合に発生します。
SecurityException - ADFにAccessUserInfoキーの指定がないアプリケーションが このメソッドを呼び出した場合に発生します。
SecurityException - ロック機能などのネイティブ独自のセキュリティ設定により、 ブックマークを登録できない場合に発生します。
InterruptedOperationException - 競合条件などにより、登録操作が異常終了した場合に発生します。


NTT DoCoMo,Inc.

本製品または文書は著作権法により保護されており、その使用、複製、再頒布および逆コンパイルを制限するライセンスのもとにおいて頒布されます。NTTドコモ(その他に許諾者がある場合は当該許諾者も含めて)の書面による事前の許可なく、本製品および関連する文書のいかなる部分も、いかなる方法によっても複製することが禁じられます。フォントを含む第三者のソフトウェアは、著作権法により保護されており、その提供者からライセンスを受けているものです。

Sun、Sun Microsystems、Java、J2MEおよびJ2SEは、米国およびその他の国における米国 Sun Microsystems,Inc.の商標または登録商標です。サンのロゴマークは、米国 Sun Microsystems, Inc.の登録商標です。

「iモード」、「iアプリ/アイアプリ」、「i-αppli」ロゴ、「DoJa」はNTTドコモの商標または登録商標です。