مبادئ التسلسل: ترجمة البيانات

🎯 السؤال الأساسي

كيف تنتقل البيانات عبر الشبكة؟ هذا مثل السؤال: كلام شخص، كيف يجعله شخص آخر يفهم؟ التسلسل يحل مشكلة "ترجمة البيانات" - تحويل الكائنات في الذاكرة إلى تنسيق يمكن نقله.

---

ضرورة تسلسل البيانات

في عملية التفاعل بين الواجهة الأمامية والخلفية، تحتاج البيانات إلى المرور بعدة "تحولات" لتنتقل من الخادم إلى العميل.

السيناريو الأول: البيانات التي تصل للواجهة الأمامية "تغيرت"

// الخلفية ترسل
Date birth = new Date(1990, 5, 15)

// الواجهة الأمامية تستقبل
{ "birth": "1990-06-15T00:00:00Z" }  // نص!

الواجهة الأمامية تريد استخدام .getFullYear()، لكنها تحصل على خطأ - لأن هذا ليس كائن Date، بل نص.

السيناريو الثاني: تشوه الأحرف الصينية

// المتوقع
{ "name": "张三" }

// المستلم فعليًا
{ "name": "å¼ ä¸" }

مشكلة ترميز الأحرف تؤدي إلى تشوه النص الصيني.

السيناريو الثالث: عنق زجاجة الأداء

// استجابة تحتوي على 10000 منتج
{
  "products": [
    { "id": 1, "name": "...", "description": "...", ... },
    // ... 9999 المزيد
  ]
}
// الحجم: 5.2 MB، وقت النقل: 3.5 ثانية

تكرار تنسيق JSON يؤدي إلى حزمة بيانات كبيرة جدًا، مما يؤثر بشدة على الأداء.

---

التسلسل مثل "الترجمة" - "ترجمة" كائنات الذاكرة إلى تنسيق يمكن نقله، والطرف المستقبل "يترجمها" مرة أخرى.

---

1. نظرة عامة على التسلسل/إلغاء التسلسل

التسلسل (Serialization) هو عملية تحويل الكائنات إلى تنسيق قابل للنقل.

إلغاء التسلسل (Deserialization) هو عملية استعادة التنسيق المنقول إلى كائن.

1.1 التشبيه بإرسال طرد

إرسال طرد	التسلسل	الوصف
تغليف العناصر	تسلسل	وضع العناصر في صندوق، لصق الملصق
النقل	نقل الشبكة	شاحنة البريد توصل للوجهة
فتح الطرد واستلام العناصر	إلغاء التسلسل	المستلم يفتح الصندوق، يخرج العناصر

1.2 الدافع وراء نحتاج التسلسل

السبب	الوصف	مثال
نقل الشبكة	الشبكة تنقل فقط تدفقات البايت	استدعاء API، اتصال RPC
تخزين دائم	القرص يخزن فقط بايتات	حفظ الكائنات في ملف، قاعدة بيانات
عبر اللغات	هياكل البيانات تختلف بين اللغات	كائن Java → قاموس Python
تخزين مؤقت موزع	Redis/Memcached تخزن بايتات	تخزين معلومات المستخدم مؤقتًا

---

2. تنسيقات التسلسل الشائعة

👇 جرب بنفسك: انقر على الزر أدناه، ولاحظ عملية التسلسل في لغات مختلفة:

🔄Serialization Demo

📦In-memory object

const user = {
  id: 123,
  name: "Alice",
  email: "alice@example.com",
  age: 28
};

An object in memory, usable only by the current process

Serialize

{}JSON string68 bytes

{
  "id": 123,
  "name": "Alice",
  "email": "alice@example.com",
  "age": 28
}

Can be sent over the network and used across languages

Transfer

💻Binary52 bytes

Hex encoding (MessagePack):
\xa7 id 7b
\xa4 name \xa5 Alice
\xa5 email \xb1 alice@example.com
\xa3 age 1c

Protobuf/MessagePack, smaller and faster

📊 Format comparison

Format

Size

Speed

Readability

Cross-language

JSON

