AIR ファイルの基礎

Adobe AIR には、ファイルとフォルダの両方に対するアクセス、作成および管理に使用できるクラスが用意されています。これらのクラスは、flash.filesystem パッケージに含まれており、次のように使用します。

Adobe AIR には、ファイルとフォルダの両方に対するアクセス、作成および管理に使用できるクラスが用意されています。これらのクラスは、runtime.flash.filesystem パッケージに含まれており、次のように使用します。

File クラス

説明

File

File オブジェクトは、ファイルまたはディレクトリへのパスを表します。File オブジェクトを使用してファイルまたはフォルダへのポインタを作成することで、ファイルまたはフォルダの操作を実行できるようになります。

FileMode

FileMode クラスは、fileMode パラメータで使用されるストリング定数を定義します。このパラメータは、FileStream クラスの open() メソッドおよび openAsync() メソッドで指定します。これらのメソッドの fileMode パラメータによって、ファイルが開かれたときに FileStream オブジェクトで使用できる機能（書き込み、読み取り、追加および更新）が決まります。

FileStream

FileStream オブジェクトは、ファイルを開いて読み取りと書き込みを行うために使用されます。新規または既存のファイルを参照する File オブジェクトを作成してそのポインタを FileStream オブジェクトに渡すと、そのファイルを開いてファイル内のデータを操作できるようになります。

File クラスのメソッドには、同期バージョンと非同期バージョンの両方を持つものがあります。

  • File.copyTo() および File.copyToAsync()

  • File.deleteDirectory() および File.deleteDirectoryAsync()

  • File.deleteFile() および File.deleteFileAsync()

  • File.getDirectoryListing() および File.getDirectoryListingAsync()

  • File.moveTo() および File.moveToAsync()

  • File.moveToTrash() および File.moveToTrashAsync()

また、FileStream 操作の処理も、同期的に行われる場合と非同期で行われる場合があります。どちらで処理されるかは、FileStream オブジェクトでファイルを開く際に open() メソッドを呼び出したか openAsync() メソッドを呼び出したかによって決まります。

非同期バージョンで処理を開始すると、バックグラウンドで処理が実行され、完了時（またはエラーイベントの発生時）にイベントが送出されます。これらの非同期のバックグラウンド処理を実行している間に、他のコードを実行することができます。非同期バージョンの操作では、イベントリスナー関数を設定する必要があります。イベントリスナー関数を設定するには、その関数を呼び出す File オブジェクトまたは FileStream オブジェクトの addEventListener() メソッドを使用します。

同期バージョンでは、イベントリスナーを設定する必要がない、より単純なコードを記述できます。ただし、同期メソッドの実行中は他のコードを実行できないので、表示オブジェクトのレンダリングやアニメーションなどの重要な処理が中断されることがあります。