use std::sync::Arc; use std::{fmt, mem}; use bytes::{Bytes, BytesMut}; use futures::{Async, Poll, Stream}; use error::{Error, PayloadError}; /// Type represent streaming body pub type BodyStream = Box>; /// Type represent streaming payload pub type PayloadStream = Box>; #[derive(Debug)] /// Different type of body pub enum BodyLength { None, Zero, Sized(usize), Sized64(u64), Unsized, } /// Type that provides this trait can be streamed to a peer. pub trait MessageBody { fn length(&self) -> BodyLength; fn poll_next(&mut self) -> Poll, Error>; } impl MessageBody for () { fn length(&self) -> BodyLength { BodyLength::Zero } fn poll_next(&mut self) -> Poll, Error> { Ok(Async::Ready(None)) } } /// Represents various types of http message body. pub enum Body { /// Empty response. `Content-Length` header is set to `0` Empty, /// Specific response body. Binary(Binary), /// Unspecified streaming response. Developer is responsible for setting /// right `Content-Length` or `Transfer-Encoding` headers. Streaming(BodyStream), } /// Represents various types of binary body. /// `Content-Length` header is set to length of the body. #[derive(Debug, PartialEq)] pub enum Binary { /// Bytes body Bytes(Bytes), /// Static slice Slice(&'static [u8]), /// Shared string body #[doc(hidden)] SharedString(Arc), /// Shared vec body SharedVec(Arc>), } impl Body { /// Does this body streaming. #[inline] pub fn is_streaming(&self) -> bool { match *self { Body::Streaming(_) => true, _ => false, } } /// Is this binary body. #[inline] pub fn is_binary(&self) -> bool { match *self { Body::Binary(_) => true, _ => false, } } /// Is this binary empy. #[inline] pub fn is_empty(&self) -> bool { match *self { Body::Empty => true, _ => false, } } /// Create body from slice (copy) pub fn from_slice(s: &[u8]) -> Body { Body::Binary(Binary::Bytes(Bytes::from(s))) } /// Is this binary body. #[inline] pub(crate) fn into_binary(self) -> Option { match self { Body::Binary(b) => Some(b), _ => None, } } } impl PartialEq for Body { fn eq(&self, other: &Body) -> bool { match *self { Body::Empty => match *other { Body::Empty => true, _ => false, }, Body::Binary(ref b) => match *other { Body::Binary(ref b2) => b == b2, _ => false, }, Body::Streaming(_) => false, } } } impl fmt::Debug for Body { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { match *self { Body::Empty => write!(f, "Body::Empty"), Body::Binary(ref b) => write!(f, "Body::Binary({:?})", b), Body::Streaming(_) => write!(f, "Body::Streaming(_)"), } } } impl From for Body where T: Into, { fn from(b: T) -> Body { Body::Binary(b.into()) } } impl Binary { #[inline] /// Returns `true` if body is empty pub fn is_empty(&self) -> bool { self.len() == 0 } #[inline] /// Length of body in bytes pub fn len(&self) -> usize { match *self { Binary::Bytes(ref bytes) => bytes.len(), Binary::Slice(slice) => slice.len(), Binary::SharedString(ref s) => s.len(), Binary::SharedVec(ref s) => s.len(), } } /// Create binary body from slice pub fn from_slice(s: &[u8]) -> Binary { Binary::Bytes(Bytes::from(s)) } /// Convert Binary to a Bytes instance pub fn take(&mut self) -> Bytes { mem::replace(self, Binary::Slice(b"")).into() } } impl Clone for Binary { fn clone(&self) -> Binary { match *self { Binary::Bytes(ref bytes) => Binary::Bytes(bytes.clone()), Binary::Slice(slice) => Binary::Bytes(Bytes::from(slice)), Binary::SharedString(ref s) => Binary::SharedString(s.clone()), Binary::SharedVec(ref s) => Binary::SharedVec(s.clone()), } } } impl Into for Binary { fn into(self) -> Bytes { match self { Binary::Bytes(bytes) => bytes, Binary::Slice(slice) => Bytes::from(slice), Binary::SharedString(s) => Bytes::from(s.as_str()), Binary::SharedVec(s) => Bytes::from(AsRef::<[u8]>::as_ref(s.as_ref())), } } } impl From<&'static str> for Binary { fn from(s: &'static str) -> Binary { Binary::Slice(s.as_ref()) } } impl From<&'static [u8]> for Binary { fn from(s: &'static [u8]) -> Binary { Binary::Slice(s) } } impl From> for Binary { fn from(vec: Vec) -> Binary { Binary::Bytes(Bytes::from(vec)) } } impl From for Binary { fn from(s: String) -> Binary { Binary::Bytes(Bytes::from(s)) } } impl<'a> From<&'a String> for Binary { fn from(s: &'a String) -> Binary { Binary::Bytes(Bytes::from(AsRef::<[u8]>::as_ref(&s))) } } impl From for Binary { fn from(s: Bytes) -> Binary { Binary::Bytes(s) } } impl From for Binary { fn from(s: BytesMut) -> Binary { Binary::Bytes(s.freeze()) } } impl From> for Binary { fn from(body: Arc) -> Binary { Binary::SharedString(body) } } impl<'a> From<&'a Arc> for Binary { fn from(body: &'a Arc) -> Binary { Binary::SharedString(Arc::clone(body)) } } impl From>> for Binary { fn from(body: Arc>) -> Binary { Binary::SharedVec(body) } } impl<'a> From<&'a Arc>> for Binary { fn from(body: &'a Arc>) -> Binary { Binary::SharedVec(Arc::clone(body)) } } impl AsRef<[u8]> for Binary { #[inline] fn as_ref(&self) -> &[u8] { match *self { Binary::Bytes(ref bytes) => bytes.as_ref(), Binary::Slice(slice) => slice, Binary::SharedString(ref s) => s.as_bytes(), Binary::SharedVec(ref s) => s.as_ref().as_ref(), } } } impl MessageBody for Bytes { fn length(&self) -> BodyLength { BodyLength::Sized(self.len()) } fn poll_next(&mut self) -> Poll, Error> { if self.is_empty() { Ok(Async::Ready(None)) } else { Ok(Async::Ready(Some(mem::replace(self, Bytes::new())))) } } } impl MessageBody for &'static str { fn length(&self) -> BodyLength { BodyLength::Sized(self.len()) } fn poll_next(&mut self) -> Poll, Error> { if self.is_empty() { Ok(Async::Ready(None)) } else { Ok(Async::Ready(Some(Bytes::from_static( mem::replace(self, "").as_ref(), )))) } } } impl MessageBody for &'static [u8] { fn length(&self) -> BodyLength { BodyLength::Sized(self.len()) } fn poll_next(&mut self) -> Poll, Error> { if self.is_empty() { Ok(Async::Ready(None)) } else { Ok(Async::Ready(Some(Bytes::from_static(mem::replace( self, b"", ))))) } } } impl MessageBody for Vec { fn length(&self) -> BodyLength { BodyLength::Sized(self.len()) } fn poll_next(&mut self) -> Poll, Error> { if self.is_empty() { Ok(Async::Ready(None)) } else { Ok(Async::Ready(Some(Bytes::from(mem::replace( self, Vec::new(), ))))) } } } impl MessageBody for String { fn length(&self) -> BodyLength { BodyLength::Sized(self.len()) } fn poll_next(&mut self) -> Poll, Error> { if self.is_empty() { Ok(Async::Ready(None)) } else { Ok(Async::Ready(Some(Bytes::from( mem::replace(self, String::new()).into_bytes(), )))) } } } #[doc(hidden)] pub struct MessageBodyStream { stream: S, } impl MessageBodyStream where S: Stream, { pub fn new(stream: S) -> Self { MessageBodyStream { stream } } } impl MessageBody for MessageBodyStream where S: Stream, { fn length(&self) -> BodyLength { BodyLength::Unsized } fn poll_next(&mut self) -> Poll, Error> { self.stream.poll() } } #[cfg(test)] mod tests { use super::*; #[test] fn test_body_is_streaming() { assert_eq!(Body::Empty.is_streaming(), false); assert_eq!(Body::Binary(Binary::from("")).is_streaming(), false); } #[test] fn test_is_empty() { assert_eq!(Binary::from("").is_empty(), true); assert_eq!(Binary::from("test").is_empty(), false); } #[test] fn test_static_str() { assert_eq!(Binary::from("test").len(), 4); assert_eq!(Binary::from("test").as_ref(), b"test"); } #[test] fn test_static_bytes() { assert_eq!(Binary::from(b"test".as_ref()).len(), 4); assert_eq!(Binary::from(b"test".as_ref()).as_ref(), b"test"); assert_eq!(Binary::from_slice(b"test".as_ref()).len(), 4); assert_eq!(Binary::from_slice(b"test".as_ref()).as_ref(), b"test"); } #[test] fn test_vec() { assert_eq!(Binary::from(Vec::from("test")).len(), 4); assert_eq!(Binary::from(Vec::from("test")).as_ref(), b"test"); } #[test] fn test_bytes() { assert_eq!(Binary::from(Bytes::from("test")).len(), 4); assert_eq!(Binary::from(Bytes::from("test")).as_ref(), b"test"); } #[test] fn test_arc_string() { let b = Arc::new("test".to_owned()); assert_eq!(Binary::from(b.clone()).len(), 4); assert_eq!(Binary::from(b.clone()).as_ref(), b"test"); assert_eq!(Binary::from(&b).len(), 4); assert_eq!(Binary::from(&b).as_ref(), b"test"); } #[test] fn test_string() { let b = "test".to_owned(); assert_eq!(Binary::from(b.clone()).len(), 4); assert_eq!(Binary::from(b.clone()).as_ref(), b"test"); assert_eq!(Binary::from(&b).len(), 4); assert_eq!(Binary::from(&b).as_ref(), b"test"); } #[test] fn test_shared_vec() { let b = Arc::new(Vec::from(&b"test"[..])); assert_eq!(Binary::from(b.clone()).len(), 4); assert_eq!(Binary::from(b.clone()).as_ref(), &b"test"[..]); assert_eq!(Binary::from(&b).len(), 4); assert_eq!(Binary::from(&b).as_ref(), &b"test"[..]); } #[test] fn test_bytes_mut() { let b = BytesMut::from("test"); assert_eq!(Binary::from(b.clone()).len(), 4); assert_eq!(Binary::from(b).as_ref(), b"test"); } #[test] fn test_binary_into() { let bytes = Bytes::from_static(b"test"); let b: Bytes = Binary::from("test").into(); assert_eq!(b, bytes); let b: Bytes = Binary::from(bytes.clone()).into(); assert_eq!(b, bytes); } }