1. 概要
これまで、ブラウザベースのアプリケーションにとって、ローカル ファイルへのアクセスは頭痛の種でした。 Web 2.0 アプリケーション テクノロジの継続的な開発に伴い、JavaScript が果たす役割はますます重要になっていますが、セキュリティ上の考慮事項により、JavaScript は常にローカル ファイルにアクセスできませんでした。したがって、ローカル ファイルのドラッグやアップロードなどの機能をブラウザに実装するには、特定のブラウザが提供するさまざまなテクノロジに頼る必要があります。たとえば、IE の場合は、ActiveX コントロールを使用してローカル ファイルにアクセスする必要があり、Firefox の場合は、プラグイン開発も使用する必要があります。ブラウザごとに技術的な実装が異なるため、プログラムで複数のブラウザをサポートするには、プログラムが非常に複雑になり、保守が困難になります。しかし今、File API の出現により、この状況は完全に変わりました。
ファイル API は、Mozilla が W3C に提出したドラフトで、標準 JavaScript API のセットを開始することを目的としており、その基本的な機能は JavaScript でローカル ファイルを操作することです。セキュリティ上の理由から、この API はローカル ファイルへの限定的なアクセスのみを提供します。これを使用すると、純粋な JavaScript を使用して、ローカル ファイルの読み取りとアップロードを簡単に行うことができます。現在、FireFox 3.6 は、この機能をサポートする最初のブラウザです。さらに、Google Chrome および Safari ブラウザの最新バージョンも対応するサポートを提供します。 File API は、W3C が現在開発中の将来の HTML 5 仕様の一部となる予定です。
2. ファイル API の概要
File API は、一連の JavaScript オブジェクトとイベントで構成されます。開発者は、 ファイル選択コントロールで選択されたファイルを操作できるようになります。図 1 は、File API 内のすべての JavaScript の組み合わせ関係を示しています。
タイプ FileList には、一連の File オブジェクトが含まれています。通常、FileList オブジェクトはフォームのファイル フィールド () から取得できます。 Blob オブジェクトは、ブラウザーが読み取ることができる生のバイナリ ストリームのセットを表します。 Blob オブジェクトでは、size 属性はストリームのサイズを表します。関数slice()は、長いBlobオブジェクトを小さな部分に分割できます。 File オブジェクトは Blob オブジェクトを継承し、ファイル関連のプロパティが Blob オブジェクトに追加されます。このうち、属性名はファイルの名前を表し、ファイルのパス情報を削除し、ファイル名のみを保持します。 type 属性はファイルの MIME タイプを表します。属性 urn は、このファイルの URN 情報を表します。ファイル読み取り操作を完了するには、FileReader オブジェクト インスタンスが File オブジェクトまたは BLOB オブジェクトに関連付けられ、3 つの異なるファイル読み取り関数と 6 つのイベントが提供されます。
ファイル読み取り関数の具体的な内容:
readAsBinaryString() ファイルの内容を読み取ります。読み取り結果はバイナリ文字列です。ファイルの各バイトは、[0..255] の範囲の整数として表されます。この関数は、パラメータとして File オブジェクトを受け取ります。
readAsText() ファイルの内容を読み取ります。読み取り結果は、ファイルの内容を表すテキストの文字列です。この関数は、File オブジェクトとテキスト エンコーディングの名前をパラメータとして受け取ります。
readAsDataURL ファイルの内容を読み取ります。読み取り結果は data: URL です。 DataURL は RFC2397 で定義されています。
ファイル読み取りイベントの具体的な内容:
イベント名 イベントの説明
Onloadstart ファイルの読み取りが開始されるときにトリガーされます。
Progress 読み取りの進行中に定期的にトリガーされます。イベントパラメータには、読み取られたデータの総量が含まれます。
Abort 読み取りが中止されるときに発生します。
Error 読み取りエラーが発生するとトリガーされます。
Load 読み取りが正常に完了するとトリガーされます。
Loadend 成功または失敗に関係なく、読み取りが完了するとトリガーされます。
3. ファイル API の簡単な例
次に、簡単な例を使用して、File API の基本的な使用法を示します。この例には 2 つのコード ファイルが含まれており、index.html には Web 側の HTML コードが含まれ、upload.jsp にはアップロードされたファイルを受信するためのサーバー側のコードが含まれています。添付ファイルのsourcecode.zipを参照してください。この例では、ファイル選択フィールドのある従来のフォームを表示します。ユーザーがファイルを選択して「送信」をクリックすると、File API を使用してファイルのコンテンツを読み取り、Ajax を使用して XMLHttpRequest オブジェクトを通じてファイルをサーバーにアップロードします。図 2 は、動作中のデモのスクリーンショットを示しています。
コードをステップバイステップで示します。リスト 1 は、コードの HTML 部分を示しています。
リスト 1 のサンプル コードの HTML 部分
<body> <h1>File API Demo</h1> <p> <!-- 用于文件上传的表单元素 --> <form name="demoForm" id="demoForm" method="post" enctype="multipart/form-data" action="javascript: uploadAndSubmit();"> <p>Upload File: <input type="file" name="file" /></p> <p><input type="submit" value="Submit" /></p> </form> <div>Progessing (in Bytes): <span id="bytesRead"> </span> / <span id="bytesTotal"></span> </div> </p> </body>
ご覧のとおり、通常の