تنزيل struct2json - تنزيل كود المصدر struct2json

struct2json

كود مصدر C#

1.0.0

تنزيل

هيكل C ومكتبة التحويل البيني السريع JSON

struct2json

struct2json عبارة عن بنية C مفتوحة المصدر ومكتبة JSON للتحويل السريع، ويمكنها تحقيق متطلبات التسلسل وإلغاء التسلسل بين كائنات البنية وكائنات JSON بسرعة. يعمل تصميم واجهة برمجة التطبيقات السريع والموجز على تقليل تعقيد التعليمات البرمجية بشكل كبير عند الاستخدام المباشر لمكتبة تحليل JSON لتنفيذ مثل هذه الوظائف.

أصل

يعد تطبيق التصميم الموجه للكائنات على لغة C فكرة تصميم شائعة جدًا في الوقت الحالي. نظرًا لعدم وجود فئات في لغة C، يتم استخدام struct البنية بشكل عام كفئة، ومتغيرات البنية عبارة عن كائنات. بعد الحصول على كائن، غالبًا ما تحتاج إلى التفكير في تسلسل الكائن وإلغاء تسلسله. على عكس العديد من اللغات عالية المستوى، تتمتع لغة C بآليات مثل الانعكاس، بحيث يتم دعم تسلسل الكائنات وإلغاء التسلسل محليًا.

بالنسبة للغة C، يعد إجراء التسلسل إلى سلاسل JSON خيارًا جيدًا، لذلك يتعين عليك استخدام مكتبة تحليل JSON مثل cJSON، ومع ذلك، فإن الكود بعد الاستخدام زائد عن الحاجة وله منطق ضعيف، لذلك توصلت إلى تغليف ثانوي لـ cJSON. مكتبة لتنفيذ مكتبة للتحويل السريع بين البنية وJSON. هذا هو المكان الذي ولد فيه struct2json. فيما يلي سيناريوهات الاستخدام الرئيسية لـ struct2json:

الثبات : بعد تسلسل كائن الهيكل إلى كائن JSON، يمكن حفظه مباشرة في ملف أو فلاش لتحقيق تخزين انقطاع التيار الكهربائي لكائن الهيكل؛
الاتصال : تعد اللغات عالية المستوى صديقة جدًا لدعم JSON، على سبيل المثال: تتمتع Javascript وGroovy بدعم أصلي لـ JSON، لذلك يمكن أيضًا استخدام JSON كتنسيق بروتوكول اتصال وتنسيق نقل الكائنات بين لغة C وبرامج اللغة الأخرى؛
التصور : يمكن عرض الكائنات المتسلسلة في JSON على وحدة التحكم أو واجهة المستخدم بشكل أكثر سهولة، ويمكن استخدامها في تصحيح أخطاء المنتج والتطوير الثانوي للمنتج وسيناريوهات أخرى؛

كيفية الاستخدام

أعلن الهيكل

تم الإعلان عن مبنيين على النحو التالي. هيكل Hometown هو البنية التحتية للهيكل Student

 /* 籍贯 */
typedef struct {
    char name [ 16 ];
} Hometown ;

/* 学生 */
typedef struct {
    uint8_t id ;
    uint8_t score [ 8 ];
    char name [ 10 ];
    double weight ;
    Hometown hometown ;
} Student ;

تسلسل كائن الهيكل إلى كائن JSON

قبل الاستخدام (الملف المصدر)	بعد الاستخدام (الملف المصدر)

قم بإلغاء تسلسل كائنات JSON إلى كائنات هيكلية

قبل الاستخدام (الملف المصدر)	بعد الاستخدام (الملف المصدر)

ميزات جديدة في الإصدار V2.0 [yuxuebao]

1) قم بتحديث مكتبة cJSON إلى الإصدار 1.7.12، وقم بتوسيع التنفيذ لدعم بيانات النوع int64 (طويلة طويلة). ملاحظة: تتم معالجة نوع int64 الأصلي لـ cJSON في الوضع المزدوج. إذا تجاوز 16 بت، فسيكون هناك فقدان للدقة.

2) قم بتوسيع وظيفة struct2json وإضافة دعم لأعضاء البنية المراد تضمينها في البنية وأعضاء المصفوفة المراد تضمينها.

3) أضف برنامج Python النصي الذي يقوم تلقائيًا بإنشاء بنية struct2json وأكواد تحويل JSON، ويدعم استخراج تعريفات البنية من ملف الرأس، ويقوم تلقائيًا بإنشاء رموز تحويل البنية وJSON بناءً على تعريفات البنية، ويوفر الأمثلة ذات الصلة.

تعليمات V2.0 للاستخدام:

1) استخراج تعريف الهيكل:

	将头文件（eg:mc_usr_def.h）放在demoinc目录下；
	执行generate_struct_defination.py，生成struct_defination.txt；

2) إنشاء هيكل ورمز تحويل JSON:

	执行generate_s2j_code.py，根据结构体定义自动生成结构体与JSON互转代码：my_struct_2_json.c,my_struct_2_json.h；
	该脚本支持的参数类型有 基本类型 和 结构体类型，enum和指针按int处理，不支持union和位域；
	支持的数组类型:支持基本类型一维数组，结构体一维数组，字符二维数组（字符串数组）

3) هيكل الاختبار وتحويل JSON:

	cd demo
	编译测试代码，gcc ../cJSON/cJSON.c ../struct2json/src/*.c ./*.c -I ../cJSON/ -I ../struct2json/inc/ -lm -DDEBUGS2J  -g -o tests2j
	测试 ./tests2j 
	查看output输出和生成的JSON样例文件struct_defination.json；
	预期输出：*:strcmp:0     *:strcmp:0

*:json_cmp:1

مرحبًا بالجميع في طلب الشوكة والسحب (Github|OSChina|Coding). إذا كنت تعتقد أن هذا المشروع مفتوح المصدر رائع، فيمكنك النقر فوق "نجمة" في الزاوية اليمنى العليا من الصفحة الرئيسية للمشروع والتوصية به لمزيد من الأصدقاء المحتاجين.