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;
                   }
           }
   }

}