API version 4

HttpSession.CreateRequestメソッド 変更履歴

iOSAndroidWindows

 

説明

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

 

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

 

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

 

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

 

呼出形式

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

 

戻り値

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

 

引数

String URL

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

 

 

integer enc

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

指定できる値は下記のとおりです。省略した場合のデフォルト値はHttpSession.DEFAULT_ENCODEです。

 

定数

説明

HttpSession.DEFAULT_ENCODE

0

Mobile互換モードの指定に従います

HttpSession.UTF8_ENCODE

1

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

 

関連項目

ProtocolServerプロパティ

GetPostメソッド

HttpRequestHttpResponseクラス

 

 

変更履歴
*1 API version 24から仕様変更されました。


「オンラインマニュアル」一覧へ戻る
「Bizの宝箱」TOPへ戻る