NetObject.Getメソッド

説明

WEBサーバからCRSファイルをダウンロードして実行します。

URLで指定した対象のCRSファイルを、以下の順に検索します。

（１）既にローカルコンピュータにキャッシュされていれば、キャッシュから読み出します。

（２）事前にimportしたCRSアーカイブ（CARファイル）に含まれていれば、アーカイブから読み出します。

（３）WEBサーバにリクエストを送信し、CRSファイルを取得します。

取得した内容は、直ちにCRSスクリプトとして実行されます。WEBサーバから取得したCRSファイルは、可能であればキャッシュに保存します。

キャッシュの制御については、後述のHTTPヘッダによるキャッシュの制御を参照してください。

paramを指定しない場合は、リクエストはHTTPのGETで送られます。

paramを指定した場合は、リクエストはHTTPのPOSTで送られます。

WEBサーバがHTTPステータスコードに200（$HTTP_OK）を返さない場合は、CRS-331の例外が発生します。

また、HTTPレスポンスヘッダを利用して任意の例外を発生させることが可能です。

詳細はNetObject.Getを参照してください。

取得したCRSスクリプトのカレントスコープ（this）は、Getメソッドを実行したオブジェクトになります。例えば、ButtonクラスのOnTouchイベントハンドラ内でGetメソッドを実行すると、Buttonオブジェクトの子としてオブジェクトが生成されます。画面（Formクラス）を定義したCRSを取得するときは、Rootオブジェクト（//）やFormオブジェクトでGetメソッドを実行するのが一般的です。

取得したCRSスクリプトの実行が完了するまでGetメソッドは復帰しません。

Android版
Biz/Browser HT ver 1.2.6より、Android11以降の端末でアプリケーション専用ディレクトリ以外のディレクトリにあるファイルにアクセスする場合、OSに対してユーザー操作で許可をとる必要があります。
詳しくはAndroid11以降のファイルアクセスを参照してください。

呼出形式

obj.Get( URL [, param1 [, param2 [, ... ] ] ] )

戻り値

なし

引数

String URL

CRSファイルのURL

URLは以下の規則で決定します。

プロトコルから指定

http://などのプロトコルから指定すると、そのままリクエストを送信します。

URLをホスト名から始めることはできません。ホスト名を指定したい場合は必ずプロトコルから指定します。

例）

Get("http://server/path/form1.crs");
Get("https://server/path/form1.crs");

絶対パス指定

"/"で始まるURLは絶対パスとなります。Getメソッドを実行したCRSファイルをダウンロードしたサーバにリクエストを送信します。

例）Getメソッドを実行するCRSがhttp://server/path1/form1.crsからダウンロードされた場合

Get("/path2/form2.crs");
↓
Get("http://server/path2/form2.crs")

相対パス指定

"/"で始まらないURLは相対パスとなります。Getメソッドを実行したCRSファイルをダウンロードしたサーバの同じパスにリクエストを送信します。

例）Getメソッドを実行するCRSがhttp://server/path/form1.crsからダウンロードされた場合

Get("form3.crs");
↓
Get("http://server/path/form3.crs")

SYSオブジェクトのAPPROOTプロパティを使用すると、相対パス指定で上記とは異なる動作をします。APPROOTプロパティはバージョン3.0より前のバージョンとの互換性のために残されているので、新しいプログラムでは使用しないでください。

Object param

リクエストに付加するパラメータ

指定できるパラメータの数に制限はありません。

パラメータに指定するオブジェクトの種類ごとの変換規則に従い、文字列に変換されてリクエストに付加されます。

例外

CRS-331

通信エラー

Exceptionオブジェクトは以下の構造を持ちます。

Exception {
    String RequestURL;  /* 例外を起こしたリクエストのURL */
    Number StatusCode;  /* HTTPステータスコード */
    String ContentType; /* HTTPヘッダのContent-Type */
    String Body;        /* レスポンスボディ */
}

使用例

Function OnTouch(e) {
    //.Form1.Delete();
    //.Get("Form2.crs");
}

関連項目

Cache、CsvDocument.Getメソッド