عن المشروع

# الصفحة الرئيسية لمشروع جاكسون هذه هي البوابة الرئيسية لمشروع جاكسون، وهي مجموعة أدوات معالجة بيانات لمنصة جافا وJVM. يُعرف جاكسون على نطاق واسع بأنه "مكتبة جافا للـJSON" أو "أفضل محلل JSON لجافا"، لكنه يتجاوز JSON لدعم العديد من صيغ البيانات الأخرى. ## نظرة عامة يوفر جاكسون: - **محلل/مولد JSON تدفقي** (jackson-core): واجهة برمجة منخفضة المستوى وعالية الأداء - **ربط البيانات** (jackson-databind): تسلسل/إلغاء تسلسل كائنات POJO من/إلى JSON - **التعليقات التوضيحية** (jackson-annotations): تعليقات توضيحية قياسية للتحكم في التسلسل - **وحدات صيغ البيانات**: دعم لـ Avro وCBOR وCSV وIon وProtobuf وSmile وTOML وYAML والمزيد - **وحدات أنواع البيانات**: دعم لأنواع Java 8 وGuava وJoda-Time والعديد من المكتبات الخارجية - **وحدات لغات JVM**: Kotlin وScala وغيرها ## إدارة الإصدارات - **1.x** (`org.codehaus.jackson`): مُهجَّر، لا توجد إصدارات جديدة - **2.x** (`com.fasterxml.jackson.core`): ناضج ومستخدم على نطاق واسع، مع فروع دعم طويل الأمد (مثل 2.18 و2.21) - **3.x** (`tools.jackson`): قيد التطوير النشط، موصى به للمشاريع الجديدة تستخدم الإصدارات الرئيسية حزم Java مختلفة ومعرفات Maven مختلفة، لذا يمكن أن تتعايش في نفس المشروع دون تعارض. ## الوحدات الأساسية - **jackson-core**: واجهة برمجة تدفقية، تنفيذ خاص بـ JSON - **jackson-databind**: ربط البيانات وتسلسل الكائنات، يعتمد على التدفق والتعليقات التوضيحية - **jackson-annotations**: تكوين قائم على التعليقات التوضيحية - **jackson-bom**: قائمة مواد لإدارة إصدارات متسقة ## وحدات صيغ البيانات الصيغ المدعومة بالكامل تشمل: - **Avro**: صيغة بيانات ثنائية مع دعم مخطط - **CBOR**: متغير JSON ثنائي - **CSV**: قيم مفصولة بفواصل - **Ion**: صيغة Amazon Ion الثنائية - **Protobuf**: Protocol Buffers - **Smile**: JSON ثنائي، متوافق 100% مع واجهة التدفق - **TOML**: صيغة تكوين - **YAML**: صيغة بيانات قابلة للقراءة البشرية وحدات خارجية تضيف دعمًا لـ BEncode وBSON وMessagePack وRison والمزيد. ## وحدات أنواع البيانات الوحدات الرسمية تدعم: - أنواع Java 8 (Optional، التاريخ/الوقت) - مجموعات Guava - Joda-Time - JSON-P (javax.json وjakarta.json) - أنواع org.json وحدات المجتمع تضيف دعمًا لـ VAVR وApache Commons Lang وJava Money وغيرها. ## أدوات إضافية - **Afterburner**: يسرّع ربط البيانات بنسبة 30-40% عبر توليد البايت كود - **Mr Bean**: يولّد فئات تنفيذ عند الطلب - **مولّدو JSON Schema**: إنشاء JSON Schema من POJOs - **المدققات**: مدقق JSON Schema لجافا ## المجتمع والدعم يُدعم جاكسون عبر القوائم البريدية وGitter ومشكلات GitHub. يرحب المشروع بالمساهمات؛ راجع CONTRIBUTING.md للتفاصيل. يمكن الإبلاغ عن الثغرات الأمنية بشكل خاص. ## التحديثات الأخيرة - سبتمبر 2025: إضافة دليل ترقية جاكسون 3 - سبتمبر 2025: تغيير مخطط إصدار jackson-annotations في 2.20 - فبراير 2024: تدقيق أمني على وحدات صيغ/أنواع البيانات - ديسمبر 2023: إضافة دليل أسلوب البرمجة للحصول على ملاحظات الإصدار الكاملة وحالة الدعم، راجع صفحة إصدارات جاكسون على الويكي.