对象 SslHandler

ssl 协议转换处理器

用以将数据流转换为 ssl 流协议。SslHandler 是对 SslSocket 的封装，用于构建服务器，逻辑上相当于：

1
2
3
4
5
6
7
var ss = new ssl.Socket(crt, key);

function(s) {
    var s1 = ss.accept(s);
    hdlr.invoke(s1);
    s1.close();
}

继承关系

构造函数

SslHandler

SslHandler 构造函数，创建一个新的 SslHandler 对象

1
2
new SslHandler(Array certs,
    Handler hdlr);

调用参数:

• certs: Array, 服务器证书列表
• hdlr: Handler, 内置消息处理器，处理函数，链式处理数组，路由对象，详见 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]
    }
]

---

SslHandler 构造函数，创建一个新的 SslHandler 对象

1
2
3
new SslHandler(X509Cert crt,
    PKey key,
    Handler hdlr);

调用参数:

• crt: X509Cert, X509Cert 证书，用于客户端验证服务器
• key: PKey, PKey 私钥，用于与客户端会话
• hdlr: Handler, 内置消息处理器，处理函数，链式处理数组，路由对象，详见 mq.Handler

成员属性

verification

Integer, 设定证书验证模式，缺省为 VERIFY_NONE

1
Integer SslHandler.verification;

---

ca

X509Cert, 客户端证书验证证书链

1
readonly X509Cert SslHandler.ca;

---

handler

Handler, ssl 协议转换处理器当前事件处理接口对象

1
Handler SslHandler.handler;

成员函数

invoke

处理一个消息或对象

1
Handler SslHandler.invoke(object v) async;

调用参数:

• v: object, 指定处理的消息或对象

返回结果:

• Handler, 返回下一步的处理器

---

toString

返回对象的字符串表示，一般返回 "[Native Object]"，对象可以根据自己的特性重新实现

1
String SslHandler.toString();

返回结果:

• String, 返回对象的字符串表示

---

toJSON

返回对象的 JSON 格式表示，一般返回对象定义的可读属性集合

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

调用参数:

• key: String, 未使用

返回结果:

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