دریافت اطلاعات از اینترنت (HTTP و JSON)
Fetch data from the internetراهنمای رسمی ارسال درخواست شبکه با بسته http، تبدیل پاسخ JSON به مدل Dart و نمایش دادهها با FutureBuilder
فهرست مطالب این صفحه
دریافت داده از سرویسهای وب (REST API) یکی از نیازهای اساسی در اکثر اپلیکیشنهای Flutter است. برای انجام این کار از بسته رسمی http در کنار کتابخانه داخلی dart:convert استفاده میکنیم.
۱. افزودن بسته http به پروژه
برای نصب بسته http، دستور زیر را در ریشه پروژه خود اجرا کنید:
flutter pub add http
۲. ارسال درخواست شبکه و تبدیل JSON به کلاس Dart
به جای کار مستقیم با Map<String, dynamic> خام، بهترین روش در Dart تبدیل پاسخ JSON به یک کلاس مدل دارای تایپ مشخص (Album) است:
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 (در حال بارگذاری، دریافت موفق داده یا بروز خطا) را بهسادگی به ویجتهای رابط کاربری متصل کنید:
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()خودداری کنید تا با هر بار بازسازی رابط کاربری، درخواست شبکه تکراری ارسال نشود.