32.8 WsmgrHttpStreamリファレンス

HTTPを使用して、エミュレータから取得したデータを、ファイルとしてクライアントへデータ転送（ダウンロード）するためのオブジェクトです。

■WsmgrHttpStream

クライアントへデータ転送するためのオブジェクトを生成します。

●オブジェクト生成方法

new WsmgrHttpStream ([url])

●パラメータ

パラメータ	説明	省略時の初期値
url	WSMGR for Webの仮想ディレクトリのURL（絶対パス）を指定	エミュレータページからのデータ転送リクエストとして実行します

●リターン値

オブジェクトの生成に成功するとWsmgrHttpStreamオブジェクトを返します。エラーの場合は、例外をスローします。

●JavaScriptを用いて記述した例

// 2行1桁から23行60桁までを取得
var table = dspemu.screen.getTextArrays(2, 1, 23, 60); 
var httpStream = new WsmgrHttpStream();
httpStream.set(table); 
// ブラウザのダウンロードダイアログが表示されます。
httpStream.get('data.csv', 'text/plain'); 
if(httpStream.getError() == 0) {
    // 成功時の処理
} else {
    // 失敗時の処理
}

●メソッド一覧

メソッド名	機能
set	転送するデータを指定します。
get	クライアントへデータ転送を実行します。
getError	エラー番号を取得します

■set

クライアントに転送するデータを指定します。

●呼び出し形式

set(stringData)
set(listData)
set(tableData)
set(byteData)

●パラメータ

パラメータ	説明	省略時の初期値
stringData	文字列データをファイルとして転送します。データ型：文字列(string)	省略できません
listData	リストデータをファイルとして転送します。データ型：文字配列(Array)
tableData	テーブルデータをファイルとして転送します。データ型： 2次元文字配列(Array)
byteData	バイトデータをファイルとして転送します。データ型：バイト配列(Array)

●リターン値

関数呼び出しが成功するとtrueを返します。エラーの場合はfalseを返します。エラーの詳細は、getErrorメソッドにより取得できます。

●JavaScriptを用いて記述した例

WsmgrHttpStreamオブジェクトのJavaScriptを用いて記述した例を参照してください。

■get

クライアントへのデータ転送を実行します。

実行が成功すると、ブラウザよりファイルダウンロード画面が表示されます。

●呼び出し形式

get(saveFileName[, mimeType])

●パラメータ

パラメータ	説明	省略時の初期値
saveFileName	ブラウザに表示されるファイル名を指定	省略できません
mimeType	ファイルのMIMEタイプを指定文字列：'text/plain' リスト：'text/plain' テーブル：'text/plain' バイト配列： 'application/octet－stream'	'text/plain'

●リターン値

関数呼び出しが成功するとtrueを返します。エラーの場合はfalseを返します。エラーの詳細は、getErrorメソッドにより取得できます。

本メソッドはファイルダウンロードの完了を待ち合わせません。また、ダウンロードはクライアントのブラウザに依存するため、転送結果を取得することはできません。

●JavaScriptを用いて記述した例

WsmgrHttpStreamオブジェクトのJavaScriptを用いて記述した例を参照してください。

■getError

関数がエラー終了した時の最新のエラー番号を取得します。エラーが発生していない場合は、0を返します。

●呼び出し形式

getError()

●パラメータ

ありません

●リターン値

エラーが発生していない場合は0を、エラーが発生している場合はそのエラー番号を返します。
エラーの詳細を求める前に別のメソッドが実行されると、直前に失敗したメソッドが設定したエラー番号に上書きされます。
このため、各メソッドの復帰値が失敗した値で返ってきた場合は、すぐにgetErrorメソッドを用いてエラーの詳細を求めてください。

●JavaScriptを用いて記述した例

WsmgrHttpStreamオブジェクトのJavaScriptを用いて記述した例を参照してください。