use schemars::JsonSchema;
use serde::{Deserialize, Serialize};
pub const DEFAULT_MULTIPART_MAX_FIELDS: u16 = 64;
pub const DEFAULT_MULTIPART_MAX_FILES: u16 = 8;
pub const DEFAULT_MULTIPART_MAX_FILE_BYTES: u64 = 10 * 1024 * 1024;
pub const DEFAULT_MULTIPART_MAX_TEXT_FIELD_BYTES: u64 = 64 * 1024;
pub const DEFAULT_MULTIPART_MAX_TOTAL_BYTES: u64 = 32 * 1024 * 1024;
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default, Serialize, Deserialize, JsonSchema)]
#[serde(rename_all = "snake_case")]
#[non_exhaustive]
pub enum ActionMediaType {
Multipart,
#[default]
#[serde(other)]
Json,
}
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default, Serialize, Deserialize, JsonSchema)]
#[serde(rename_all = "snake_case")]
#[non_exhaustive]
pub enum UploadLifecycle {
#[default]
#[serde(other)]
RequestScoped,
}
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize, JsonSchema)]
pub struct MultipartSpec {
pub max_fields: u16,
pub max_files: u16,
pub max_file_bytes: u64,
pub max_text_field_bytes: u64,
pub max_total_bytes: u64,
pub allowed_content_types: Vec<String>,
pub lifecycle: UploadLifecycle,
}
impl MultipartSpec {
pub fn new<I, S>(allowed_content_types: I) -> Self
where
I: IntoIterator<Item = S>,
S: Into<String>,
{
Self {
max_fields: DEFAULT_MULTIPART_MAX_FIELDS,
max_files: DEFAULT_MULTIPART_MAX_FILES,
max_file_bytes: DEFAULT_MULTIPART_MAX_FILE_BYTES,
max_text_field_bytes: DEFAULT_MULTIPART_MAX_TEXT_FIELD_BYTES,
max_total_bytes: DEFAULT_MULTIPART_MAX_TOTAL_BYTES,
allowed_content_types: allowed_content_types.into_iter().map(Into::into).collect(),
lifecycle: UploadLifecycle::RequestScoped,
}
}
#[must_use]
pub fn max_fields(mut self, max_fields: u16) -> Self {
self.max_fields = max_fields;
self
}
#[must_use]
pub fn max_files(mut self, max_files: u16) -> Self {
self.max_files = max_files;
self
}
#[must_use]
pub fn max_file_bytes(mut self, max_file_bytes: u64) -> Self {
self.max_file_bytes = max_file_bytes;
self
}
#[must_use]
pub fn max_text_field_bytes(mut self, max_text_field_bytes: u64) -> Self {
self.max_text_field_bytes = max_text_field_bytes;
self
}
#[must_use]
pub fn max_total_bytes(mut self, max_total_bytes: u64) -> Self {
self.max_total_bytes = max_total_bytes;
self
}
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn unknown_media_and_lifecycle_values_fail_closed() {
let media: ActionMediaType =
serde_json::from_str("\"websocket\"").expect("未知请求媒体类型应安全解析");
let lifecycle: UploadLifecycle =
serde_json::from_str("\"permanent\"").expect("未知上传生命周期应安全解析");
assert_eq!(media, ActionMediaType::Json);
assert_eq!(lifecycle, UploadLifecycle::RequestScoped);
}
#[test]
fn multipart_defaults_are_bounded() {
let spec = MultipartSpec::new(["application/pdf"]);
assert_eq!(spec.max_fields, DEFAULT_MULTIPART_MAX_FIELDS);
assert_eq!(spec.max_files, DEFAULT_MULTIPART_MAX_FILES);
assert_eq!(spec.max_file_bytes, DEFAULT_MULTIPART_MAX_FILE_BYTES);
assert_eq!(
spec.max_text_field_bytes,
DEFAULT_MULTIPART_MAX_TEXT_FIELD_BYTES
);
assert_eq!(spec.max_total_bytes, DEFAULT_MULTIPART_MAX_TOTAL_BYTES);
assert_eq!(spec.lifecycle, UploadLifecycle::RequestScoped);
}
}