com.kddi.io
インタフェース DataFolderConnection　[Phase1〜（一部Phase2〜）]

すべてのスーパーインタフェース:

javax.microedition.io.Connection, javax.microedition.io.ContentConnection, javax.microedition.io.InputConnection, javax.microedition.io.OutputConnection, javax.microedition.io.StreamConnection

public interface DataFolderConnection

extends javax.microedition.io.ContentConnection

データフォルダにアクセスするための Connection インターフェイスです。

Connector.open メソッドの "datafolder:" スキームに対応します。

データファイルを開く場合、

   String url = "datafolder://filename";
   DataFolderConnection conn = (DataFolderConenction)Connector.open(url, Connector.READ);
 

のように、ファイル名を指定します。ファイルの一覧を取得する場合、

   String url = "datafolder://";
   DataFolderConnection conn = (DataFolderConenction)Connector.open(url, Connector.READ);
   String list[] = conn.getList();
 

のように、フォルダー名を指定します。 データフォルダーは読み取り専用なので、いずれの場合にも、 open メソッドの第2引数に Connector.READ を指定する必要があります。

フィールドの概要

static int	FILE_TYPE_ANIME ファイル属性：アニメ。
static int	FILE_TYPE_ETC ファイル属性：その他（ezplusアプリなどオープンできないものは含まない）。
static int	FILE_TYPE_KARAOKE ファイル属性：カラオケ。
static int	FILE_TYPE_MELODY ファイル属性：メロディ。

メソッドの概要

java.lang.String[]	getList() ディレクトリ以外の全ファイルリストを取得する。
java.lang.String[]	getList(int type) 指定したタイプに応じたファイルリストを取得する。
java.lang.String	getName() ファイルの表示名を取得する。
java.lang.String	getType() ファイルのタイプを取得する。
boolean	isCopyrighted() 著作権フラグが設定されているかどうか判別する。

インタフェース javax.microedition.io.ContentConnection から継承したメソッド

getEncoding, getLength

インタフェース javax.microedition.io.InputConnection から継承したメソッド

openDataInputStream, openInputStream

インタフェース javax.microedition.io.Connection から継承したメソッド

close

インタフェース javax.microedition.io.OutputConnection から継承したメソッド

openDataOutputStream, openOutputStream

フィールドの詳細

FILE_TYPE_ANIME　[Phase2〜]

public static final int FILE_TYPE_ANIME

ファイル属性：アニメ。

FILE_TYPE_MELODY　[Phase2〜]

public static final int FILE_TYPE_MELODY

ファイル属性：メロディ。

FILE_TYPE_KARAOKE　[Phase2〜]

public static final int FILE_TYPE_KARAOKE

ファイル属性：カラオケ。

FILE_TYPE_ETC　[Phase2〜]

public static final int FILE_TYPE_ETC

ファイル属性：その他（ezplusアプリなどオープンできないものは含まない）。

メソッドの詳細

getList

public java.lang.String[] getList()
                           throws java.io.IOException

ディレクトリ以外の全ファイルリストを取得する。

戻り値:

String[] - スキームを含む datafolder のリスト。ファイルが存在しない場合はサイズ 0 の配列。

例外:

java.io.IOException - close() 後に呼び出したとき、またはリストが取得できなかったときに送出。

IllegalStateException - ファイル名を指定して開いた datafolder の場合に送出。

getList　[Phase2〜]

public java.lang.String[] getList(int type)
                           throws java.io.IOException

指定したタイプに応じたファイルリストを取得する。

パラメータ:

type - 取得したいファイルのタイプ。

例：メロディかカラオケのファイルリストを取得したい場合は、 DataFolderConnection.FILE_TYPE_MELODY | DataFolderConnection.FILE_TYPE_KARAOKE を指定

戻り値:

String[] - スキームを含む datafolder のリスト。ファイルが存在しない場合はサイズ 0 の配列。

例外:

java.io.IOException - close() 後に呼び出したとき、またはリストが取得できなかったときに送出。

IllegalStateException - ファイル名を指定して開いた datafolder の場合に送出。

isCopyrighted

public boolean isCopyrighted()
                      throws java.io.IOException

著作権フラグが設定されているかどうか判別する。

戻り値:

著作権フラグが設定されているときは true、設定されていないときは false。

例外:

IllegalStateException - ファイル名を指定せずに開いた datafolder の場合に送出。

java.io.IOException - close() 後に呼ばれたときに送出。

getName

public java.lang.String getName()
                         throws java.io.IOException

ファイルの表示名を取得する。

戻り値:

ファイルの表示名。

例外:

IllegalStateException - ファイル名を指定せずに開いた datafolder の場合に送出。

java.io.IOException - close() 後に呼ばれたときに送出。

getType

public java.lang.String getType()

ファイルのタイプを取得する。

定義:

インタフェース javax.microedition.io.ContentConnection 内の getType

戻り値:

ファイルのタイプ。

例外:

IllegalStateException - ファイル名を指定せずに開いた datafolder の場合に送出。