バージョン: 21

HTTPAgent

HTTPAgent クラスは、HTTPRequest クラスを使ったサーバー接続の永続性と再利用を管理するためのHTTPAgent オブジェクト を操作するためのものです。

HTTPAgent クラスは、4D クラスストアにて提供されています。 HTTPAgent オブジェクト は、4D.HTTPAgent.new() 関数で新規作成できます。

HTTPリクエストに関連付けられたエージェントがない場合、デフォルト値を持つグローバルエージェントが使用されます。デフォルトエージェントは、基本的なユースケースに適した最もシンプルな HTTPエージェントです。接続の設定 (keep-alive設定、タイムアウト、TLS/SSL設定など) について、HTTPリクエスト毎ではなくエージェントレベルで、より細かい制御をおこなうために、カスタムエージェントの使用が推奨されます。

履歴

リリース	内容
20 R6	クラスを追加

HTTPAgent オブジェクト

HTTPAgent オブジェクトは共有可能なオブジェクトです。

HTTPAgent オブジェクトは次のプロパティや関数を提供します:


options : Object HTTPAgent が現在使用しているオプション
requestsCount : Integer HTTPAgent によって現在管理されているリクエストの数
freeSocketsCount : Integer HTTPAgent に関連付けられた `maxSockets` に対する空きソケット数

tip

HTTPAgent オブジェクトは共有可能なため、シングルトンクラスに追加すれば、同じサーバーへのすべてのリクエストについて同じエージェントを使用できます。

4D.HTTPAgent.new()

4D.HTTPAgent.new( { options : Object } ) : 4D.HTTPAgent

履歴

リリース	内容
21	storeCertificateName プロパティのサポート

引数	型		説明
options	Object	->	HTTPAgent のデフォルトのオプション
戻り値	4D.HTTPAgent	<-	新規 HTTPAgent オブジェクト

説明

4D.HTTPAgent.new() 関数は、options 引数で定義される設定で共有可能な HTTPAgent オブジェクトを作成し、4D.HTTPAgent オブジェクトを返します。

返された HTTPAgentオブジェクト は、HTTPサーバーへの接続をカスタマイズするのに使用します。

`options` 引数

options に渡すオブジェクトは、次のプロパティを持つことができます (すべてのプロパティが任意です):

注

HTTPAgent のオプションは HTTPRequest のオプションと統合されます (HTTPRequest オプションが優先されます)。特定のエージェントが定義されていない場合、グローバルエージェントが使用されます。

プロパティ	型	デフォルト	説明
certificatesFolder	Folder	undefined (デフォルト値は HTTPRequest.new() 参照)	当該エージェントを使ったリクエストに使用するクライアント証明書フォルダー。 "storeCertificateName" によって上書き可能(下記参照)
keepAlive	Boolean	true	当該エージェントについて keep-alive を有効にします
maxSockets	Integer	65535	サーバーあたりの最大ソケット数
maxTotalSockets	Integer	65535	エージェントの最大ソケット数
minTLSVersion	Text	undefined (デフォルト値は HTTPRequest.new() 参照)	当該エージェントを使ったリクエストに設定する TLS の最小バージョン
protocol	Text	undefined (デフォルト値は HTTPRequest.new() 参照)	当該エージェントを使ったリクエストに使用されるプロトコル
storeCertificateName	Text	undefined	(Windows only) Name of a certificate stored in the Certificate Store to use instead of one saved in the certificates folder. If the certificate is not found, an error is returned. より詳細な情報に関しては、こちらの blog 記事を参照してください。
timeout	Real	undefined	定義されている場合、未使用のソケットが閉じられるまでのタイムアウト
validateTLSCertificate	Boolean	undefined (デフォルト値は HTTPRequest.new() 参照)	当該エージェントを使用したリクエストについて、TLS 証明書の検証をおこなうか

注

同じエージェントを使って複数のサーバーにリクエストすることができます。その場合各サーバーは、同じエージェントオプションを使用した独自の接続プールを持ちます。

例題

HTTPAgent の作成:

var $options:={}
$options.maxSockets:=5 //1サーバーあたりのソケット数の最大値を5 に設定
$options.maxTotalSockets:=10 // 1エージェントあたりのソケット数の最大値を10 に設定
$options.validateTLSCertificate:=True // サーバーの証明書を評価する

var $myAgent:=4D.HTTPAgent.new($options)

任意の都市の現地時間を確認するリクエストを送信します:

var $options:={}
$options.method:="GET"
$options.agent:=$myAgent
var $myRequest:=4D.HTTPRequest.new("http://worldtimeapi.org/api/timezone/Europe/Paris"; $options) 

注

HTTPRequest に関連付けられたエージェントがない場合、デフォルト値を持つグローバルエージェントが使用されます。

.params

options : Object

説明

.params プロパティオブジェクトは、HTTPAgent が現在使用しているオプションを格納します。

.requestsCount

requestsCount : Integer

説明

.requestsCount プロパティは、HTTPAgent によって現在管理されているリクエストの数を格納します。

.freeSocketsCount

freeSocketsCount : Integer

説明

.freeSocketsCount プロパティは、HTTPAgent に関連付けられた maxSockets に対する空きソケット数を格納します。

HTTPAgent オブジェクト​

4D.HTTPAgent.new()​

説明​

options 引数​

例題​

.params​

説明​

.requestsCount​

説明​

.freeSocketsCount​

説明​