API version 4
- ‐
get¶
PSSファイルのダウンロードを行います。
指定したURLの末尾に自動的に"00000001.pss", "00000002.pss", "00000003.pss"…を付加し、最終ブロックをダウンロードできるまで順次ダウンロードを繰り返します。
URLにクエリ指定を含まない場合、かつ末尾が"/"でない場合は自動的に"/"を付加します。
ファイルとしてリクエストする場合
PrintStreamDocument psd;
psd.get("http://printserver/psddata");
↓
http://printserver/psddata/00000001.pss
http://printserver/psddata/00000002.pss
http://printserver/psddata/00000003.pss
:
に展開
URLのパラメータとしてリクエストする場合
var requestId = "202121010010";
PrintStreamDocument psd;
psd.get("http://printserver/print?id=" + requestId + "&file=");
↓
http://printserver/print?id=202121010010&file=00000001.pss
http://printserver/print?id=202121010010&file=00000002.pss
http://printserver/print?id=202121010010&file=00000003.pss
:
に展開
ダウンロードに失敗した場合は、一定時間待ってから再度ダウンロードに挑戦します。
waitScaleを指定することで、ダウンロードの失敗が続く場合には待ち時間を増やすことができます。
retryCount=3、waitTime=4、waitScale=2の場合
最初のダウンロードで失敗
↓(4秒後)
1回目のダウンロードリトライ、失敗
↓(8秒後)
2回目のダウンロードリトライ、失敗
↓(16秒後)
3回目のダウンロードリトライ、失敗
↓
retryCount回目のリトライ失敗により、ダウンロード処理終了。statsu=STATUS_FAILEDに
呼出形式一覧
呼出形式 |
説明 |
---|---|
void get(string url[, integer retryCount[, number waitTime[, number waitScale]]]) |
URLを展開しながら連続してPSSファイルのダウンロードを行います。 |
戻り値一覧
戻り値 |
説明 |
---|---|
void |
戻り値はありません。 |
引数一覧
引数 |
説明 |
---|---|
url |
ダウンロード対象の基点URL。 |
retryCount |
ファイルダウンロード失敗時の、最大リトライ回数。省略時は5です。 |
waitTime |
ファイルダウンロード失敗時の、次回ダウンロードまでの待ち時間(秒)。省略時は5.0秒です。 |
waitScale |
ダウンロード失敗が続く場合の、待ち時間の増加係数。省略時は1.0倍です。 |
例外
識別子 |
説明 |
---|---|
SYS-23:5 |
メソッドの引数が不正です |
関連項目
PrintableDocument.load メソッド、
PrintableDocument.status プロパティ
使用例
CRSダウンロード
ダウンロード(00000001.pss)
ダウンロード(00000002.pss)
Form formPrintableDocument {
x = 0; y = 0; width = 800; height = 600;
PrintStreamDocument pssDoc {
function onExtractInfo(e) {
print("PrintStreamDocument.onExtractInfo, status=", status);
print("paperSize=", paperSize);
print("orientation=", orientation);
print("width=", width);
print("height=", height);
print("marginLeft=", marginLeft);
print("marginTop=", marginTop);
print("pageCount=", pageCount);
}
function onExtractPage(e) {
print("PrintStreamDocument.onExtractPage page=", e.page, ", status=", status);
print("pageCount=", pageCount);
}
function onExtractFinished(e) {
print("PrintStreamDocument.onExtractFinished, status=", status);
print("pageCount=", pageCount);
}
function onExtractFailed(e) {
print("PrintStreamDocument.onExtractFailed, status=", status);
}
}
PrintPreview preview {
x = 8; y = 40; width = 784; height = 552;
}
TextBox textUrl {
x = 8; y = 8; width = 448; height = 24;
value = "./";
}
Button buttonGet {
x = 464; y = 8; width = 160; height = 24;
title = "PrintStreamDocument.get";
function onTouch(e) {
^.preview.clearPages();
^.preview.document = ^.pssDoc;
var retryCount = 3;
var waitTime = 4.0;
var waitScale = 2.0;
^.pssDoc.get(^.textUrl.value, retryCount, waitTime, waitScale);
}
}
Button buttonLoad {
x = 632; y = 8; width = 160; height = 24;
title = "PrintableDocument.load";
function onTouch(e) {
var doc = PrintableDocument.load(^.textbox2.value);
if (doc) {
^.preview.clearPages();
^.preview.document = doc;
}
}
}
}