JSON نمونے کو serde کے لیے تیار Rust structs میں بدلیں۔ ہر struct، Debug, Clone, Serialize, Deserialize derive کرتا ہے؛ فیلڈ نام Rust کے snake_case رواج پر چلتے ہیں اور مختلف ہونے پر #[serde(rename)] سے اصل key سے جوڑے جاتے ہیں۔
یہ تب نقطۂ آغاز ہے جب آپ کو typed reqwest responses چاہئیں، axum یا actix-web کے Json<T> extractor کے لیے request type درکار ہو، یا آپ log یا event JSON parse کرنے والا CLI لکھ رہے ہوں۔
ٹائپ کا نام میں سب سے اوپر والے struct کا نام لکھیں (مثلاً AccessLog)۔.rs فائل میں پیسٹ کریں اور Cargo.toml میں serde (derive feature کے ساتھ) اور 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_ ہے۔ integers سائز سے قطع نظر 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 والے فیلڈز: بغیر attributes کے سادہ Option<T>۔i64، decimals کے لیے f64، bool، String، Vec<T>، اور ملی جلی types کے لیے serde_json::Value۔type، match یا ref جیسی keyword keys کے آخر میں underscore لگتا ہے (type_)۔pub type Root = Vec<RootItem>; بنتا ہے۔["status"].as_i64() جیسے serde_json::Value lookups کو resp.json::<AccessLog>() سے بدلیں تاکہ غلط ہجے والا فیلڈ compile کے وقت ہی پکڑا جائے۔
client کے بھیجے JSON سے struct بنائیں اور اسے Json(payload): Json<CreateOrder> کی صورت میں قبول کریں؛ غائب یا غلط type والے فیلڈز والی requests آپ کے handler کوڈ چلنے سے پہلے ہی framework رد کر دیتا ہے۔
ایک log لائن سے struct بنائیں، پھر BufReader::lines() کی ہر لائن deserialize کریں اور چند لائنوں میں فیلڈ وار aggregation ٹول تیار کر لیں۔
i64 ہوتے ہیں، چاہے کتنے ہی چھوٹے ہوں۔ جہاں حد معلوم ہو وہاں انہیں خود محدود کریں، مثلاً status codes کے لیے u16 یا counters کے لیے u32۔i64 یا String رہتی ہیں۔ chrono یا time types پر جانے کے لیے ان crates کے serde features فعال کرنے ہوں گے۔serde_json::Value استعمال کرنے والا آؤٹ پٹ پورا path لکھتا ہے، اس لیے اضافی use کی ضرورت نہیں، لیکن serde_json dependency ضروری ہے۔#[serde(rename_all = "camelCase")] کے بجائے ہر فیلڈ پر الگ ہوتا ہے۔ اگر keys ایک ہی رواج پر چلتی ہیں تو آپ انہیں خود سمیٹ سکتے ہیں۔"level": "warn" جیسے مقررہ values والے فیلڈز بعد میں enum بنانے کے اچھے امیدوار ہیں۔#[serde(default)] بھی کیوں ملتا ہے؟serde غائب Option کو پہلے ہی None سے بھر دیتا ہے، لیکن واضح default کی بدولت اگر آپ بعد میں type کو Vec<T> جیسی کسی چیز میں بدلیں تو بھی غائب keys قبول ہوتی رہتی ہیں۔ skip_serializing_if واپس JSON لکھتے وقت None فیلڈز چھوڑ دیتا ہے، جس سے اصل شکل برقرار رہتی ہے۔
دونوں Option<T> بنتے ہیں، لیکن صرف ان فیلڈز کو default اور skip_serializing_if attributes ملتے ہیں جن کی key غائب ہو سکتی ہے۔ ہمیشہ موجود لیکن کبھی کبھی null والا فیلڈ واپس null کے طور پر لکھا جاتا ہے۔
&str فیلڈز اور 'de lifetime کے ساتھ borrow کیوں نہیں؟zero-copy فیلڈز (&'a str) ان پٹ buffer سے زیادہ دیر زندہ نہیں رہ سکتے، جو عام response handling میں الجھن پیدا کرتا ہے۔ owned String ڈیفالٹ ہے؛ اگر performance اہم ہو تو زیادہ استعمال ہونے والے فیلڈز کو Cow<'a, str> کر دیں۔
Default یا PartialEq derives شامل کر سکتا ہوں؟آؤٹ پٹ صرف Debug، Clone، Serialize اور Deserialize derive کرتا ہے۔ جب تمام فیلڈ types انہیں سپورٹ کریں تو derive فہرست میں مزید خود شامل کریں (serde_json::Value، PartialEq implement کرتا ہے)۔