用Flutter輕鬆處理JSON數據

JSON（JavaScript Object Notation）是一種輕量級的數據格式，常用於數據傳輸和存儲。在移動開發中，我們經常需要從伺服器獲取JSON數據並將其轉換為我們可以使用的對象或模型。Flutter是一款支持JSON序列化和反序列化的框架，因此，使用Flutter可以輕鬆地處理JSON數據。本文將從以下幾個方面來介紹Flutter如何處理JSON數據。

一、如何解析JSON數據

對於Flutter中JSON的解析，我們一般使用dart:convert中的json.decode()方法。使用方法非常簡單：

import 'dart:convert';

void main() {
  String jsonString = '{"name": "John", "age": 30}'; 
  Map user = json.decode(jsonString); 
  
  print('Name: ${user['name']}'); //輸出：Name: John
  print('Age: ${user['age']}'); //輸出：Age: 30
}

在上面的代碼中，我們使用json.decode()方法將JSON字元串解析為Map類型的對象，然後我們可以直接通過Map的鍵獲取值。

二、如何序列化JSON數據

在Flutter中，我們可以通過json.encode()方法將對象序列化為JSON格式的字元串。以下是一個簡單的例子：

import 'dart:convert';

void main() {
  Map user = {
    'name': 'John',
    'age': 30,
  };

  String jsonString = json.encode(user);
  print(jsonString); //輸出：{"name":"John","age":30}
}

在上面的例子中，我們使用json.encode()方法將Map類型的user對象序列化為JSON字元串。

三、如何將JSON轉換為模型類

在實際開發中，我們一般需要將JSON數據轉換成模型類，以便我們可以更方便地使用和管理數據。Flutter提供了json_serializable插件，可以幫助我們快速地生成模型類。下面是一個簡單的例子：

首先，我們需要在pubspec.yaml文件中添加以下依賴：

dependencies:
  json_annotation: ^4.3.0
  

然後，在我們要生成模型類的文件中，添加以下代碼：

import 'package:json_annotation/json_annotation.dart';

part 'user.g.dart';

@JsonSerializable()
class User {
  String name;
  int age;

  User({
    required this.name,
    required this.age,
  });

  factory User.fromJson(Map json) =>
      _$UserFromJson(json);

  Map toJson() => _$UserToJson(this);
}

在上面的代碼中，我們使用@JsonSerializable()註解來指定類可以被序列化和反序列化，然後通過@JsonKey()註解來指定JSON欄位名與類屬性名的映射關係。

接下來，我們需要運行以下命令來生成模型類：

flutter pub run build_runner build

運行成功後，將會在我們的文件夾中生成如下文件：

user.g.dart

最後，我們可以通過以下代碼將JSON字元串轉換成User對象：

String jsonString = '{"name": "John", "age": 30}'; 
User user = User.fromJson(json.decode(jsonString)); 

print('Name: ${user.name}'); //輸出：Name: John
print('Age: ${user.age}'); //輸出：Age: 30

四、如何處理JSON數據中的數組

在JSON數據中，我們可能會遇到數組類型的數據。對於這種情況，我們可以使用List類型來存儲數據。以下是一個簡單的例子：

import 'dart:convert';

void main() {
  String jsonString = '{"users": [{"name": "John", "age": 30}, {"name": "Mary", "age": 25}]}'; 
  Map data = json.decode(jsonString);
  
  List users = data['users'];
  
  for (var user in users) {
    print('Name: ${user['name']}, Age: ${user['age']}');
  }
  //輸出：
  //Name: John, Age: 30
  //Name: Mary, Age: 25
}

在上面的例子中，我們使用List類型來存儲users數組中的元素，然後通過循環遍歷輸出每個元素的屬性。

五、如何處理JSON中的嵌套對象

在JSON數據中，我們可能會遇到嵌套對象類型的數據。對於這種情況，我們可以將內部對象定義為另外一個模型類，然後在外部模型類中使用該類。以下是一個簡單的例子：

首先，我們需要定義兩個模型類：

import 'package:json_annotation/json_annotation.dart';

part 'location.g.dart';

@JsonSerializable()
class Location {
  String street;
  String city;

  Location({required this.street, required this.city});

  factory Location.fromJson(Map json) =>
      _$LocationFromJson(json);

  Map toJson() => _$LocationToJson(this);
}

@JsonSerializable()
class User {
  String name;
  int age;
  Location location;

  User({
    required this.name,
    required this.age,
    required this.location,
  });

  factory User.fromJson(Map json) => _$UserFromJson(json);

  Map toJson() => _$UserToJson(this);
}

在上面的代碼中，我們定義了一個Location模型類，該類包含兩個屬性：street和city。在User模型類中，我們使用Location類來定義location屬性。

使用方法與之前相同，在我們要生成模型類的文件中，添加以下代碼：

然後，我們需要運行以下命令來生成模型類：

flutter pub run build_runner build

最後，我們可以通過以下代碼將JSON字元串轉換成User對象：

String jsonString =
      '{"name": "John", "age": 30, "location": {"street": "Wall Street", "city": "New York"}}';
  User user = User.fromJson(json.decode(jsonString));
  print('Name: ${user.name}'); //輸出：Name: John
  print('Age: ${user.age}'); //輸出：Age: 30
  print('Location: ${user.location.street}, ${user.location.city}');
  //輸出：Location: Wall Street, New York

在上面的例子中，我們使用Location類來定義location屬性，然後在User類中使用該屬性。在fromJson方法和toJson方法中，我們也需要處理Location類型的數據。

總結

本文介紹了Flutter中如何處理JSON數據，包括如何解析JSON數據、如何序列化JSON數據、如何將JSON數據轉換成模型類、如何處理JSON數據中的數組和嵌套對象。希望本文可以幫助大家更好地使用Flutter處理JSON數據。