struct2json Télécharger - struct2json Téléchargement du code source

struct2json

Code source C#

1.0.0

Télécharger

Structure C et bibliothèque d'interconversion rapide JSON

struct2json

struct2json est une bibliothèque de structure C open source et d'interconversion rapide JSON qui peut rapidement répondre aux exigences de sérialisation et de désérialisation entre les objets de structure et les objets JSON . La conception rapide et concise de l'API réduit considérablement la complexité du code liée à l'utilisation directe de la bibliothèque d'analyse JSON pour implémenter de telles fonctions.

origine

L’application de la conception orientée objet au langage C est une idée de conception très populaire à l’heure actuelle. Puisqu'il n'y a pas de classes dans le langage C, la structure struct est généralement utilisée comme classe et les variables de structure sont des objets. Après avoir obtenu un objet, vous devez souvent envisager la sérialisation et la désérialisation de l'objet. Contrairement à de nombreux langages de haut niveau, le langage C dispose de mécanismes tels que la réflexion, de sorte que la sérialisation et la désérialisation des objets sont prises en charge de manière native.

Pour le langage C, la sérialisation en chaînes JSON est un bon choix, vous devez donc utiliser une bibliothèque d'analyse JSON telle que cJSON. Cependant, le code après utilisation est redondant et a une mauvaise logique, j'ai donc proposé une encapsulation secondaire du cJSON. bibliothèque à implémenter Une bibliothèque pour une conversion rapide entre struct et JSON. C'est là que struct2json est né. Voici les principaux scénarios d'utilisation de struct2json :

Persistance : une fois que l'objet de structure est sérialisé en un objet JSON, il peut être directement enregistré dans un fichier ou Flash pour réaliser un stockage hors tension de l'objet de structure ;
Communication : Les langages de haut niveau sont très compatibles avec la prise en charge de JSON. Par exemple : Javascript et Groovy prennent en charge nativement JSON, donc JSON peut également être utilisé comme format de protocole de communication et format de transfert d'objets entre le langage C et d'autres logiciels de langage ;
Visualisation : les objets sérialisés en JSON peuvent être affichés sur la console ou l'interface utilisateur de manière plus intuitive et peuvent être utilisés dans le débogage du produit, le développement secondaire du produit et d'autres scénarios ;

Comment utiliser

Déclarer la structure

Deux structures sont déclarées comme suit. La structure Hometown est une sous-structure de la structure Student

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

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

Sérialiser l'objet de structure en objet JSON

Avant utilisation (fichier source)	Après utilisation (fichier source)

Désérialiser les objets JSON en objets de structure

Avant utilisation (fichier source)	Après utilisation (fichier source)

Nouvelles fonctionnalités de la version V2.0 [yuxuebao]

1) Mettez à jour la bibliothèque cJSON vers la version 1.7.12 et développez l'implémentation pour prendre en charge les données de type int64 (long long). PS : Le type int64 original de cJSON est traité en mode double s'il dépasse 16 bits, il y aura une perte de précision.

2) Développez la fonction struct2json et ajoutez la prise en charge des membres de la structure à inclure dans la structure et des membres du tableau à inclure.

3) Ajoutez un script Python qui génère automatiquement la structure struct2json et les codes de conversion JSON, prend en charge l'extraction des définitions de structure du fichier d'en-tête, génère automatiquement la structure et les codes de conversion JSON en fonction des définitions de structure, et fournit des exemples pertinents.

V2.0 Mode d'emploi :

1) Extraire la définition de la structure :

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

2) Générer la structure et le code de conversion JSON :

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

3) Structure de test et conversion 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

Bienvenue à tous pour fork et pull request (Github | OSChina | Coding). Si vous pensez que ce projet open source est génial, vous pouvez cliquer sur Étoile dans le coin supérieur droit de la page d'accueil du projet et le recommander à davantage d'amis dans le besoin.