http-type 22.0.8

A comprehensive Rust type library for HTTP operations and concurrent programming. Provides core HTTP types (Request/Response with builder patterns, Method, HttpStatus, HttpVersion, ContentType, FileExtension with MIME mapping, Cookie parsing/building, HttpUrl parsing, WebSocket frame/opcode, protocol upgrade types, stream/task management, panic handling), thread-safe concurrent wrappers (ArcMutex, ArcRwLock, BoxRwLock, RcRwLock), dynamic dispatch types (BoxAny, RcAny, ArcAny with Send/Sync variants), high-performance hash collections (HashMapXxHash3_64, HashSetXxHash3_64), and static lifetime utilities (BoxLeak, Lifetime trait).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

use super::*;

/// A bidirectional byte pipe that a request/response cycle can run over.
///
/// The transport is the only part of the server that knows what is carrying
/// the bytes. Everything above this trait is protocol agnostic: a plain TCP
/// socket, a TLS session and a per-request duplex stream are the same thing to
/// the parsing pipeline once they are type erased behind `Transport`.
///
/// Implementations report their own socket metadata, so a transport without a
/// socket identity (a duplex pair, an in-memory pipe) answers with an error
/// instead of pretending to have an address.
pub trait Transport: AsyncRead + AsyncWrite + Debug + Unpin + Send + Sync {
    /// Reports the address of the remote end of the transport.
    ///
    /// # Returns
    ///
    /// - `Result<SocketAddr, io::Error>` - The remote address, or an error when the
    ///   transport has no socket identity.
    fn peer_addr(&self) -> Result<SocketAddr, io::Error>;

    /// Reports the address of the local end of the transport.
    ///
    /// # Returns
    ///
    /// - `Result<SocketAddr, io::Error>` - The local address, or an error when the
    ///   transport has no socket identity.
    fn local_addr(&self) -> Result<SocketAddr, io::Error>;
}