★★★☆☆

★★★☆☆

★★★★★

★★★★★

XML

★★☆☆☆

★★☆☆☆

★★★★★

★★★★★

Protobuf

★★★★★

★★★★★

★☆☆☆☆

★★★★☆

MessagePack

★★★★☆

★★★★☆

★★☆☆☆

★★★★★

2.1 JSON: الأكثر عمومية

المزايا:

• قابلية قراءة جيدة، سهولة التصحيح
• جميع اللغات تدعمه
• المتصفح يدعمه أصلاً (JSON.parse / JSON.stringify)

العيوب:

• حجم كبير (يحتوي الكثير من علامات {} "")
• لا يدعم أنواع البيانات الغنية (Date، Map، Set تتحول إلى نصوص)

السيناريوهات المناسبة:

• API العامة
• التواصل بين الواجهة الأمامية والخلفية
• ملفات التكوين

2.2 XML: كان سائدًا سابقًا

<?xml version="1.0" encoding="UTF-8"?>
<user>
  <id>123</id>
  <name>张三</name>
  <email>zhangsan@example.com</email>
  <age>28</age>
</user>

المزايا:

• هيكل واضح، يدعم التعليقات
• يدعم الهياكل المتداخلة المعقدة
• يوجد تحقق Schema (XSD)

العيوب:

• حجم كبير، تحليل بطيء
• تكرار الوسوم (<open></close>)

السيناريوهات المناسبة:

• ملفات التكوين (Spring، MyBatis)
• بروتوكول SOAP
• تبادل بيانات معقدة

2.3 Protobuf: الأكثر كفاءة

// user.proto
syntax = "proto3";
message User {
  int32 id = 1;
  string name = 2;
  string email = 3;
  int32 age = 4;
}

المزايا:

• حجم صغير (أصغر من JSON بـ 30-50%)
• سرعة عالية (تحليل أسرع 5-10 مرات)
• توافق مع الإصدارات السابقة (إضافة حقول جديدة لا تؤثر على الإصدارات القديمة)

العيوب:

• غير قابل للقراءة (تنسيق ثنائي)
• يحتاج ملف .proto للتعريف
• لا يدعم الأنواع الديناميكية

السيناريوهات المناسبة:

• اتصال الخدمات المصغرة الداخلي
• سيناريوهات عالية الأداء (ألعاب، اتصال فوري)
• تطبيقات الجوال (توفير البيانات)

2.4 MessagePack: توازن بين القراءة والأداء

// MessagePack هو نسخة ثنائية من JSON
// نفس البيانات، MessagePack أصغر من JSON بحوالي 30%

المزايا:

• أصغر من JSON، أسرع من JSON
• يحافظ على نموذج بيانات JSON
• يدعم جميع أنواع JSON

العيوب:

• غير قابل للقراءة
• ليس بنفس كفاءة Protobuf

السيناريوهات المناسبة:

• تحتاج أداء لكن لا تريد استخدام Protobuf
• تخزين Redis المؤقت
• رسائل WebSocket

---

3. مقارنة طرق التسلسل في اللغات المختلفة

اللغة	مكتبة JSON	مكتبة Protobuf	مكتبة XML
JavaScript	JSON.stringify()	protobuf.js	fast-xml-parser
Python	json.dumps()	protobuf	xmltodict
Java	Jackson / Gson	protobuf-java	JAXB
Go	encoding/json	proto	encoding/xml
C++	nlohmann/json	protobuf	tinyxml2
C#	System.Text.Json	Google.Protobuf	System.Xml

💡 نصيحة الاختيار

• التواصل بين الواجهة الأمامية والخلفية: JSON (سهولة التصحيح)
• داخل الخدمات المصغرة: Protobuf (أداء مثالي)
• ملفات التكوين: JSON أو YAML
• التواصل مع أنظمة قديمة: XML (قد لا يكون هناك خيار آخر)

---

4. مقارنة الأداء

4.1 مقارنة الحجم (باستخدام كائن مستخدم كمثال)

