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 に対する空きソケット数 |
HTTPAgent オブジェクトは共有可能なため、 シングルトンクラスに追加すれば、同じサーバーへのすべてのリクエストについて同じエージェントを使用できます。
4D.HTTPAgent.new()
4D.HTTPAgent.new( { options : Object } ) : 4D.HTTPAgent
| 引数 | 型 | 説明 | |
|---|---|---|---|
| options | Object | -> | HTTPAgent のデフォルトのオプション |
| 戻り値 | 4D.HTTPAgent | <- | 新規 HTTPAgent オブジェクト |
説明
4D.HTTPAgent.new() 関数は、options 引数で定義される設定で共有可能な HTTPAgent オブジェクトを作成し、4D.HTTPAgent オブジェクトを返します。
返された HTTPAgentオブジェクト は、HTTPサーバーへの接続をカスタマイズするのに使用します。
options 引数
options に渡すオブジェクトは、次のプロパティを持つことができます (すべてのプロパティが任意です):
HTTPAgent のオプションは HTTPRequest のオプション と統合されます (HTTPRequest オプションが優先されます)。特定のエージェントが定義されていない場合、グローバルエージェントが使用されます。
| プロパティ | 型 | デフォルト | 説明 |
|---|---|---|---|
| keepAlive | Boolean | true | 当該エージェントについて keep-alive を有効にします |
| maxSockets | Integer | 65535 | サーバーあたりの最大ソケット数 |
| maxTotalSockets | Integer | 65535 | エージェントの最大ソケット数 |
| timeout | Real | undefined | 定義されている場合、未使用のソケットが閉じられるまでのタイムアウト |
| certificatesFolder | Folder | undefined (デフォルト値は HTTPRequest.new() 参照) | 当該エージェントを使ったリクエストに使用するクライアント証明書フォルダー |
| minTLSVersion | Text | undefined (デフォルト値は HTTPRequest.new() 参照) | 当該エージェントを使ったリクエストに設定する TLS の最小バージョン |
| protocol | Text | undefined (デフォルト値は HTTPRequest.new() 参照) | 当該エージェントを使ったリクエストに使用されるプロトコル |
| validateTLSCertificate | Boolean | undefined (デフォルト値は HTTPRequest.new() 参照) | 当該エージェントを使用したリクエストについて、TLS 証明書の検証をおこなうか |
同じエージェントを使って複数のサーバーにリクエストすることができます。 その場合各サーバーは、同じエージェントオプションを使用した独自の接続プールを持ちます。
例題
HTTPAgent の作成:
var $options:={}
$options.maxSockets:=5 // サーバー毎の最大ソケット数
$options.maxTotalSockets:=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 に関連付けられたエージェントがない場合、デフォルト値を持つグローバルエージェントが使用されます。
.options
options : Object
説明
.options プロパティオブジェクトは、HTTPAgent が現在使用しているオプションを格納します。
.requestsCount
requestsCount : Integer
説明
.requestsCount プロパティは、HTTPAgent によって現在管理されているリクエストの数を格納します。
.freeSocketsCount
freeSocketsCount : Integer
説明
.freeSocketsCount プロパティは、HTTPAgent に関連付けられた maxSockets に対する空きソケット数を格納します。