オブジェクトHttpClient

httpクライアントオブジェクト

httpクライアントオブジェクトは、ブラウザ環境をシミュレートしてcookieをキャッシュし、 urlにアクセスするときに対応するcookieを送信します。異なるhttpクライアントオブジェクトは互いに分離され、 httpリクエスト、取得、投稿、その他のメソッドを提供します。使用方法は次のとおりです。

1
2
3
var http = require('http');
var httpClient = new http.Client();
httpClient.request('GET', 'http://fibjs.org');

継承

コンストラクタ

HttpClient

新しいHttpClientオブジェクトを作成するHttpClientコンストラクター

1
new HttpClient();

メンバーの属性

cookies

NArray、 httpクライアントのHttpCookieオブジェクトのリストを返します

1
readonly NArray HttpClient.cookies;

timeout

整数、クエリ、タイムアウト時間をミリ秒単位で設定

1
Integer HttpClient.timeout;

enableCookie

ブール、Cookie機能スイッチ、デフォルトで有効

1
Boolean HttpClient.enableCookie;

autoRedirect

ブール値、自動リダイレクト機能切り替え、デフォルトで有効

1
Boolean HttpClient.autoRedirect;

enableEncoding

ブール、自動解凍機能スイッチ、デフォルトで有効

1
Boolean HttpClient.enableEncoding;

maxBodySize

整数、クエリ、本文の最大サイズの設定（MB単位）、デフォルトは-1で、サイズに制限はありません

1
Integer HttpClient.maxBodySize;

userAgent

文字列、 httpリクエストでのブラウザIDのクエリと設定

1
String HttpClient.userAgent;

poolSize

整数、クエリ、キープアライブキャッシュ接続の最大数の設定、デフォルトは128

1
Integer HttpClient.poolSize;

poolTimeout

整数、クエリ、キープアライブキャッシュ接続タイムアウト時間の設定、デフォルトは10000ミリ秒

1
Integer HttpClient.poolTimeout;

proxyAgent

文字列、クエリ、およびプロキシサーバーの設定

1
String HttpClient.proxyAgent;

sslVerification

整数、クエリおよびhttpsに接続する際のVERIFY_ *定数を参照してください、証明書検証モードを設定sslモジュール、デフォルト値はssl.verification

1
Integer HttpClient.sslVerification;

メンバー機能

setClientCert

デフォルトのクライアント証明書を設定する

1
2
HttpClient.setClientCert(X509Cert crt,
    PKey key);

呼び出しパラメータ：

• crt ： X509Cert 、 X509Cert証明書、クライアント認証サーバーに使用
• key ： PKey 、 PKey秘密鍵、クライアントとの通信に使用されます

request

指定されたストリームオブジェクトにhttpリクエストを送信し、結果を返します

1
2
HttpResponse HttpClient.request(Stream conn,
    HttpRequest req) async;

呼び出しパラメータ：

• conn ： Stream 、リクエストを処理するストリームオブジェクトを指定します
• req ： HttpRequest 、送信されるHttpRequestオブジェクト

結果を返す：

• HttpResponse 、サーバーの応答を返します

指定されたurlをリクエストして結果を返す

1
2
3
HttpResponse HttpClient.request(String method,
    String url,
    Object opts = {}) async;

呼び出しパラメータ：

• method ：文字列、 httpリクエストメソッドを指定：GET、POSTなど
• url ：指定されたurlである文字列は、ホストを含​​む完全なurlである必要があります
• opts ：オブジェクト、追加情報を指定

結果を返す：

• HttpResponse 、サーバーの応答を返します

optsには要求された追加のオプションが含まれており、サポートされているコンテンツは次のとおりです。

1
2
3
4
5
6
{
    "query": {},
    "body": SeekedStream | Buffer | String | {},
    "json": {},
    "headers": {}
}

bodyとjsonが同時に表示されないようにする必要があります。デフォルトは、追加情報なしの{}です。

get

GETメソッドを使用して、指定したurlを要求し、結果を返します。これは、request（ "GET"、...）と同等です。

1
2
HttpResponse HttpClient.get(String url,
    Object opts = {}) async;

呼び出しパラメータ：

• url ：指定されたurlである文字列は、ホストを含​​む完全なurlである必要があります
• opts ：オブジェクト、追加情報を指定

