JSON কে Rust struct-এ রূপান্তর করুন!

JSON দিন এবং nested object সহ Rust struct কোড তৈরি করুন! serde Serialize, Deserialize, #[serde(rename)] সমর্থিত।
JSON
ফলাফল
 

JSON কে Rust struct-এ রূপান্তর করুন!

একটি 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 লিখলে এটি একটি শুরুর বিন্দু।

কীভাবে ব্যবহার করবেন

  1. JSON পেস্ট করুন। কয়েকটি আইটেমসহ array দিলে ঐচ্ছিক ফিল্ড শনাক্ত করতে সুবিধা হয়।
  2. টাইপের নাম-এ top-level struct-এর নাম দিন (যেমন AccessLog)।
  3. আউটপুটটি একটি .rs ফাইলে পেস্ট করুন এবং Cargo.toml-এ serde (derive ফিচারসহ) আর serde_json যোগ করুন।
  4. serde_json::from_str::<AccessLog>(&body)? বা resp.json::<AccessLog>().await? দিয়ে ব্যবহার করুন।

উদাহরণ

ইনপুট (JSON)
{
  "timestamp": 1714550400,
  "level": "warn",
  "type": "http_request",
  "status": 503,
  "latency_ms": 1250.7,
  "headers": [{ "name": "user-agent", "value": "curl/8.4" }],
  "trace_id": null
}
আউটপুট (Rust · serde)
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>।

সমর্থিত বৈশিষ্ট্য

  • প্রতিটি struct-এ #[derive(Debug, Clone, Serialize, Deserialize)] আর pub ফিল্ড।
  • Key যখন snake_case ফিল্ডের নাম থেকে আলাদা, তখন ফিল্ড-প্রতি #[serde(rename = "originalKey")]।
  • কিছু আইটেমে না থাকা ফিল্ড: #[serde(default, skip_serializing_if = "Option::is_none")]-সহ Option<T>।
  • সবসময় থাকে কিন্তু মাঝে মাঝে null এমন ফিল্ড: অ্যাট্রিবিউট ছাড়া সাধারণ Option<T>।
  • Type: integer-এর জন্য i64, দশমিকের জন্য f64, bool, String, Vec<T>, আর মিশ্র type-এর জন্য serde_json::Value।
  • type, match বা ref-এর মতো keyword key-এর শেষে আন্ডারস্কোর যোগ হয় (type_)।
  • Top-level array থেকে pub type Root = Vec<RootItem>; তৈরি হয়।

ব্যবহারের ক্ষেত্র

reqwest-এর টাইপড response

["status"].as_i64()-এর মতো serde_json::Value lookup-কে resp.json::<AccessLog>() দিয়ে বদলান, যাতে ভুল বানানের ফিল্ড কম্পাইলের সময়েই ধরা পড়ে।

axum বা actix-web-এ request body

ক্লায়েন্টের পাঠানো JSON থেকে struct তৈরি করে Json(payload): Json<CreateOrder> হিসেবে গ্রহণ করুন; ফিল্ড না থাকা বা ভুল type-এর request আপনার handler কোড চলার আগেই ফ্রেমওয়ার্ক প্রত্যাখ্যান করে।

JSON Lines লগ বিশ্লেষণের CLI

একটি লগ লাইন থেকে struct তৈরি করুন, তারপর BufReader::lines() থেকে প্রতিটি লাইন deserialize করে কয়েক লাইনেই ফিল্ড-ভিত্তিক aggregation টুল পেয়ে যান।

নোট ও সীমাবদ্ধতা

  • Integer যত ছোটই হোক সবসময় i64। পরিসীমা জানা থাকলে নিজে সংকুচিত করুন, যেমন u16 status code বা u32 counter।
  • Timestamp আর তারিখের স্ট্রিং i64 বা String থাকে। chrono বা time type-এ যেতে ওই crate-গুলোর serde ফিচার চালু করতে হয়।
  • serde_json::Value ব্যবহার করা আউটপুট পুরো path লেখে, তাই বাড়তি use লাগে না, কিন্তু serde_json dependency লাগে।
  • Rename হয় ফিল্ড-প্রতি, struct-স্তরের #[serde(rename_all = "camelCase")] হিসেবে নয়। Key-গুলো একটি রীতি মানলে নিজে সেগুলো একত্রিত করতে পারেন।
  • Tagged enum তৈরি হয় না। "level": "warn"-এর মতো নির্দিষ্ট কিছু ভ্যালুর ফিল্ড পরে enum বানানোর ভালো প্রার্থী।

সাধারণ প্রশ্ন

ঐচ্ছিক ফিল্ড কেন #[serde(default)]-ও পায়?

serde অনুপস্থিত Option-কে এমনিতেই None দিয়ে পূরণ করে, কিন্তু স্পষ্ট default থাকলে পরে type বদলে Vec<T>-এর মতো কিছু করলেও অনুপস্থিত key গ্রহণ করা চলতে থাকে। skip_serializing_if আবার JSON লেখার সময় None ফিল্ড বাদ দেয়, ফলে মূল আকৃতি বজায় থাকে।

আউটপুটে null হতে পারে এমন আর অনুপস্থিত ফিল্ডের পার্থক্য কী?

দুটোই 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 ইমপ্লিমেন্ট করে)।