//! Serialization support for querystrings. use percent_encoding::percent_encode; use serde::ser; use crate::error::*; use crate::utils::*; use std::borrow::Cow; use std::fmt::Display; use std::io::Write; use std::str; use std::sync::atomic::AtomicBool; use std::sync::atomic::Ordering; use std::sync::Arc; /// Serializes a value into a querystring. /// /// ``` /// # #[macro_use] /// # extern crate serde_derive; /// # extern crate serde_qs; /// #[derive(Deserialize, Serialize)] /// struct Query { /// name: String, /// age: u8, /// occupation: String, /// } /// /// # fn main(){ /// let q = Query { /// name: "Alice".to_owned(), /// age: 24, /// occupation: "Student".to_owned(), /// }; /// /// /// assert_eq!( /// serde_qs::to_string(&q).unwrap(), /// "name=Alice&age=24&occupation=Student"); /// # } /// ``` pub fn to_string(input: &T) -> Result { let mut buffer = Vec::new(); input.serialize(&mut Serializer::new(&mut buffer))?; String::from_utf8(buffer).map_err(Error::from) } /// Serializes a value into a generic writer object. /// /// ``` /// # #[macro_use] /// # extern crate serde_derive; /// # extern crate serde_qs; /// #[derive(Deserialize, Serialize)] /// struct Query { /// name: String, /// age: u8, /// occupation: String, /// } /// /// # fn main(){ /// let q = Query { /// name: "Alice".to_owned(), /// age: 24, /// occupation: "Student".to_owned(), /// }; /// /// let mut buffer = Vec::new(); /// serde_qs::to_writer(&q, &mut buffer).unwrap(); /// assert_eq!( /// String::from_utf8(buffer).unwrap(), /// "name=Alice&age=24&occupation=Student"); /// # } /// ``` pub fn to_writer(input: &T, writer: &mut W) -> Result<()> { input.serialize(&mut Serializer::new(writer)) } pub struct Serializer { writer: W, } impl Serializer { pub fn new(writer: W) -> Self { Self { writer } } fn as_qs_serializer(&mut self) -> QsSerializer { QsSerializer { writer: &mut self.writer, first: Arc::new(AtomicBool::new(true)), key: None, } } } macro_rules! serialize_as_string { (Serializer $($ty:ty => $meth:ident,)*) => { $( fn $meth(self, v: $ty) -> Result { let qs_serializer = self.as_qs_serializer(); qs_serializer.$meth(v) } )* }; (Qs $($ty:ty => $meth:ident,)*) => { $( fn $meth(mut self, v: $ty) -> Result { self.write_value(&v.to_string().as_bytes()) } )* }; ($($ty:ty => $meth:ident,)*) => { $( fn $meth(self, v: $ty) -> Result { Ok(v.to_string()) } )* }; } impl<'a, W: Write> ser::Serializer for &'a mut Serializer { type Ok = (); type Error = Error; type SerializeSeq = QsSeq<'a, W>; type SerializeTuple = QsSeq<'a, W>; type SerializeTupleStruct = QsSeq<'a, W>; type SerializeTupleVariant = QsSeq<'a, W>; type SerializeMap = QsMap<'a, W>; type SerializeStruct = QsSerializer<'a, W>; type SerializeStructVariant = QsSerializer<'a, W>; serialize_as_string! { Serializer bool => serialize_bool, u8 => serialize_u8, u16 => serialize_u16, u32 => serialize_u32, u64 => serialize_u64, i8 => serialize_i8, i16 => serialize_i16, i32 => serialize_i32, i64 => serialize_i64, f32 => serialize_f32, f64 => serialize_f64, char => serialize_char, &str => serialize_str, } fn serialize_bytes(self, value: &[u8]) -> Result { self.as_qs_serializer().serialize_bytes(value) } fn serialize_unit(self) -> Result { self.as_qs_serializer().serialize_unit() } fn serialize_unit_struct(self, name: &'static str) -> Result { self.as_qs_serializer().serialize_unit_struct(name) } fn serialize_unit_variant( self, name: &'static str, variant_index: u32, variant: &'static str, ) -> Result { self.as_qs_serializer() .serialize_unit_variant(name, variant_index, variant) } fn serialize_newtype_struct( self, name: &'static str, value: &T, ) -> Result { self.as_qs_serializer() .serialize_newtype_struct(name, value) } fn serialize_newtype_variant( self, name: &'static str, variant_index: u32, variant: &'static str, value: &T, ) -> Result { self.as_qs_serializer() .serialize_newtype_variant(name, variant_index, variant, value) } fn serialize_none(self) -> Result { self.as_qs_serializer().serialize_none() } fn serialize_some(self, value: &T) -> Result { self.as_qs_serializer().serialize_some(value) } fn serialize_seq(self, len: Option) -> Result { self.as_qs_serializer().serialize_seq(len) } fn serialize_tuple(self, len: usize) -> Result { self.as_qs_serializer().serialize_tuple(len) } fn serialize_tuple_struct( self, name: &'static str, len: usize, ) -> Result { self.as_qs_serializer().serialize_tuple_struct(name, len) } fn serialize_tuple_variant( self, name: &'static str, variant_index: u32, variant: &'static str, len: usize, ) -> Result { self.as_qs_serializer() .serialize_tuple_variant(name, variant_index, variant, len) } fn serialize_map(self, len: Option) -> Result { self.as_qs_serializer().serialize_map(len) } fn serialize_struct(self, name: &'static str, len: usize) -> Result { self.as_qs_serializer().serialize_struct(name, len) } fn serialize_struct_variant( self, name: &'static str, variant_index: u32, variant: &'static str, len: usize, ) -> Result { self.as_qs_serializer() .serialize_struct_variant(name, variant_index, variant, len) } } /// A serializer for the querystring format. /// /// * Supported top-level inputs are structs and maps. /// /// * Supported values are currently most primitive types, structs, maps and /// sequences. Sequences are serialized with an incrementing key index. /// /// * Newtype structs defer to their inner values. #[doc(hidden)] pub struct QsSerializer<'a, W: 'a + Write> { key: Option>, writer: &'a mut W, first: Arc, } impl<'a, W: 'a + Write> QsSerializer<'a, W> { fn extend_key(&mut self, newkey: &str) { let newkey = percent_encode(newkey.as_bytes(), QS_ENCODE_SET) .map(replace_space) .collect::(); let key = if let Some(ref key) = self.key { format!("{}[{}]", key, newkey) } else { newkey }; self.key = Some(Cow::Owned(key)) } fn write_value(&mut self, value: &[u8]) -> Result<()> { if let Some(ref key) = self.key { let amp = !self.first.swap(false, Ordering::Relaxed); write!( self.writer, "{}{}={}", if amp { "&" } else { "" }, key, percent_encode(value, QS_ENCODE_SET) .map(replace_space) .collect::() ) .map_err(Error::from) } else { Err(Error::no_key()) } } fn write_unit(&mut self) -> Result<()> { let amp = !self.first.swap(false, Ordering::Relaxed); if let Some(ref key) = self.key { write!(self.writer, "{}{}=", if amp { "&" } else { "" }, key,).map_err(Error::from) } else if amp { write!(self.writer, "&").map_err(Error::from) } else { Ok(()) } } /// Creates a new `QsSerializer` with a distinct key, but `writer` and ///`first` referring to the original data. fn new_from_ref<'b: 'a>(other: &'a mut QsSerializer<'b, W>) -> QsSerializer<'a, W> { Self { key: other.key.clone(), writer: other.writer, first: other.first.clone(), } } } impl Error { fn no_key() -> Self { let msg = "tried to serialize a value before serializing key"; Error::Custom(msg.into()) } } impl<'a, W: Write> ser::Serializer for QsSerializer<'a, W> { type Ok = (); type Error = Error; type SerializeSeq = QsSeq<'a, W>; type SerializeTuple = QsSeq<'a, W>; type SerializeTupleStruct = QsSeq<'a, W>; type SerializeTupleVariant = QsSeq<'a, W>; type SerializeMap = QsMap<'a, W>; type SerializeStruct = Self; type SerializeStructVariant = Self; serialize_as_string! { Qs bool => serialize_bool, u8 => serialize_u8, u16 => serialize_u16, u32 => serialize_u32, u64 => serialize_u64, i8 => serialize_i8, i16 => serialize_i16, i32 => serialize_i32, i64 => serialize_i64, f32 => serialize_f32, f64 => serialize_f64, char => serialize_char, &str => serialize_str, } fn serialize_bytes(mut self, value: &[u8]) -> Result { self.write_value(value) } fn serialize_unit(mut self) -> Result { self.write_unit() } fn serialize_unit_struct(mut self, _: &'static str) -> Result { self.write_unit() } fn serialize_unit_variant( mut self, _name: &'static str, _variant_index: u32, variant: &'static str, ) -> Result { self.write_value(variant.as_bytes()) } fn serialize_newtype_struct( self, _name: &'static str, value: &T, ) -> Result { value.serialize(self) } fn serialize_newtype_variant( mut self, _name: &'static str, _variant_index: u32, variant: &'static str, value: &T, ) -> Result { self.extend_key(variant); value.serialize(self) } fn serialize_none(self) -> Result { Ok(()) } fn serialize_some(self, value: &T) -> Result { value.serialize(self) } fn serialize_seq(self, _len: Option) -> Result { Ok(QsSeq(self, 0)) } fn serialize_tuple(self, _len: usize) -> Result { Ok(QsSeq(self, 0)) } fn serialize_tuple_struct( self, _name: &'static str, _len: usize, ) -> Result { Ok(QsSeq(self, 0)) } fn serialize_tuple_variant( mut self, _name: &'static str, _variant_index: u32, variant: &'static str, _len: usize, ) -> Result { self.extend_key(variant); Ok(QsSeq(self, 0)) } fn serialize_map(self, _len: Option) -> Result { Ok(QsMap(self, None)) } fn serialize_struct(self, _name: &'static str, _len: usize) -> Result { Ok(self) } fn serialize_struct_variant( mut self, _name: &'static str, _variant_index: u32, variant: &'static str, _len: usize, ) -> Result { self.extend_key(variant); Ok(self) } } impl ser::Error for Error { fn custom(msg: T) -> Self where T: Display, { Error::Custom(msg.to_string()) } } #[doc(hidden)] pub struct QsSeq<'a, W: 'a + Write>(QsSerializer<'a, W>, usize); #[doc(hidden)] pub struct QsMap<'a, W: 'a + Write>(QsSerializer<'a, W>, Option>); impl ser::SerializeTuple for QsSeq<'_, W> { type Ok = (); type Error = Error; fn serialize_element(&mut self, value: &T) -> Result<()> where T: ser::Serialize + ?Sized, { let key = self.1.to_string(); self.1 += 1; let mut serializer = QsSerializer::new_from_ref(&mut self.0); serializer.extend_key(&key); value.serialize(serializer) } fn end(self) -> Result { Ok(()) } } impl ser::SerializeSeq for QsSeq<'_, W> { type Ok = (); type Error = Error; fn serialize_element(&mut self, value: &T) -> Result<()> where T: ser::Serialize + ?Sized, { let mut serializer = QsSerializer::new_from_ref(&mut self.0); serializer.extend_key(&self.1.to_string()); self.1 += 1; value.serialize(serializer) } fn end(self) -> Result { Ok(()) } } impl ser::SerializeStruct for QsSerializer<'_, W> { type Ok = (); type Error = Error; fn serialize_field(&mut self, key: &'static str, value: &T) -> Result<()> where T: ser::Serialize + ?Sized, { let mut serializer = QsSerializer::new_from_ref(self); serializer.extend_key(key); value.serialize(serializer) } fn end(self) -> Result { Ok(()) } } impl ser::SerializeStructVariant for QsSerializer<'_, W> { type Ok = (); type Error = Error; fn serialize_field(&mut self, key: &'static str, value: &T) -> Result<()> where T: ser::Serialize + ?Sized, { let mut serializer = QsSerializer::new_from_ref(self); serializer.extend_key(key); value.serialize(serializer) } fn end(self) -> Result { Ok(()) } } impl ser::SerializeTupleVariant for QsSeq<'_, W> { type Ok = (); type Error = Error; fn serialize_field(&mut self, value: &T) -> Result<()> where T: ser::Serialize + ?Sized, { let mut serializer = QsSerializer::new_from_ref(&mut self.0); serializer.extend_key(&self.1.to_string()); self.1 += 1; value.serialize(serializer) } fn end(self) -> Result { Ok(()) } } impl ser::SerializeTupleStruct for QsSeq<'_, W> { type Ok = (); type Error = Error; fn serialize_field(&mut self, value: &T) -> Result<()> where T: ser::Serialize + ?Sized, { let mut serializer = QsSerializer::new_from_ref(&mut self.0); serializer.extend_key(&self.1.to_string()); self.1 += 1; value.serialize(serializer) } fn end(self) -> Result { Ok(()) } } impl ser::SerializeMap for QsMap<'_, W> { type Ok = (); type Error = Error; fn serialize_key(&mut self, key: &T) -> Result<()> where T: ser::Serialize + ?Sized, { self.1 = Some(Cow::from(key.serialize(StringSerializer)?)); Ok(()) } fn serialize_value(&mut self, value: &T) -> Result<()> where T: ser::Serialize + ?Sized, { let mut serializer = QsSerializer::new_from_ref(&mut self.0); if let Some(ref key) = self.1 { serializer.extend_key(key); } else { return Err(Error::no_key()); } self.1 = None; value.serialize(serializer) } fn end(self) -> Result { Ok(()) } fn serialize_entry(&mut self, key: &K, value: &V) -> Result<()> where K: ser::Serialize + ?Sized, V: ser::Serialize + ?Sized, { let mut serializer = QsSerializer::new_from_ref(&mut self.0); serializer.extend_key(&key.serialize(StringSerializer)?); value.serialize(serializer) } } struct StringSerializer; impl ser::Serializer for StringSerializer { type Ok = String; type Error = Error; type SerializeSeq = ser::Impossible; type SerializeTuple = ser::Impossible; type SerializeTupleStruct = ser::Impossible; type SerializeTupleVariant = ser::Impossible; type SerializeMap = ser::Impossible; type SerializeStruct = ser::Impossible; type SerializeStructVariant = ser::Impossible; serialize_as_string! { bool => serialize_bool, u8 => serialize_u8, u16 => serialize_u16, u32 => serialize_u32, u64 => serialize_u64, i8 => serialize_i8, i16 => serialize_i16, i32 => serialize_i32, i64 => serialize_i64, f32 => serialize_f32, f64 => serialize_f64, char => serialize_char, &str => serialize_str, } fn serialize_bytes(self, value: &[u8]) -> Result { Ok(String::from_utf8_lossy(value).to_string()) } /// Returns an error. fn serialize_unit(self) -> Result { Err(Error::Unsupported) } /// Returns an error. fn serialize_unit_struct(self, _name: &'static str) -> Result { Err(Error::Unsupported) } fn serialize_unit_variant( self, _name: &'static str, _variant_index: u32, variant: &'static str, ) -> Result { Ok(variant.to_string()) } /// Returns an error. fn serialize_newtype_struct( self, _name: &'static str, _value: &T, ) -> Result { Err(Error::Unsupported) } /// Returns an error. fn serialize_newtype_variant( self, _name: &'static str, _variant_index: u32, _variant: &'static str, _value: &T, ) -> Result { Err(Error::Unsupported) } /// Returns an error. fn serialize_none(self) -> Result { Err(Error::Unsupported) } /// Returns an error. fn serialize_some(self, _value: &T) -> Result { Err(Error::Unsupported) } /// Returns an error. fn serialize_seq(self, _len: Option) -> Result { Err(Error::Unsupported) } fn serialize_tuple(self, _len: usize) -> Result { Err(Error::Unsupported) } /// Returns an error. fn serialize_tuple_struct( self, _name: &'static str, _len: usize, ) -> Result { Err(Error::Unsupported) } fn serialize_tuple_variant( self, _name: &'static str, _variant_index: u32, _variant: &'static str, _len: usize, ) -> Result { Err(Error::Unsupported) } fn serialize_map(self, _len: Option) -> Result { Err(Error::Unsupported) } fn serialize_struct(self, _name: &'static str, _len: usize) -> Result { Err(Error::Unsupported) } fn serialize_struct_variant( self, _name: &'static str, _variant_index: u32, _variant: &'static str, _len: usize, ) -> Result { Err(Error::Unsupported) } }