التنسيق	الحجم	نسبة إلى JSON
JSON	68 bytes	100%
XML	142 bytes	209%
Protobuf	38 bytes	56%
MessagePack	52 bytes	76%

4.2 مقارنة السرعة (تسلسل 10000 مرة)

التنسيق	الوقت	نسبة إلى JSON
JSON	45 ms	100%
XML	120 ms	267%
Protobuf	8 ms	18%
MessagePack	28 ms	62%

💡 استنتاجات اختبار الأداء

• Protobuf الأسرع: مناسب للسيناريوهات عالية الأداء
• MessagePack الثاني: أسرع من JSON بحوالي 40%
• JSON الأبطأ: لكنه كافٍ لمعظم السيناريوهات

---

5. المشكلات الشائعة

5.1 مشكلة تسلسل التاريخ

المشكلة: كائن Date بعد التسلسل يصبح نصًا

// قبل التسلسل
const date = new Date('2024-01-01')

// بعد التسلسل
JSON.stringify(date)  // "2024-01-01T00:00:00.000Z"

الحلول:

// الحل 1: التحويل إلى طابع زمني
{ createdAt: date.getTime() }  // 1704067200000

// الحل 2: التحويل إلى نص ISO
{ createdAt: date.toISOString() }  // "2024-01-01T00:00:00.000Z"

// الحل 3: تسلسل مخصص
JSON.stringify(obj, (key, value) => {
  if (value instanceof Date) {
    return { __type: 'Date', value: value.toISOString() }
  }
  return value
})

5.2 مشكلة المرجع الدائري

المشكلة: المرجع الدائري للكائن يسبب خطأ

const obj = { name: 'test' }
obj.self = obj
JSON.stringify(obj)  // TypeError: Converting circular structure to JSON

الحلول:

// الحل 1: تصفية المراجع الدائرية
const seen = new WeakSet()
JSON.stringify(obj, (key, value) => {
  if (typeof value === 'object' && value !== null) {
    if (seen.has(value)) return
    seen.add(value)
  }
  return value
})

// الحل 2: استخدام مكتبة flatted
import { parse, stringify } from 'flatted'
stringify(obj)  // معالجة تلقائية للمراجع الدائرية

5.3 مشكلة تشوه الأحرف الصينية

المشكلة: النص الصيني يتشوه بعد التسلسل

السبب:

• عدم تطابق ترميز الأحرف (UTF-8 مقابل GBK)
• علامة BOM

الحلول:

# Python ضمان استخدام UTF-8
import json
json.dumps(data, ensure_ascii=False)  # عدم ترميز الأحرف الصينية

// Node.js تعيين رأس الاستجابة
res.setHeader('Content-Type', 'application/json; charset=utf-8')

---

6. تطبيق عملي: حل تسلسل نظام التجارة الإلكترونية

6.1 تحليل السيناريو

السيناريو	اختيار التنسيق	السبب
App → API الخلفية	JSON	سهولة التصحيح، توحيد الواجهة الأمامية والخلفية
الخلفية → الخلفية RPC	Protobuf	أداء مثالي، توفير البيانات
تخزين Redis المؤقت	MessagePack	أصغر من JSON، يمكنه تسلسل كائنات معقدة
تسجيل السجلات	JSON	سهولة تحليل أدوات تحليل السجلات

6.2 مثال كود

// استجابة API (JSON)
app.get('/api/products/:id', async (req, res) => {
  const product = await db.getProduct(req.params.id)
  res.json({
    code: 0,
    data: product
  })
})

// اتصال الخدمات المصغرة (Protobuf)
// product.proto
syntax = "proto3";
message Product {
  int32 id = 1;
  string name = 2;
  int32 price = 3;
}

// الخادم
const proto = require('./product.proto')
const message = proto.Product.create(product)
const buffer = proto.Product.encode(message).finish()

// العميل
const decoded = proto.Product.decode(buffer)

// تخزين Redis المؤقت (MessagePack)
const msgpack = require('msgpack-lite')
await redis.set(
  `product:${id}`,
  msgpack.encode(product)
)
const cached = msgpack.decode(await redis.get(`product:${id}`))

