دریافت اطلاعات از اینترنت (HTTP و JSON)

Fetch data from the internet

راهنمای رسمی ارسال درخواست شبکه با بسته http، تبدیل پاسخ JSON به مدل Dart و نمایش داده‌ها با FutureBuilder

فهرست مطالب این صفحه

دریافت داده از سرویس‌های وب (REST API) یکی از نیازهای اساسی در اکثر اپلیکیشن‌های Flutter است. برای انجام این کار از بسته رسمی http در کنار کتابخانه داخلی dart:convert استفاده می‌کنیم.

۱. افزودن بسته http به پروژه

برای نصب بسته http، دستور زیر را در ریشه پروژه خود اجرا کنید:

Terminal / Bash
flutter pub add http

۲. ارسال درخواست شبکه و تبدیل JSON به کلاس Dart

به جای کار مستقیم با Map<String, dynamic> خام، بهترین روش در Dart تبدیل پاسخ JSON به یک کلاس مدل دارای تایپ مشخص (Album) است:

Dart
import 'dart:convert';
import 'package:http/http.dart' as http;

class Album {
  final int userId;
  final int id;
  final String title;

  const Album({
    required this.userId,
    required this.id,
    required this.title,
  });

  factory Album.fromJson(Map<String, dynamic> json) {
    return Album(
      userId: json['userId'] as int,
      id: json['id'] as int,
      title: json['title'] as String,
    );
  }
}

Future<Album> fetchAlbum() async {
  final response = await http.get(
    Uri.parse('https://jsonplaceholder.typicode.com/albums/1'),
  );

  if (response.statusCode == 200) {
    return Album.fromJson(jsonDecode(response.body) as Map<String, dynamic>);
  } else {
    throw Exception('خطا در دریافت اطلاعات از سرور');
  }
}

۳. نمایش داده‌ها در رابط کاربری با FutureBuilder

ویجت FutureBuilder به شما اجازه می‌دهد وضعیت یک Future (در حال بارگذاری، دریافت موفق داده یا بروز خطا) را به‌سادگی به ویجت‌های رابط کاربری متصل کنید:

Dart
FutureBuilder<Album>(
  future: futureAlbum,
  builder: (context, snapshot) {
    if (snapshot.hasData) {
      return Text(snapshot.data!.title);
    } else if (snapshot.hasError) {
      return Text('${snapshot.error}');
    }
    return const CircularProgressIndicator();
  },
)

توصیه مهم: متد fetchAlbum() را درون initState() فراخوانی کنید و نتیجه آن را در یک متغیر ذخیره نمایید؛ از فراخوانی مستقیم آن داخل متد build() خودداری کنید تا با هر بار بازسازی رابط کاربری، درخواست شبکه تکراری ارسال نشود.