একটি JSON নমুনাকে serde-র জন্য প্রস্তুত Rust struct-এ বদলে নিন। প্রতিটি struct Debug, Clone, Serialize, Deserialize derive করে; ফিল্ডের নাম Rust-এর snake_case রীতি মানে, আর মূল key থেকে আলাদা হলে #[serde(rename)] দিয়ে সেটির সাথে বাঁধা থাকে।
reqwest-এর টাইপড response চাইলে, axum বা actix-web-এর Json<T> extractor-এর জন্য request type দরকার হলে, অথবা লগ বা ইভেন্ট JSON parse করা CLI লিখলে এটি একটি শুরুর বিন্দু।
টাইপের নাম-এ top-level struct-এর নাম দিন (যেমন AccessLog)।.rs ফাইলে পেস্ট করুন এবং Cargo.toml-এ serde (derive ফিচারসহ) আর serde_json যোগ করুন।serde_json::from_str::<AccessLog>(&body)? বা resp.json::<AccessLog>().await? দিয়ে ব্যবহার করুন।{
"timestamp": 1714550400,
"level": "warn",
"type": "http_request",
"status": 503,
"latency_ms": 1250.7,
"headers": [{ "name": "user-agent", "value": "curl/8.4" }],
"trace_id": null
}use serde::{Deserialize, Serialize};
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AccessLog {
pub timestamp: i64,
pub level: String,
#[serde(rename = "type")]
pub type_: String,
pub status: i64,
pub latency_ms: f64,
pub headers: Vec<Header>,
pub trace_id: serde_json::Value,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Header {
pub name: String,
pub value: String,
}
type একটি Rust keyword, তাই ফিল্ডটি #[serde(rename = "type")]-সহ type_। আকার যা-ই হোক integer হয় i64, আর latency_ms হয় f64। trace_id সবসময় শুধু null, তাই এর type অজানা এবং এটি serde_json::Value থাকে; আসল type দিয়ে বদলে দিন, যেমন Option<String>।
#[derive(Debug, Clone, Serialize, Deserialize)] আর pub ফিল্ড।#[serde(rename = "originalKey")]।#[serde(default, skip_serializing_if = "Option::is_none")]-সহ Option<T>।null এমন ফিল্ড: অ্যাট্রিবিউট ছাড়া সাধারণ Option<T>।i64, দশমিকের জন্য f64, bool, String, Vec<T>, আর মিশ্র type-এর জন্য serde_json::Value।type, match বা ref-এর মতো keyword key-এর শেষে আন্ডারস্কোর যোগ হয় (type_)।pub type Root = Vec<RootItem>; তৈরি হয়।["status"].as_i64()-এর মতো serde_json::Value lookup-কে resp.json::<AccessLog>() দিয়ে বদলান, যাতে ভুল বানানের ফিল্ড কম্পাইলের সময়েই ধরা পড়ে।
ক্লায়েন্টের পাঠানো JSON থেকে struct তৈরি করে Json(payload): Json<CreateOrder> হিসেবে গ্রহণ করুন; ফিল্ড না থাকা বা ভুল type-এর request আপনার handler কোড চলার আগেই ফ্রেমওয়ার্ক প্রত্যাখ্যান করে।
একটি লগ লাইন থেকে struct তৈরি করুন, তারপর BufReader::lines() থেকে প্রতিটি লাইন deserialize করে কয়েক লাইনেই ফিল্ড-ভিত্তিক aggregation টুল পেয়ে যান।
i64। পরিসীমা জানা থাকলে নিজে সংকুচিত করুন, যেমন u16 status code বা u32 counter।i64 বা String থাকে। chrono বা time type-এ যেতে ওই crate-গুলোর serde ফিচার চালু করতে হয়।serde_json::Value ব্যবহার করা আউটপুট পুরো path লেখে, তাই বাড়তি use লাগে না, কিন্তু serde_json dependency লাগে।#[serde(rename_all = "camelCase")] হিসেবে নয়। Key-গুলো একটি রীতি মানলে নিজে সেগুলো একত্রিত করতে পারেন।"level": "warn"-এর মতো নির্দিষ্ট কিছু ভ্যালুর ফিল্ড পরে enum বানানোর ভালো প্রার্থী।#[serde(default)]-ও পায়?serde অনুপস্থিত Option-কে এমনিতেই None দিয়ে পূরণ করে, কিন্তু স্পষ্ট default থাকলে পরে type বদলে Vec<T>-এর মতো কিছু করলেও অনুপস্থিত key গ্রহণ করা চলতে থাকে। skip_serializing_if আবার JSON লেখার সময় None ফিল্ড বাদ দেয়, ফলে মূল আকৃতি বজায় থাকে।
দুটোই Option<T> হয়, কিন্তু শুধু যেসব ফিল্ডের key অনুপস্থিত থাকতে পারে সেগুলো default আর skip_serializing_if অ্যাট্রিবিউট পায়। সবসময় থাকে কিন্তু মাঝে মাঝে null এমন ফিল্ড আবার null হিসেবেই লেখা হয়।
&str ফিল্ড আর 'de lifetime দিয়ে borrow করা হয় না কেন?Zero-copy ফিল্ড (&'a str) ইনপুট বাফারের চেয়ে বেশি সময় টিকতে পারে না, যা সাধারণ response হ্যান্ডলিংয়ে অসুবিধাজনক। Owned String-ই ডিফল্ট; পারফরম্যান্স গুরুত্বপূর্ণ হলে বেশি ব্যবহৃত ফিল্ডগুলো Cow<'a, str>-এ বদলান।
Default বা PartialEq derive কি যোগ করা যায়?আউটপুট শুধু Debug, Clone, Serialize আর Deserialize derive করে। সব ফিল্ডের type সাপোর্ট করলে derive তালিকায় নিজে আরও যোগ করুন (serde_json::Value PartialEq ইমপ্লিমেন্ট করে)।