オブジェクト HttpsServer

https サーバー オブジェクト

https サーバー オブジェクトは SslServer と HttpHandler カプセル化されたオブジェクトを組み合わせると、サーバーをすばやく構築するのに便利です。これは、論理的に次のものと同等です。

1
2
3
var svr = new net.SslServer(crt, key, addr, port, new http.Handler(function(req) {
    ...
}));

作成方法:

1
2
3
4
var http = require("http");
var svr = new http.HttpsServer(crt, key, 443, function(req) {
    ...
});

継承

コンストラクタ

HttpsServer

すべてのローカル アドレスでリッスンする HttpsServer コンストラクター

1
2
3
new HttpsServer(Array certs,
    Integer port,
    Handler hdlr);

呼び出しパラメータ:

• certs: 配列、サーバー証明書リスト
• port: 整数、指定 http サーバーリスニングポート
• hdlr: Handler、 http 組み込みのメッセージプロセッサ、処理関数、チェーン処理配列、ルーティングオブジェクト、詳細を参照

証明書の形式は次のとおりです。

1
2
3
4
5
6
7
8
9
10
11
[{
        name: "fibjs.org",
        crt: [X509Cert object],
        key: [PKey object]
    },
    {
        name: "*.fibjs.org",
        crt: [X509Cert object],
        key: [PKey object]
    }
]

---

HttpsServer コンストラクター

1
2
3
4
new HttpsServer(Array certs,
    String addr,
    Integer port,
    Handler hdlr);

呼び出しパラメータ:

• certs: 配列、サーバー証明書リスト
• addr: 文字列、指定 http サーバー リスニング アドレス、「」は、このマシンのすべてのアドレスをリッスンすることを意味します
• port: 整数、指定 http サーバーリスニングポート
• hdlr: Handler、 http 組み込みのメッセージプロセッサ、処理関数、チェーン処理配列、ルーティングオブジェクト、詳細を参照

証明書の形式は次のとおりです。

1
2
3
4
5
6
7
8
9
10
11
[{
        name: "fibjs.org",
        crt: [X509Cert object],
        key: [PKey object]
    },
    {
        name: "*.fibjs.org",
        crt: [X509Cert object],
        key: [PKey object]
    }
]

---

すべてのローカル アドレスでリッスンする HttpsServer コンストラクター

1
2
3
4
new HttpsServer(X509Cert crt,
    PKey key,
    Integer port,
    Handler hdlr);

呼び出しパラメータ:

• crt: X509Cert、 X509Cert クライアント認証サーバー用証明書
• key: PKey、 PKey クライアントとの通信に使用される秘密鍵
• port: 整数、指定 http サーバーリスニングポート
• hdlr: Handler、 http 組み込みのメッセージプロセッサ、処理関数、チェーン処理配列、ルーティングオブジェクト、詳細を参照

---

HttpsServer コンストラクター

1
2
3
4
5
new HttpsServer(X509Cert crt,
    PKey key,
    String addr,
    Integer port,
    Handler hdlr);

呼び出しパラメータ:

• crt: X509Cert、 X509Cert クライアント認証サーバー用証明書
• key: PKey、 PKey クライアントとの通信に使用される秘密鍵
• addr: 文字列、指定 http サーバー リスニング アドレス、「」は、このマシンのすべてのアドレスをリッスンすることを意味します
• port: 整数、指定 http サーバーリスニングポート
• hdlr: Handler、 http 組み込みのメッセージプロセッサ、処理関数、チェーン処理配列、ルーティングオブジェクト、詳細を参照

メンバーの属性

verification

整数、証明書検証モードを設定します。デフォルトは VERIFY_NONE です

1
Integer HttpsServer.verification;

---

ca

X509Cert、クライアント証明書検証CA

1
readonly X509Cert HttpsServer.ca;

---

maxHeadersCount

整数、クエリ、およびリクエスト ヘッダーの最大数を設定します。デフォルトは 128 です

1
Integer HttpsServer.maxHeadersCount;

---

maxBodySize

整数、クエリ、および本文の最大サイズを MB 単位で設定します。デフォルトは 64 です。

1
Integer HttpsServer.maxBodySize;

---

serverName

文字列、クエリ、サーバー名の設定、デフォルトは fibjs/0.x.0

1
String HttpsServer.serverName;

---

socket

Socket、サーバーは現在リッスンしています Socket オブジェクト

1
readonly Socket HttpsServer.socket;

---

handler

Handler、サーバーの現在のイベント処理インターフェース オブジェクト

1
Handler HttpsServer.handler;

メンバー関数

enableCrossOrigin

クロスドメイン リクエストを許可する

1
HttpsServer.enableCrossOrigin(String allowHeaders = "Content-Type");

呼び出しパラメータ:

• allowHeaders: 文字列、受け入れるように指定 http ヘッダーフィールド

---

start

現在のサーバーを起動します

1
HttpsServer.start();

---

stop

ソケットを閉じて実行中のサーバーを終了します

1
HttpsServer.stop() async;

---

toString

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

1
String HttpsServer.toString();

結果を返す:

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

---

toJSON

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

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

呼び出しパラメータ:

• key: ストリング、未使用

結果を返す:

• Value、シリアライズ可能なJSONを含む値を返します