</>مدرسه زیب‌موجیاد بگیر، تمرین کن، بساز
مدرسهKotlinدرس 16
درس 16 از 21 · ۴۰ دقیقه

فایل و JSON با kotlinx.serialization

یک مسئله واقعی را با «فایل و JSON با kotlinx.serialization» حل می‌کنیم و نتیجه را همان لحظه می‌بینیم.

۰امتیاز شما
نقشه این درس

بعد از این درس چه کاری می‌توانی انجام بدهی؟

  • @Serializable شکل داده و Json تبدیل را فراهم می‌کند؛ I/O و parse هر دو قابل شکست‌اند.
  • کد را اجرا و نتیجه را پیش‌بینی کنی
  • یک تغییر کوچک بدهی و اثرش را توضیح بدهی
  • خطای واقعی درس را بخوانی و برطرف کنی
نکته مهم برای شروع Kotlin

اگر برنامه اجرا نشد، از آخرین خط پیام خطا شروع کن؛ نام فایل و شماره خط معمولاً نزدیک‌ترین سرنخ‌اند.

چرا مهم است؟ @Serializable شکل داده و Json تبدیل را فراهم می‌کند؛ I/O و parse هر دو قابل شکست‌اند.

اولین تمرین تو: فایل را decode کن. قبل از اجرا، خروجی تازه را در یک جمله بنویس.

توضیح ساده و قدم‌به‌قدم

از یک مثال کوچک شروع کن

@Serializable شکل داده و Json تبدیل را فراهم می‌کند؛ I/O و parse هر دو قابل شکست‌اند. کد زیر را در فایل «build.gradle.kts» خودت تایپ و اجرا کن. بعد خروجی را با انتظار درس مقایسه کن.

1

۱. نمونه را اجرا کن

پیش از اجرا خروجی را حدس بزن و سپس تفاوت را یادداشت کن.

2

۲. کد را تغییر بده

فایل را decode کن.

3

۳. خطا را عمداً بساز

JSON خراب SerializationException می‌دهد؛ نسخه سالم را نگه دار. متن خطا و شماره خط را بخوان، علت را پیدا کن و فقط همان بخش را اصلاح کن.

نکته مهم

اگر برنامه اجرا نشد، از آخرین خط پیام خطا شروع کن؛ نام فایل و شماره خط معمولاً نزدیک‌ترین سرنخ‌اند.

مفهوم‌های اصلی

سه قطعه‌ای که باید بفهمی

فایل و JSON با kotlinx.serialization

@Serializable شکل داده و Json تبدیل را فراهم می‌کند؛ I/O و parse هر دو قابل شکست‌اند.

نتیجه قابل مشاهده

tasks.json و متن JSON ساخته می‌شود.

خطایی که باید بشناسی

JSON خراب SerializationException می‌دهد؛ نسخه سالم را نگه دار.

سناریوی واقعی

taskها باید JSON ذخیره و بازیابی شوند.

فرض کن taskها باید JSON ذخیره و بازیابی شوند. فعلاً قرار نیست کل برنامه را بسازیم؛ فقط همین نیاز را با چند خط کد حل می‌کنیم تا معلوم باشد هر خط چه کاری انجام می‌دهد.

کارگاه تعاملی

بررسی ساختار تمرین

این صفحه کامپایلر کامل Kotlin نیست؛ ساختار تمرین را صادقانه بررسی می‌کند و خروجی مورد انتظار را نشان می‌دهد. برای اجرای کامل به محیط رسمی همان زبان نیاز است.

build.gradle.kts
خروجیآماده
یک بخش را تغییر بده و دکمه بررسی را بزن.
بعد از هر تغییر، نتیجه را دوباره بررسی کن.
تمرین هدایت‌شده

فایل را decode کن. قبل از اجرا، خروجی تازه را در یک جمله بنویس.

دام‌های رایج

این سه اشتباه را انجام نده

1

JSON خراب SerializationException می‌دهد؛ نسخه سالم را نگه دار.

2

کپی‌کردن کد بدون اجرای مرحله‌به‌مرحله

3

تغییر چند قسمت هم‌زمان و گم‌شدن علت نتیجه

سنجش چندمرحله‌ای

با 5 سؤال مطمئن شو که مفهوم را گرفته‌ای

سؤال 1 از 5

خروجی درست این نمونه چیست؟

سؤال 2 از 5

چرا پیش از اجرا نتیجه را حدس می‌زنیم؟

سؤال 3 از 5

سرنخ خطای این درس چیست؟

سؤال 4 از 5

بعد از تغییر کد چه کنیم؟

سؤال 5 از 5

چه وقت آماده درس بعدی هستی؟

پایان درس 16

فهمیدی، تغییر دادی، نتیجه را توضیح دادی؟

فقط در این صورت درس را کامل کن و سراغ مرحله بعد برو.