结构体 UnbufferedConnectionCommon 

pub struct UnbufferedConnectionCommon<Data> { /* private fields */ }

Interface shared by unbuffered client 并 server connections.

实现

impl UnbufferedConnectionCommon<ClientConnectionData>

pub fn process_tls_records<'c, 'i>( &'c mut self, incoming_tls: &'i mut [u8], ) -> UnbufferedStatus<'c, 'i, ClientConnectionData>

Processes TLS 记录 in incoming_tls 缓冲区 until 新 UnbufferedStatus is reached.

impl UnbufferedConnectionCommon<ServerConnectionData>

pub fn process_tls_records<'c, 'i>( &'c mut self, incoming_tls: &'i mut [u8], ) -> UnbufferedStatus<'c, 'i, ServerConnectionData>

Processes TLS 记录 in incoming_tls 缓冲区 until 新 UnbufferedStatus is reached.

impl<Data> UnbufferedConnectionCommon<Data>

pub fn dangerous_extract_secrets(self) -> Result<ExtractedSecrets, Error>

提取密钥，以便在配置 kTLS 时使用，例如。 Should be 用 with care as it exposes secret 密钥材料。

Methods from Deref<Target = CommonState>

pub fn wants_write(&self) -> bool

如果调用者应尽快调用以下方法，则返回 true： Connection::write_tls 尽快。

pub fn is_handshaking(&self) -> bool

如果连接当前正在执行 TLS 握手，则返回 true。

During this time 明文 written 到 the connection is buffered in memory. After Connection::process_new_packets() has been called, this might start 到 return false while the final handshake packets still need 到 be extracted 从 the connection’s buffers.

pub fn peer_certificates(&self) -> Option<&[CertificateDer<'static>]>

检索对等方用于身份验证的证书链或原始公钥。

此 order of 证书 chain is as it appears in the TLS protocol: the first certificate relates 到 the peer, the second certifies the first, the third certifies the second, 并 so on.

When using raw public keys, the first 并 only element 是 raw 公钥.

This is made available 用于 both full 并 resumed handshakes.

For clients, this 是 certificate chain 或 the raw 公钥 of the server.

For servers, this 是 certificate chain 或 the raw 公钥 of the client, if client authentication was completed.

此 return value is None until this value is available.

Note: the return type of the ‘certificate’, when using raw public keys is CertificateDer<'static> even though this should technically be 一个 SubjectPublicKeyInfoDer<'static>。 This choice simplifies the API 并 ensures backwards compatibility.

pub fn alpn_protocol(&self) -> Option<&[u8]>

检索通过 ALPN 与对等方协商的协议。

A return value of None after handshake completion means no protocol was agreed (because no protocols were offered 或 已接受 by the peer)。

pub fn negotiated_cipher_suite(&self) -> Option<SupportedCipherSuite>

检索与对等方协商的密码套件。

在密码套件协商一致之前返回 None。

pub fn negotiated_key_exchange_group( &self, ) -> Option<&'static dyn SupportedKxGroup>

检索与对等方协商的密钥交换组。

This function may return None depending on the state of the connection, the type of handshake, 并 the protocol version.

If CommonState::is_handshaking() 为 true，此函数将返回 None。 Similarly, if the CommonState::handshake_kind() is HandshakeKind::Resumed 并 the CommonState::protocol_version() is TLS 1.2, then no key exchange will have occurred 并 此函数将返回 None。

pub fn protocol_version(&self) -> Option<ProtocolVersion>

检索与对等方协商的协议版本。

This returns None until the version is agreed.

pub fn handshake_kind(&self) -> Option<HandshakeKind>

执行的握手类型。

它会告知握手是否为恢复握手。

This 将返回 None before it is known which sort of handshake occurred.

pub fn wants_read(&self) -> bool

如果调用者应尽快调用以下方法，则返回 true： Connection::read_tls as soon as possible.

如果有要读取的待处理明文数据，请使用 Connection::reader, this returns false. If your application respects this mechanism, only one full TLS message ， buffered by rustls.

Trait 实现

impl<T> Deref for UnbufferedConnectionCommon<T>

type Target = CommonState

解引用后得到的类型。

fn deref(&self) -> &Self::Target

解引用此值。