結果を返す：

• HttpResponse 、サーバーの応答を返します

optsには要求された追加のオプションが含まれており、サポートされているコンテンツは次のとおりです。

1
2
3
4
5
6
{
    "query": {},
    "body": SeekedStream | Buffer | String | {},
    "json": {},
    "headers": {}
}

bodyとjsonが同時に表示されないようにする必要があります。デフォルトは、追加情報なしの{}です。

post

POSTメソッドを使用して、指定したurlをリクエストし、結果を返します。これは、request（ "POST"、...）と同等です。

1
2
HttpResponse HttpClient.post(String url,
    Object opts = {}) async;

呼び出しパラメータ：

• url ：指定されたurlである文字列は、ホストを含​​む完全なurlである必要があります
• opts ：オブジェクト、追加情報を指定

結果を返す：

• HttpResponse 、サーバーの応答を返します

optsには要求された追加のオプションが含まれており、サポートされているコンテンツは次のとおりです。

1
2
3
4
5
6
{
    "query": {},
    "body": SeekedStream | Buffer | String | {},
    "json": {},
    "headers": {}
}

bodyとjsonが同時に表示されないようにする必要があります。デフォルトは、追加情報なしの{}です。

del

DELETEメソッドを使用して、指定したurlをリクエストし、結果を返します。これは、request（ "DELETE"、...）と同等です。

1
2
HttpResponse HttpClient.del(String url,
    Object opts = {}) async;

呼び出しパラメータ：

• url ：指定されたurlである文字列は、ホストを含​​む完全なurlである必要があります
• opts ：オブジェクト、追加情報を指定

結果を返す：

• HttpResponse 、サーバーの応答を返します

optsには要求された追加のオプションが含まれており、サポートされているコンテンツは次のとおりです。

1
2
3
4
5
6
{
    "query": {},
    "body": SeekedStream | Buffer | String | {},
    "json": {},
    "headers": {}
}

bodyとjsonが同時に表示されないようにする必要があります。デフォルトは、追加情報なしの{}です。

put

PUTメソッドを使用して、指定されたurlを要求し、結果を返します。これは、request（ "PUT"、...）と同等です。

1
2
HttpResponse HttpClient.put(String url,
    Object opts = {}) async;

呼び出しパラメータ：

• url ：文字列、指定されたurlは、ホストを含​​む完全なurlである必要があります
• opts ：オブジェクト、追加情報を指定

結果を返す：

• HttpResponse 、サーバーの応答を返します

optsには要求された追加のオプションが含まれており、サポートされているコンテンツは次のとおりです。

1
2
3
4
5
6
{
    "query": {},
    "body": SeekedStream | Buffer | String | {},
    "json": {},
    "headers": {}
}

bodyとjsonが同時に表示されないようにする必要があります。デフォルトは、追加情報なしの{}です。

patch

PATCHメソッドを使用して、指定されたurlを要求し、結果を返します。これは、request（ "PATCH"、...）と同等です。

1
2
HttpResponse HttpClient.patch(String url,
    Object opts = {}) async;

呼び出しパラメータ：

• url ：指定されたurlである文字列は、ホストを含​​む完全なurlである必要があります
• opts ：オブジェクト、追加情報を指定

結果を返す：

• HttpResponse 、サーバーの応答を返します

optsには要求された追加のオプションが含まれており、サポートされているコンテンツは次のとおりです。

1
2
3
4
5
6
{
    "query": {},
    "body": SeekedStream | Buffer | String | {},
    "json": {},
    "headers": {}
}

bodyとjsonが同時に表示されないようにする必要があります。デフォルトは、追加情報なしの{}です。

toString

オブジェクトの文字列表現を返します。通常は「[Native Object]」を返します。オブジェクトは、独自の特性に従って再実装できます

1
String HttpClient.toString();

結果を返す：

• String 、オブジェクトの文字列表現を返します

toJSON

オブジェクトのJSON形式表現を返します。通常、オブジェクトによって定義された読み取り可能な属性のコレクションを返します

1
Value HttpClient.toJSON(String key = "");

呼び出しパラメータ：

• key ：文字列、未使用

結果を返す：

• Value 、シリアル化可能なJSONを含む値を返します