How do you work with JSON data in Dart?

Working with JSON data in Dart primarily involves two steps: parsing and serialization. Dart provides built-in support for handling JSON data via the standard library's dart:convert. Below is a detailed step-by-step guide with examples on how to work with JSON data in Dart.

1. Importing the dart:convert Library

First, import the Dart dart:convert library, which provides the necessary tools for handling JSON.

dart
import 'dart:convert';

2. JSON Parsing

Parsing involves converting a JSON-formatted string into a Dart Map or List. This can be achieved using the jsonDecode() function.

Example:

Suppose we have a JSON string representing user information:

json
{
  "name": "张三",
  "age": 30,
  "email": "zhangsan@example.com"
}

In Dart, you can parse it as follows:

dart
String jsonString = '{"name": "张三", "age": 30, "email": "zhangsan@example.com"}';
Map<String, dynamic> user = jsonDecode(jsonString);

print('Name: ${user['name']}');
print('Age: ${user['age']}');
print('Email: ${user['email']}');

3. JSON Serialization

Serialization involves converting Dart objects (such as Maps or Lists) into JSON strings. This can be achieved using the jsonEncode() function.

Example:

To convert a Dart object back to a JSON string, you can do:

dart
Map<String, dynamic> user = {
  "name": "张三",
  "age": 30,
  "email": "zhangsan@example.com"
};

String jsonString = jsonEncode(user);
print(jsonString); // Outputs the JSON string

4. Handling Complex and Custom Objects

For more complex or custom objects, you may need to implement custom serialization and deserialization logic. This typically involves defining fromJson and toJson methods.

Example:

Define a User class and implement custom serialization and deserialization:

dart
class User {
  String name;
  int age;
  String email;

  User(this.name, this.age, this.email);

  // Create a User object from JSON
  factory User.fromJson(Map<String, dynamic> json) {
    return User(
      json['name'] as String,
      json['age'] as int,
      json['email'] as String,
    );
  }

  // Convert a User object to JSON
  Map<String, dynamic> toJson() {
    return {
      'name': name,
      'age': age,
      'email': email,
    };
  }
}

// Usage
String jsonString = '{"name": "张三", "age": 30, "email": "zhangsan@example.com"}';
User user = User.fromJson(jsonDecode(jsonString));
String jsonOutput = jsonEncode(user.toJson());
print(jsonOutput);

Through the above methods, you can effectively work with JSON data in Dart, whether parsing or serializing, with clear steps and flexible handling.