對象SslServer

ssl伺服器對象，可方便建立一個標準多纖程ssl伺服器

SslServer 物件是將TcpServer和SslHandler組合封裝的對象，方便快速建置伺服器，邏輯相當於：

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

創建方法：

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

繼承關係

建構函數

SslServer

SslServer 建構函數，在所有本機位址偵聽

1
2
3
new SslServer(Array certs,
    Integer port,
    Handler listener);

呼叫參數:

• certs: Array, 伺服器憑證列表
• port: Integer, 指定ssl伺服器偵聽連接埠
• listener:Handler, 指定ssl接收的內建訊息處理器，處理函數，鍊式處理數組，路由對象，詳見mq.Handler

certs 格式為：

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]
    }
]

---

SslServer 建構函數

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

呼叫參數:

• certs: Array, 伺服器憑證列表
• addr: String, 指定ssl伺服器偵聽位址，為"" 則在本機所有位址偵聽
• port: Integer, 指定ssl伺服器偵聽連接埠
• listener:Handler, 指定ssl接收到的連接的內建訊息處理器，處理函數，鍊式處理數組，路由對象，詳見mq.Handler

certs 格式為：

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]
    }
]

---

SslServer 建構函數，在所有本機位址偵聽

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

呼叫參數:

• crt:X509Cert,X509Cert證書，用於客戶端驗證伺服器
• key:PKey,PKey私鑰，用於與客戶端會話
• port: Integer, 指定ssl伺服器偵聽連接埠
• listener:Handler, 指定ssl接收的內建訊息處理器，處理函數，鍊式處理數組，路由對象，詳見mq.Handler

---

SslServer 建構函數

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

呼叫參數:

• crt:X509Cert,X509Cert證書，用於客戶端驗證伺服器
• key:PKey,PKey私鑰，用於與客戶端會話
• addr: String, 指定ssl伺服器偵聽位址，為"" 則在本機所有位址偵聽
• port: Integer, 指定ssl伺服器偵聽連接埠
• listener:Handler, 指定ssl接收到的連接的內建訊息處理器，處理函數，鍊式處理數組，路由對象，詳見mq.Handler

成員屬性

verification

Integer, 設定憑證驗證模式，預設為VERIFY_NONE

1
Integer SslServer.verification;

---

ca

X509Cert, 用戶端憑證驗證憑證鏈

1
readonly X509Cert SslServer.ca;

---

socket

Socket, 伺服器目前偵聽的Socket物件

1
readonly Socket SslServer.socket;

---

handler

Handler, 伺服器目前事件處理介面對象

1
Handler SslServer.handler;

成員函數

start

啟動目前伺服器

1
SslServer.start();

---

stop

關閉socket中止正在運作的伺服器

1
SslServer.stop() async;

---

toString

傳回物件的字串表示，一般回傳"[Native Object]"，物件可以根據自己的特性重新實現

1
String SslServer.toString();

回傳結果:

• String, 傳回物件的字串表示

---

toJSON

傳回物件的JSON 格式表示，一般傳回物件定義的可讀屬性集合

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

呼叫參數:

• key: String, 未使用

回傳結果:

• Value, 傳回包含可JSON 序列化的值