---

7. استخدام الذكاء الاصطناعي للمساعدة في اختيار حل التسلسل

يمكن للذكاء الاصطناعي مساعدتك في اختيار تنسيق التسلسل المناسب حسب السيناريو.

7.1 قالب التلميح

أنت مهندس معماري خبير في أنظمة البرمجيات، متقن لتقنيات تسلسل البيانات. الرجاء مساعدتي في اختيار حل التسلسل المناسب.

## سيناريو العمل
[صف سيناريو عملك، مثل: تطبيق تجارة إلكترونية، خادم ألعاب، خدمات مصغرة إلخ]

## المتطلبات التقنية
[اذكر القيود، مثل:
- فصل الواجهة الأمامية والخلفية (Vue + Node.js)
- متطلبات أداء عالية (QPS > 10000)
- حساسية البيانات (تطبيق جوال، يحتاج توفير البيانات)
- يحتاج عبر اللغات (Java + Python + Go)]

## خصائص البيانات
[صف خصائص البيانات، مثل:
- حجم بيانات كبير (استجابة واحدة > 1MB)
- هيكل معقد (تداخل متعدد المستويات)
- تحتوي أنواع خاصة مثل التاريخ والبيانات الثنائية]

## تنسيق الإخراج
الرجاء الإخراج بالتنسيق التالي:
1. الحل الموصى به (JSON/Protobuf/MessagePack/XML)
2. شرح الأسباب
3. مقارنة الأداء (تقدير الحجم والسرعة)
4. مثال كود

7.2 مثال عملي

إدخال التلميح:

أنت مهندس معماري خبير. تطبيق التجارة الإلكترونية لدينا يحتاج تحسين أداء واجهة قائمة المنتجات.

## سيناريو العمل
- واجهة قائمة منتجات تطبيق التجارة الإلكترونية
- استجابة واحدة تعيد 100 منتج
- كل منتج يحتوي: id, name, price, image, description إلخ 20 حقلاً
- حاليًا نستخدم JSON، حجم الاستجابة حوالي 200KB، الوقت 800ms

## المتطلبات التقنية
- الواجهة الأمامية Vue.js
- الخلفية Node.js + Go خدمات مصغرة
- يحتاج مراعاة الأداء وكفاءة التطوير

## أهداف التحسين
- تقليل وقت الاستجابة إلى أقل من 300ms
- تقليل حجم حزمة البيانات بنسبة 30%

إخراج الذكاء الاصطناعي:

الحل الموصى به: حل مختلط

1. **طبقة API**: الاستمرار في استخدام JSON (مناسب للواجهة الأمامية)
2. **اتصال الخدمات المصغرة**: التبديل إلى Protobuf (تحسين الأداء)
3. **البيانات الثابتة**: تفعيل ضغط gzip

### شرح الأسباب
- JSON الأكثر ملاءمة للواجهة الأمامية، لا يحتاج تحليل إضافي
- خدمات الخلفية المصغرة تستخدم Protobuf، يمكن تقليل حجم البيانات بنسبة 40%
- ضغط gzip فعال جدًا للنصوص (JSON يمكن ضغطه بنسبة 70%)

### مقارنة الأداء
| الحل | الحجم | الوقت |
|------|------|------|
| الحالي (JSON) | 200 KB | 800 ms |
| + gzip | 60 KB | 350 ms |
| + Protobuf | 50 KB | 280 ms |

### مثال كود
[كود التنفيذ المحدد...]

---

جدول المصطلحات

المصطلح	الإنجليزية	الشرح
التسلسل	Serialization	كائن → تدفق بايتات
إلغاء التسلسل	Deserialization	تدفق بايتات → كائن
JSON	JavaScript Object Notation	تنسيق النص الأكثر استخدامًا
XML	Extensible Markup Language	لغة ترميز، كانت سائدة
Protobuf	Protocol Buffers	تنسيق فعال مفتوح المصدر من Google
MessagePack	-	النسخة الثنائية من JSON
الترميز	Encoding	حرف → بايت
فك الترميز	Decoding	بايت → حرف