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 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61
use std::collections::HashMap;
use crate::constants;
/// Represents size limit of the stream to prevent DoS attacks.
///
/// Please refer [`Constraints`](crate::Constraints) for more info.
#[derive(Debug)]
pub struct SizeLimit {
pub(crate) whole_stream: u64,
pub(crate) per_field: u64,
pub(crate) field_map: HashMap<String, u64>,
}
impl SizeLimit {
/// Creates a default size limit which is [`u64::MAX`] for the whole stream
/// and for each field.
pub fn new() -> SizeLimit {
SizeLimit::default()
}
/// Sets size limit for the whole stream.
pub fn whole_stream(mut self, limit: u64) -> SizeLimit {
self.whole_stream = limit;
self
}
/// Sets size limit for each field.
pub fn per_field(mut self, limit: u64) -> SizeLimit {
self.per_field = limit;
self
}
/// Sets size limit for a specific field, it overrides the
/// [`per_field`](Self::per_field) value for this field.
///
/// It is useful when you want to set a size limit on a textual field which
/// will be stored in memory to avoid potential DoS attacks from
/// attackers running the server out of memory.
pub fn for_field<N: Into<String>>(mut self, field_name: N, limit: u64) -> SizeLimit {
self.field_map.insert(field_name.into(), limit);
self
}
pub(crate) fn extract_size_limit_for(&self, field: Option<&str>) -> u64 {
field
.and_then(|field| self.field_map.get(&field.to_owned()))
.copied()
.unwrap_or(self.per_field)
}
}
impl Default for SizeLimit {
fn default() -> Self {
SizeLimit {
whole_stream: constants::DEFAULT_WHOLE_STREAM_SIZE_LIMIT,
per_field: constants::DEFAULT_PER_FIELD_SIZE_LIMIT,
field_map: HashMap::default(),
}
}
}