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 core = Core::new().unwrap();
let addr = "nothing-to-see-here.com".parse().unwrap();

let f = TcpStream::connect(&addr, &core.handle())
   .map(|s| s.framed(HttpServerCodec))
   .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())
   });

core.run(f).unwrap();

Trait Implementations

impl Clone for HttpServerCodec

[+]

fn clone(&self) -> HttpServerCodec

[−]

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

[−]

Performs copy-assignment from source.

impl Copy for HttpServerCodec

impl Debug for HttpServerCodec

[+]

fn fmt(&self, f: &mut Formatter) -> Result

[−]

Formats the value using the given formatter.

impl Decoder for HttpServerCodec

[+]

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.

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.

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

[+]

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.