Struct CorsManager 

pub struct CorsManager { /* private fields */ }

per-bucket CORS configuration を一元管理する manager。

すべての書き込み (put / delete) は RwLock write 経由で atomic、 すべての読み出し (get / match_preflight) は read 経由で CorsConfig の clone (or 派生 CorsRule の clone) を返す。

Implementations

impl CorsManager

pub fn new() -> Self

空 manager。

pub fn put(&self, bucket: &str, config: CorsConfig)

put_bucket_cors handler から呼ぶ。bucket の既存 configuration は 完全に置き換える (S3 spec: PutBucketCors は upsert ではなく replace)。

pub fn get(&self, bucket: &str) -> Option<CorsConfig>

get_bucket_cors handler から呼ぶ。configuration が無ければ None (handler 側で NoSuchCORSConfiguration 404 を返す材料)。

pub fn delete(&self, bucket: &str)

delete_bucket_cors handler から呼ぶ。bucket が無くても idempotent。

pub fn to_json(&self) -> Result<String, Error>

snapshot を JSON 文字列にして返す。--cors-state-file 経路で 起動時 dump-load を将来 wire するための hook。

pub fn from_json(s: &str) -> Result<Self, Error>

snapshot JSON から restore。起動時に --cors-state-file を読み込む 経路で使える。

pub fn match_preflight( &self, bucket: &str, origin: &str, method: &str, request_headers: &[String], ) -> Option<CorsRule>

CORS preflight (OPTIONS) request を bucket の rule list に対して評価 する。S3 仕様通り、宣言順で 最初にマッチした rule を返す。マッチ しない / bucket に config が無い場合は None。

rule マッチ条件 (AND):

1. origin が rule.allowed_origins のどれか 1 つに matches_glob でマッチ
2. method (uppercase) が rule.allowed_methods の exact-match 1 つに含まれる
3. request_headers の 全要素 が rule.allowed_headers のいずれかに matches_glob (case-insensitive) でマッチ

Trait Implementations

impl Debug for CorsManager

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

Formats the value using the given formatter.

impl Default for CorsManager

fn default() -> CorsManager

Returns the “default value” for a type.