نحوه استفاده از XML to Crystal
- یک نمونه XML نماینده بچسبانید، ترجیحاً با همه فیلدهای اختیاری پرشده.
- نام تایپ ریشه را تعیین کنید و تصمیم بگیرید کد کمکی هم می‌خواهید یا فقط تایپ‌ها.
- کد Crystal تولیدشده را در پروژه خود کپی کنید.
درباره XML to Crystal
نوشتن کلاس‌های مدل با دست برای یک payload بزرگ XML کسل‌کننده است و جایی است که غلط‌های تایپی رخنه می‌کنند. یک نمونه را اینجا بچسبانید و تولیدکننده ساختار را درمی‌آورد: کدام فیلدها وجود دارند، کدام شیء هستند، کدام آرایه و هر مقدار چه نوعی دارد. خروجی کلاس‌هایی است که JSON::Serializable را از کتابخانه استاندارد include می‌کنند.
XML ابتدا همان‌طور که در ابزار XML to JSON ما انجام می‌شود به JSON تبدیل می‌شود: ویژگی‌ها پیشوند @_ می‌گیرند و محتوای متنی کنار ویژگی‌ها #text نامیده می‌شود. تایپ‌های Crystal از آن نتیجه تولید می‌شوند. propertyها با ماکروی property اعلان می‌شوند و کلیدها در صورت نیاز با annotation به نام JSON::Field نگاشت می‌شوند.
استفاده از کد تولیدشده
Root.from_json(json) را برای تجزیه و to_json را برای نوشتن فراخوانی کنید.
فیلدهای اختیاری تایپ‌های union مانند String | Nil هستند.