Module.downloadオブジェクト
コンポーネント情報 |
---|
データのダウンロード機能を提供するオブジェクト。
ファイルダウンロード・モジュールは、サーバーからクライアントに対してファイルを送信するための機能です。
ダウンロードには、HTTP プロトコルを利用します。
ファイル拡張子とMIMEタイプ
サロゲートペア文字について
Internet Explorerを利用している場合、 ダウンロード時のファイル名にサロゲートペア文字(=JIS2004で追加された文字) が含まれると文字化けが発生する場合があります。 (この現象は、Internet Explorerを利用している場合にのみ発生します。)
注意事項
ファイルダウンロード・モジュールは、サーバーからクライアントに対してファイルを送信するための機能です。
ダウンロードには、HTTP プロトコルを利用します。
ファイル拡張子とMIMEタイプ
ダウンロード時には、ファイルの拡張子によって自動的にMIMEタイプが決定されます。
ファイル拡張子とMIMEの関係は、以下の表を参考にして下さい。
application/pdf .gif image/gif .html
.htmtext/html .jar application/java-archive .js application/x-javascript .jpeg
.jpgimage/jpeg .png image/png .xls application/vnd.ms-excel .ppt application/vnd.ms-powerpoint .mp2 audio/x-mpeg .mpeg
.mpgvideo/mpeg .txt
.texttext/plain .doc application/msword
上記表でMIMEタイプを決定できない場合は、application/octet-stream が適応されます。
また、ダウンロードAPIへの引数の与え方により、ダウンロードAPIを利用するプログラム側で任意にMIMEタイプを指定することもできます。
サロゲートペア文字について
Internet Explorerを利用している場合、 ダウンロード時のファイル名にサロゲートペア文字(=JIS2004で追加された文字) が含まれると文字化けが発生する場合があります。 (この現象は、Internet Explorerを利用している場合にのみ発生します。)
注意事項
ファイルダウンロード・モジュールは、ブラウザへデータを送信するための機能です。
ダウンロードAPIは、クライアントへのデータの送信時に文字コード変換を行いません。クライアントが受信する文字コード形式への適切な変換は、ダウンロードAPIへデータを渡す前に、ダウンロードAPIを利用するプログラム側で行うようにしてください。
メソッドの概要
返却値の型 | メソッド名 |
---|---|
void | send (String stream , String name , String mime ) static現在実行中のプログラムを中断して、指定データを送信します。 (ブラウザ側では、指定されたデータのダウンロードになります。) |
void | send (String stream , String name ) static現在実行中のプログラムを中断して、指定データを送信します。 (ブラウザ側では、指定されたデータのダウンロードになります。) |
void | send (String stream ) static現在実行中のプログラムを中断して、指定データを送信します。 (ブラウザ側では、指定されたデータのダウンロードになります。) |
void | send (File file , String name , String mime ) static現在実行中のプログラムを中断して、指定ファイルを送信します。 (ブラウザ側では、指定されたファイルのダウンロードになります。) |
void | send (File file , String name ) static現在実行中のプログラムを中断して、指定ファイルを送信します。 (ブラウザ側では、指定されたファイルのダウンロードになります。) |
void | send (File file ) static現在実行中のプログラムを中断して、指定ファイルを送信します。 (ブラウザ側では、指定されたファイルのダウンロードになります。) |
void | send (Storage storage , String name , String mime ) static現在実行中のプログラムを中断して、指定ファイルを送信します。 (ブラウザ側では、指定されたファイルのダウンロードになります。) |
void | send (Storage storage , String name ) static現在実行中のプログラムを中断して、指定ファイルを送信します。 (ブラウザ側では、指定されたファイルのダウンロードになります。) |
void | send (Storage storage ) static現在実行中のプログラムを中断して、指定ファイルを送信します。 (ブラウザ側では、指定されたファイルのダウンロードになります。) |
メソッドの詳細
void send (String stream , String name , String mime )
static
現在実行中のプログラムを中断して、指定データを送信します。 (ブラウザ側では、指定されたデータのダウンロードになります。)
送信データはバイナリとして扱われます。テキストデータを送信する場合には、 このAPIをコールする前に送信する対象となるテキストデータのローカル文字コード体系への明示的な変換をしておく必要があります。 引数 name に対して文字列を指定すると、ブラウザでデータをダウンロードした際のファイル名となります。 引数 mime に対して任意の MIME 形式を指定可能です。
パラメータ
返却値
|
void send (String stream , String name )
static
現在実行中のプログラムを中断して、指定データを送信します。 (ブラウザ側では、指定されたデータのダウンロードになります。)
送信データはバイナリとして扱われます。テキストデータを送信する場合には、 このAPIをコールする前に送信する対象となるテキストデータのローカル文字コード体系への明示的な変換をしておく必要があります。 ファイル名の拡張子によって自動的にMIMEタイプが決定されます。 (MIMEタイプを特定できなかった場合には application/octet-stream になります) ファイル名の拡張子とMIMEタイプの関係はこちらを参照してください。
パラメータ
返却値
|
void send (String stream )
static
現在実行中のプログラムを中断して、指定データを送信します。 (ブラウザ側では、指定されたデータのダウンロードになります。)
送信データはバイナリとして扱われます。テキストデータを送信する場合には、 このAPIをコールする前に送信する対象となるテキストデータのローカル文字コード体系への明示的な変換をしておく必要があります。 ダウンロード時のファイル名は、適当なファイル名になります。(ブラウザの動作に依存します。) MIMEタイプは、application/octet-stream が設定されます。
パラメータ
返却値
|
void send (File file , String name , String mime )
static
現在実行中のプログラムを中断して、指定ファイルを送信します。 (ブラウザ側では、指定されたファイルのダウンロードになります。)
引数 name に対して文字列を指定すると、ブラウザでファイルをダウンロードした際のファイル名となります。 引数 mime に対して任意の MIME 形式を指定可能です。
返却値
|
void send (File file , String name )
static
現在実行中のプログラムを中断して、指定ファイルを送信します。 (ブラウザ側では、指定されたファイルのダウンロードになります。)
引数 name に対して文字列を指定すると、ブラウザでファイルをダウンロードした際のファイル名となります。 ファイル名の拡張子によって自動的にMIMEタイプが決定されます。 (MIMEタイプを特定できなかった場合には application/octet-stream になります) ファイル名の拡張子とMIMEタイプの関係はこちらを参照してください。
パラメータ
返却値
|
void send (File file )
static
現在実行中のプログラムを中断して、指定ファイルを送信します。 (ブラウザ側では、指定されたファイルのダウンロードになります。)
ダウンロード時のファイル名は、引数「file」が示すファイルの名称になります。 ファイル名の拡張子によって自動的にMIMEタイプが決定されます。 (MIMEタイプを特定できなかった場合には application/octet-stream になります) ファイル名の拡張子とMIMEタイプの関係はこちらを参照してください。
パラメータ
返却値
|
void send (Storage storage , String name , String mime )
static
現在実行中のプログラムを中断して、指定ファイルを送信します。 (ブラウザ側では、指定されたファイルのダウンロードになります。)
引数 name に対して文字列を指定すると、ブラウザでファイルをダウンロードした際のファイル名となります。 引数 mime に対して任意の MIME 形式を指定可能です。
パラメータ
返却値
|
void send (Storage storage , String name )
static
現在実行中のプログラムを中断して、指定ファイルを送信します。 (ブラウザ側では、指定されたファイルのダウンロードになります。)
引数 name に対して文字列を指定すると、ブラウザでファイルをダウンロードした際のファイル名となります。 ファイル名の拡張子によって自動的にMIMEタイプが決定されます。 (MIMEタイプを特定できなかった場合には application/octet-stream になります) ファイル名の拡張子とMIMEタイプの関係はこちらを参照してください。
パラメータ
返却値
|
void send (Storage storage )
static
現在実行中のプログラムを中断して、指定ファイルを送信します。 (ブラウザ側では、指定されたファイルのダウンロードになります。)
ダウンロード時のファイル名は、引数「file」が示すファイルの名称になります。 ファイル名の拡張子によって自動的にMIMEタイプが決定されます。 (MIMEタイプを特定できなかった場合には application/octet-stream になります) ファイル名の拡張子とMIMEタイプの関係はこちらを参照してください。
パラメータ
返却値
|