概要  パッケージ   クラス  階層ツリー  非推奨 API  索引  ヘルプ 
 前のクラス   次のクラス フレームあり    フレームなし    
概要: 入れ子 | フィールド | コンストラクタ | メソッド 詳細: フィールド | コンストラクタ | メソッド

com.docomostar.device
クラス StorageDevice

Object
  上位を拡張 com.docomostar.device.StorageDevice

public class StorageDevice
extends Object
 [iアプリオプションAPI]

ストレージデバイスを定義します。 ストレージデバイスがアクセス可能かどうか、などの状態を取得したり、 実際にフォルダやファイルにアクセスするためのインスタンスを取得したりすることができます。

ストレージデバイス内のフォルダやファイルにアクセスするには、 デバイス名を指定してストレージデバイスのインスタンスを取得した後にアクセス権を指定してフォルダを取得します。 なお、デバイス名は ASCII 文字列で、最大でも 8 文字です。

外部メモリにアクセスするには、 デバイス名として "/ext0" を指定してインスタンスを取得します。 基本的に、外部メモリのスロットおよびメディアに対する操作はこのクラスで行いますが、 メディア内のファイルシステムに対する操作は com.docomostar.fs パッケージの Folder クラスや File クラスで行います。

Star API では、アクセス権を表すインスタンスは StarStorageService クラスを使用して取得します。 アクセス権の考え方やインスタンスの取得方法については StarStorageService クラスの説明を参照してください。

ストレージデバイス機能全体における注意事項
ネイティブ機能がストレージデバイスを占有使用する場合など、ストレージデバイスへのアクセスが禁止される場合が存在します。 そのようなアクセス禁止中に、ストレージデバイスに対するファイル入出力を伴なう ( IOException が発生し得る)メソッドを呼び出した場合、 IOException が発生します。 ファイル入出力を伴なうメソッドは、このクラスのメソッドに限りません。

導入されたバージョン:
Star-1.0

フィールドの概要
static String CAPABILITY_EXFAT
           メディアの能力を表す文字列で、exFAT であることを表します(= "exFAT")。
static String CAPABILITY_FAT_LONG_NAME
           メディアの能力を表す文字列で、FAT でロングネームをサポートしていることを表します(= "FAT_LONG_NAME")。
static String CAPABILITY_FAT12
           メディアの能力を表す文字列で、FAT12 であることを表します(= "FAT12")。
static String CAPABILITY_FAT16
           メディアの能力を表す文字列で、FAT16 であることを表します(= "FAT16")。
static String CAPABILITY_FAT32
           メディアの能力を表す文字列で、FAT32 であることを表します(= "FAT32")。
static String CAPABILITY_MINISD
           メディアの能力を表す文字列で、miniSD Memory Card もしくは microSD Memory Card であることを表します(= "miniSD")。
static String CAPABILITY_SD
           メディアの能力を表す文字列で、SD Memory Card であることを表します(= "SD")。
static String CAPABILITY_SD_BINDING
           メディアの能力を表す文字列で、SD-Binding をサポートしていることを表します(= "SD-Binding")。
static String CATEGORY_ENCRYPTION
           メディアの能力のカテゴリを表す文字列で、暗号化を表します(= "encryption")。
static String CATEGORY_FILESYSTEM
           メディアの能力のカテゴリを表す文字列で、ファイルシステムを表します(= "filesystem")。
static String CATEGORY_HARDWARE
           メディアの能力のカテゴリを表す文字列で、ハードウェアを表します(= "hardware")。
 
メソッドの概要
 String[] getCapability(String category)
           メディアの能力を取得します。
 String getDeviceName()
           ストレージデバイスのデバイス名を取得します。
 Folder getFolder(AccessToken accessToken)
           フォルダのインスタンスを取得します。
static StorageDevice getInstance(String deviceName)
           デバイス名を指定してストレージデバイスのインスタンスを取得します。
 String getMediaId()
           メディアの識別子を取得します。
 String getPrintName()
           ストレージデバイスの表示名を取得します。
 boolean isAccessible()
           メディアにアクセス可能かどうかを取得します。
 boolean isReadable()
           メディアが読み出し可能かどうかを取得します。
 boolean isRemovable()
           メディアがリムーバブルかどうかを取得します。
 boolean isWritable()
           メディアが書き込み可能かどうかを取得します。
 
クラス Object から継承されたメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

CATEGORY_HARDWARE

public static final String CATEGORY_HARDWARE

メディアの能力のカテゴリを表す文字列で、ハードウェアを表します(= "hardware")。 メディアの能力を取得する際に getCapability(String) メソッドの引数に指定します。

関連項目:
定数フィールド値

CAPABILITY_SD

public static final String CAPABILITY_SD

メディアの能力を表す文字列で、SD Memory Card であることを表します(= "SD")。 ハードウェアを表すカテゴリのメディアの能力を取得した際、 SD Memory Card であった場合に getCapability(String) メソッドの戻り値として返されます。

関連項目:
定数フィールド値

CAPABILITY_MINISD

public static final String CAPABILITY_MINISD

メディアの能力を表す文字列で、miniSD Memory Card もしくは microSD Memory Card であることを表します(= "miniSD")。 ハードウェアを表すカテゴリのメディアの能力を取得した際、 miniSD Memory Card もしくは microSD Memory Card であった場合に getCapability(String) メソッドの戻り値として返されます。

関連項目:
定数フィールド値

CATEGORY_FILESYSTEM

public static final String CATEGORY_FILESYSTEM

メディアの能力のカテゴリを表す文字列で、ファイルシステムを表します(= "filesystem")。 メディアの能力を取得する際に getCapability(String) メソッドの引数に指定します。

関連項目:
定数フィールド値

CAPABILITY_FAT12

public static final String CAPABILITY_FAT12

メディアの能力を表す文字列で、FAT12 であることを表します(= "FAT12")。 ファイルシステムを表すカテゴリのメディアの能力を取得した際、 FAT12 であった場合に getCapability(String) メソッドの戻り値として返されます。

関連項目:
定数フィールド値

CAPABILITY_FAT16

public static final String CAPABILITY_FAT16

メディアの能力を表す文字列で、FAT16 であることを表します(= "FAT16")。 ファイルシステムを表すカテゴリのメディアの能力を取得した際、 FAT16 であった場合に getCapability(String) メソッドの戻り値として返されます。

関連項目:
定数フィールド値

CAPABILITY_FAT32

public static final String CAPABILITY_FAT32

メディアの能力を表す文字列で、FAT32 であることを表します(= "FAT32")。 ファイルシステムを表すカテゴリのメディアの能力を取得した際、 FAT32 であった場合に getCapability(String) メソッドの戻り値として返されます。

関連項目:
定数フィールド値

CAPABILITY_EXFAT

public static final String CAPABILITY_EXFAT

メディアの能力を表す文字列で、exFAT であることを表します(= "exFAT")。 ファイルシステムを表すカテゴリのメディアの能力を取得した際、 exFAT であった場合に getCapabil