com.docomostar.fs
クラス StarStorageService

Object
  com.docomostar.fs.StarStorageService

public class StarStorageService
extends Object

[iアプリオプションAPI]

Star 用のストレージデバイスサービスを定義します。

アプリケーションはこのクラスのメソッドを使用してアクセス権を表すインスタンスを取得した後、 StorageDevice.getFolder(AccessToken) メソッドを呼び出してフォルダやファイルへのアク セスを行います。

Star 用のストレージデバイスサービスでは、 アクセス権ごとに別個のフォルダが存在するものとしてストレージデバイスへのアクセスが許可されます。 すなわち、同一フォルダの中にアクセス権の異なるファイルが存在するのではなく、 アクセス権ごとに異なるフォルダが作成され、その中のファイルへのアクセスが許可される、 という形になります。 従って、異なるアクセス権であれば同じファイル名であっても実体としては異なるファイルとなります。

導入されたバージョン:

Star-1.0

フィールドの概要

static int	SHARE_APPLICATION 同じアプリケーションでのみ共有することを表す共有識別子です(=0x08)。
static int	SHARE_CONTENTS_PROVIDER 同じコンテンツプロバイダでのみ共有することを表す共有識別子です(=0x10)。

メソッドの概要

static StarAccessToken

getAccessToken(int access, int share) アクセス権を表すインスタンスを取得します。

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

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

フィールドの詳細

SHARE_APPLICATION

public static final int SHARE_APPLICATION

同じアプリケーションでのみ共有することを表す共有識別子です(=0x08)。 同じ ADF の URL を持つアプリケーションでのみアクセスできます。

関連項目:

定数フィールド値

SHARE_CONTENTS_PROVIDER

public static final int SHARE_CONTENTS_PROVIDER

同じコンテンツプロバイダでのみ共有することを表す共有識別子です(=0x10)。 同じコンテンツプロバイダのアプリケーションであればアクセスできます。

関連項目:

定数フィールド値

メソッドの詳細

getAccessToken

public static StarAccessToken getAccessToken(int access,
                                             int share)

アクセス権を表すインスタンスを取得します。

アクセス識別子としては、 StarAccessToken クラスの ACCESS_ から始まる定数から、 アクセス制限を掛けたい任意の組み合わせを、論理和で指定します。 例えば、同じ UIM で、 かつ同じ機種の場合のみ共有可能としたい場合には、
ACCESS_UIM | ACCESS_PLATFORM
を指定します。

アクセス制限を掛けたくない場合は、0x00 を指定します。 なお、このモデルにおいて StarAccessToken.ACCESS_SERIES は 0x00 として扱われるため、 StarAccessToken.ACCESS_SERIES を指定してもアクセス制限は掛かりません。

共有識別子としては、SHARE_CONTENTS_PROVIDER, SHARE_APPLICATION のいずれかを指定します。

同じアクセス識別子と共有識別子の組み合わせに対して常に同じインスタンスを返すかどうかは機種依存です。 ただし、同じアクセス識別子と共有識別子の組み合わせであれば、 異なるインスタンスであっても同じアクセス権であることを表します。

ADF に UseStorage キーを指定した Star アプリのみこのメソッドを呼び出すことができます。

パラメータ:

access - アクセス識別子を指定します。

share - 共有識別子を指定します。

戻り値:

アクセス権を表すインスタンスを返します。

例外:

IllegalArgumentException -
引数 access に不正な値が指定された場合に発生します。

IllegalArgumentException -
引数 share に不正な値が指定された場合に発生します。

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

SecurityException -
ロック機能などのネイティブ独自のセキュリティ設定により、 ストレージデバイスの使用が許可されない場合に発生します。