Struct websocket::codec::http::HttpServerCodec

[+] Show declaration

pub struct HttpServerCodec;

[−] Expand description

A codec that can be used with streams implementing AsyncRead + AsyncWrite that can serialize HTTP responses and deserialize HTTP requests. Using this with an async TcpStream will give you a very bare async HTTP server.

This crate sends out one HTTP request / response in order to perform the websocket handshake then never talks HTTP again. Because of this an async HTTP implementation is needed.

Example

use websocket::async::HttpServerCodec;

let mut runtime = tokio::runtime::Builder::new().build().unwrap();
let addr = "nothing-to-see-here.com".parse().unwrap();

let f = TcpStream::connect(&addr)
   .map(|s| HttpServerCodec.framed(s))
   .map_err(|e| e.into())
   .and_then(|s| s.into_future().map_err(|(e, _)| e))
   .and_then(|(m, s)| match m {
       Some(ref m) if m.subject.0 == Method::Get => Ok(s),
       _ => panic!(),
   })
   .and_then(|stream| {
       stream
          .send(Incoming {
               version: HttpVersion::Http11,
               subject: StatusCode::NotFound,
               headers: Headers::new(),
           })
           .map_err(|e| e.into())
   });

runtime.block_on(f).unwrap();

Trait Implementations

impl Clone for HttpServerCodec[+]

[+] Show hidden undocumented items

fn clone(&self) -> HttpServerCodec[−]

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)[−]

Performs copy-assignment from source.

impl Copy for HttpServerCodec

impl Debug for HttpServerCodec[+]

[+] Show hidden undocumented items

fn fmt(&self, f: &mut Formatter<'_>) -> Result[−]

Formats the value using the given formatter.

impl Decoder for HttpServerCodec[+]

[+] Show hidden undocumented items

type Item = Incoming<(Method, RequestUri)>

The type of decoded frames.

type Error = HttpCodecError

The type of unrecoverable frame decoding errors.

fn decode(
    &mut self,
    src: &mut BytesMut
) -> Result<Option<Self::Item>, Self::Error>[−]

Attempts to decode a frame from the provided buffer of bytes.

pub fn decode_eof(
    &mut self,
    buf: &mut BytesMut
) -> Result<Option<Self::Item>, Self::Error>[−]

A default method available to be called when there are no more bytes available to be read from the underlying I/O.

pub fn framed<T>(self, io: T) -> Framed<T, Self> where
    Self: Encoder,
    T: AsyncRead + AsyncWrite, [−]

Provides a Stream and Sink interface for reading and writing to this Io object, using Decode and Encode to read and write the raw data.

impl Encoder for HttpServerCodec[+]

[+] Show hidden undocumented items

type Item = Incoming<StatusCode>

The type of items consumed by the Encoder

type Error = Error

The type of encoding errors.

fn encode(
    &mut self,
    item: Self::Item,
    dst: &mut BytesMut
) -> Result<(), Self::Error>[−]

Encodes a frame into the buffer provided.