Automatische Generierung von Dart-Klassen aus JSON-Schema mit Templates und Reflection für effiziente Serialisierung und robuste Fehlerbehandlung.
// Notwendige Importe
import 'dart:convert';
import 'dart:io';
// Abhängigkeiten für json_serializable
// In pubspec.yaml hinzufügen:
// dependencies:
// json_annotation: ^4.8.0
// dev_dependencies:
// build_runner: ^2.3.3
// json_serializable: ^6.6.1
// Klasse, die ein Feld einer generierten Dart-Klasse repräsentiert
class Field {
final String name;
final String type;
final bool isNullable;
Field(this.name, this.type, {this.isNullable = false});
// Generiert die Felddeklaration mit Null-Safety
String declaration() {
return 'final ${type}${isNullable ? '?' : ''} $name;';
}
}
// Klasse, die eine zu generierende Dart-Klasse repräsentiert
class DartClass {
final String name;
final List<Field> fields;
DartClass(this.name, this.fields);
// Generiert den vollständigen Dart-Code für die Klasse
String generateCode() {
final buffer = StringBuffer();
// Notwendige Importe für json_serializable
buffer.writeln("import 'package:json_annotation/json_annotation.dart';");
buffer.writeln();
// Part-Direktive für generierte Datei
buffer.writeln("part '${name.toLowerCase()}.g.dart';");
buffer.writeln();
// Annotation für json_serializable
buffer.writeln('@JsonSerializable(explicitToJson: true)');
buffer.writeln('class $name {');
// Felddeklarationen
for (var field in fields) {
buffer.writeln(' ' + field.declaration());
}
buffer.writeln();
// Konstruktor
buffer.write(' $name({');
for (var field in fields) {
buffer.write('required this.${field.name}, ');
}
buffer.writeln('});\n');
// Factory fromJson
buffer.writeln(' factory $name.fromJson(Map<String, dynamic> json) => _${name}FromJson(json);');
// toJson-Methode
buffer.writeln(' Map<String, dynamic> toJson() => _${name}ToJson(this);');
buffer.writeln('}');
return buffer.toString();
}
}
// Klasse zum Parsen des JSON-Schemas und Generieren der Klassen
class SchemaParser {
final Map<String, dynamic> schema;
SchemaParser(this.schema);
// Methode zum Generieren aller Dart-Klassen aus dem JSON-Schema
List<DartClass> parse() {
final classes = <DartClass>[];
// Wir gehen davon aus, dass das Schema einen Schlüssel 'classes' hat, der eine Liste ist
if (schema['classes'] is List) {
for (var cls in schema['classes']) {
final name = cls['name'] as String?;
final fieldsRaw = cls['fields'] as List<dynamic>?;
if (name == null || fieldsRaw == null) {
throw FormatException('Klasse ohne Namen oder Felder');
}
final fields = <Field>[];
for (var f in fieldsRaw) {
final fname = f['name'] as String?;
final ftype = f['type'] as String?;
final nullable = f['nullable'] as bool? ?? false;
if (fname == null || ftype == null) {
throw FormatException('Feld ohne Namen oder Typ');
}
fields.add(Field(fname, ftype, isNullable: nullable));
}
classes.add(DartClass(name, fields));
}
} else {
throw FormatException('JSON-Schema enthält nicht die Liste classes');
}
return classes;
}
}
// Beispiel Hauptfunktion
void main(List<String> args) async {
if (args.isEmpty) {
print('Verwendung: dart generate.dart schema.json');
exit(1);
}
final schemaFile = File(args[0]);
if (!await schemaFile.exists()) {
print('Schema-Datei nicht gefunden: ${args[0]}');
exit(1);
}
final content = await schemaFile.readAsString();
final Map<String, dynamic> schemaJson = jsonDecode(content);
final parser = SchemaParser(schemaJson);
late List<DartClass> classes;
try {
classes = parser.parse();
} catch (e) {
print('Fehler beim Parsen des Schemas: $e');
exit(1);
}
// Generiere Code für jede Klasse und speichere in Datei
for (var cls in classes) {
final code = cls.generateCode();
final filename = '${cls.name.toLowerCase()}.dart';
final file = File(filename);
await file.writeAsString(code);
print('Datei generiert: $filename');
}
print('Generierung abgeschlossen. Führen Sie "flutter pub run build_runner build" aus, um die part.g.dart Dateien zu generieren');
}// Beispiel für die Verwendung des Dart-Code-Generators aus JSON-Schema
// Dieses Beispiel enthält den Originalcode und ein minimales JSON-Schema zum Testen
import 'dart:convert';
import 'dart:io';
// Originalcode beginnt hier
// Notwendige Importe
import 'dart:convert';
import 'dart:io';
// Abhängigkeiten für json_serializable
// In pubspec.yaml hinzufügen:
// dependencies:
// json_annotation: ^4.8.0
// dev_dependencies:
// build_runner: ^2.3.3
// json_serializable: ^6.6.1
// Klasse, die ein Feld einer generierten Dart-Klasse repräsentiert
class Field {
final String name;
final String type;
final bool isNullable;
Field(this.name, this.type, {this.isNullable = false});
// Generiert die Felddeklaration mit Null-Safety
String declaration() {
return 'final ${type}${isNullable ? '?' : ''} $name;';
}
}
// Klasse, die eine zu generierende Dart-Klasse repräsentiert
class DartClass {
final String name;
final List<Field> fields;
DartClass(this.name, this.fields);
// Generiert den vollständigen Dart-Code für die Klasse
String generateCode() {
final buffer = StringBuffer();
// Notwendige Importe für json_serializable
buffer.writeln("import 'package:json_annotation/json_annotation.dart';");
buffer.writeln();
// Part-Direktive für generierte Datei
buffer.writeln("part '${name.toLowerCase()}.g.dart';");
buffer.writeln();
// Annotation für json_serializable
buffer.writeln('@JsonSerializable(explicitToJson: true)');
buffer.writeln('class $name {');
// Felddeklarationen
for (var field in fields) {
buffer.writeln(' ' + field.declaration());
}
buffer.writeln();
// Konstruktor
buffer.write(' $name({');
for (var field in fields) {
buffer.write('required this.${field.name}, ');
}
buffer.writeln('});\n');
// Factory fromJson
buffer.writeln(' factory $name.fromJson(Map<String, dynamic> json) => _${name}FromJson(json);');
// toJson-Methode
buffer.writeln(' Map<String, dynamic> toJson() => _${name}ToJson(this);');
buffer.writeln('}');
return buffer.toString();
}
}
// Klasse zum Parsen des JSON-Schemas und Generieren der Klassen
class SchemaParser {
final Map<String, dynamic> schema;
SchemaParser(this.schema);
// Methode zum Generieren aller Dart-Klassen aus dem JSON-Schema
List<DartClass> parse() {
final classes = <DartClass>[];
// Wir gehen davon aus, dass das Schema einen Schlüssel 'classes' hat, der eine Liste ist
if (schema['classes'] is List) {
for (var cls in schema['classes']) {
final name = cls['name'] as String?;
final fieldsRaw = cls['fields'] as List<dynamic>?;
if (name == null || fieldsRaw == null) {
throw FormatException('Klasse ohne Namen oder Felder');
}
final fields = <Field>[];
for (var f in fieldsRaw) {
final fname = f['name'] as String?;
final ftype = f['type'] as String?;
final nullable = f['nullable'] as bool? ?? false;
if (fname == null || ftype == null) {
throw FormatException('Feld ohne Namen oder Typ');
}
fields.add(Field(fname, ftype, isNullable: nullable));
}
classes.add(DartClass(name, fields));
}
} else {
throw FormatException('JSON-Schema enthält nicht die Liste classes');
}
return classes;
}
}
// Beispiel Hauptfunktion
void main(List<String> args) async {
// Minimaler Test: JSON-Schema als String definieren
const schemaJsonString =Dart SDK >=2.17 für Reflection- und Null-Safety-Unterstützung
Abhängigkeit 'json_annotation' für JSON-Anmerkungen
Abhängigkeit 'build_runner' für Codegenerierung
Abhängigkeit 'json_serializable' für automatische Serialisierung
Dart-Template-Dateien für benutzerdefinierte Klassengenerierung
Dart-Klasse für JSON-Schema-Parsing und Codegenerierung
build.yaml-Konfiguration für build_runner
Kein Arduino-Hardware erforderlich (reine Software)
Empfohlenes IDE: Visual Studio Code oder IntelliJ IDEA mit Dart-Plugin
pubspec.yaml-Konfiguration mit Abhängigkeiten und Umgebung
Ausführungsskript zur Codegenerierung über das Terminal