オブジェクト組み込みオブジェクト

オブジェクトSslSocket

ssl ネットワークソケットオブジェクト

SslSocket が属する ssl モジュール、作成方法

1
var s = new ssl.Socket();

継承

#lineWidth: 1.5 #font: Helvetica,sans-Serif #fontSize: 10 #leading: 1.6 #.this: fill=lightgray #.class: fill=white [<class>object|toString();toJSON()] [<class>Stream|fd|read();write();flush();close();copyTo()] [<this>SslSocket|new SslSocket()|verification;ca;peerCert;hostname;stream|connect();accept()] [object] <:- [Stream] [Stream] <:- [SslSocket] SslSocket new SslSocket() verification ca peerCert hostname stream connect() accept() Stream fd read() write() flush() close() copyTo() object toString() toJSON()

コンストラクタ

SslSocket

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

1
new SslSocket(Array certs = []);

呼び出しパラメータ:

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

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

1 2
new SslSocket(X509Cert crt, PKey key);

呼び出しパラメータ:

  • crt: X509CertX509Cert クライアント認証サーバー用証明書
  • key: PKeyPKey クライアントとの通信に使用される秘密鍵

メンバーの属性

verification

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

1
Integer SslSocket.verification;

ca

X509Cert、証明書チェーン、クライアント モードで接続すると自動的に引用されます ssl.ca、サーバーモードは SslSocket を生成し、現在の SslSocket ca を自動的に参照します。

1
readonly X509Cert SslSocket.ca;

peerCert

X509Cert、相手の証明書に接続する

1
readonly X509Cert SslSocket.peerCert;

hostname

文字列、接続のホスト名

1
readonly String SslSocket.hostname;

stream

Stream、クエリ メッセージ ssl 設立当時の下流対象

1
readonly Stream SslSocket.stream;

fd

整数、クエリ Stream サブクラスによって実装される、対応するファイル記述子の値

1
readonly Integer SslSocket.fd;

メンバー関数

connect

指定された接続で接続します ssl 接続、クライアントモード

1 2
Integer SslSocket.connect(Stream s, String server_name = "") async;

呼び出しパラメータ:

  • s: Stream、指定された基になる接続
  • server_name: 文字列、サーバー名を指定します。デフォルトにすることができます

結果を返す:

  • Integer、接続に成功した場合は 0 を返します。証明書がオプションの場合、検証に失敗した場合は 0 以外を返します。詳細については、を参照してください。 ssl モジュール

accept

指定された接続で 1 つを受け取ります ssl 新しい SslSocket を接続して生成する

1
SslSocket SslSocket.accept(Stream s) async;

呼び出しパラメータ:

  • s: Stream、指定された基になる接続

結果を返す:

  • SslSocket、新しく作成された SslSocket オブジェクトを返す

read

ストリームから指定サイズのデータ​​を読み込む

1
Buffer SslSocket.read(Integer bytes = -1) async;

呼び出しパラメータ:

  • bytes: 整数、読み取るデータの量を指定します。デフォルトでは、ランダムなサイズのデータ​​ ブロックが読み取られます。読み取られるデータのサイズは、デバイスによって異なります

結果を返す:

  • Buffer、ストリームから読み取ったデータを返します。読み取るデータがない場合、または接続が中断された場合は null を返します。

write

指定されたデータをストリームに書き込みます

1
SslSocket.write(Buffer data) async;

呼び出しパラメータ:

  • data: Buffer、書き込むデータが与えられると

flush

ファイル バッファーの内容を物理デバイスに書き込みます。

1
SslSocket.flush() async;

close

現在のストリーム オブジェクトを閉じる

1
SslSocket.close() async;

copyTo

ストリーム データをターゲット ストリームにコピーする

1 2
Long SslSocket.copyTo(Stream stm, Long bytes = -1) async;

呼び出しパラメータ:

  • stm: Stream、対象のストリームオブジェクト
  • bytes: Long、コピーされたバイト数

結果を返す:

  • Long、コピーされたバイト数を返します

toString

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

1
String SslSocket.toString();

結果を返す:

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

toJSON

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

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

呼び出しパラメータ:

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

結果を返す:

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