説明

現在の接続を利用する新しいリクエストを作成します。作成したリクエストは、FORMパラメータなどのプロパティ設定を行った後、PostまたはGetメソッドによりサーバへ送信します。

HttpRequestオブジェクトは１回だけ通信を行うことができます。複数の通信を行う場合、それぞれCreateRequestメソッドにより別々のHttpRequestオブジェクトを作成してください。

HttpSessionオブジェクトとHttpRequestオブジェクトは密接に関連しています。HttpReuqestオブジェクトを作成したときのHttpSessionオブジェクト以外でGet、Postを行うことはできません。

FORMパラメータが不要な場合、CreateRequestメソッドは使用せず、GetメソッドにURLを直接記述する形式を利用した方が効率的です。

呼出形式

var req = session.CreateRequest( URL, [ enc ] )

戻り値

HttpRequestオブジェクトのリファレンスを返します。

引数

String URL

要求するURL。"/" から始まる絶対アドレスを指定します。プロトコルやサーバ、ポートも含めることができますが、Serverプロパティ、Protocolプロパティと一致している必要があります。

integer enc

POST要求を送信するときの、POSTパラメータのエンコード方法を指定します。

HttpSession.utf8_encodeを指定すると、utf-8でエンコードされます。省略時は、プラットホームの言語に応じたマルチバイト文字コード（日本語環境ではShift_JIS）となります。

より追加されました

では引数によらずutf-8でエンコードされます

例外

HTTP-1

リクエストを生成できません

HTTP-2

URLは接続先と異なるサーバです

使用例

var session = findHTTPSession("http://biz-browser.jp");

var req = session.CreateRequest("/test/prog1");

req.AddParam("code", "0452");

req.AddParam("name", "Biz");

var res = session.Post(req);

関連項目

Protocol、Serverプロパティ

Get、Postメソッド

HttpRequest、HttpResponseクラス