simple_fetch 0.1.0
simple_fetch: ^0.1.0 copied to clipboard
Turn Dio responses into typed models. Works for JSON objects, lists, and nested payloads across current Flutter versions.
simple_fetch #
A wrapper around Dio that maps a response into a model in one call. It works for a single JSON object, a list, and nested payloads such as {"data": [...]}.
Any 2xx status is success. Pass successCodes to allow or require specific codes, including codes outside 2xx. An empty body becomes null, or an empty list from the list methods. Pass baseOptions or an existing Dio to set a base URL, headers, and timeouts. url is required.
Get started #
Install #
Add the simple_fetch package to your
pubspec dependencies.
import 'package:simple_fetch/simple_fetch.dart';
final simpleFetch = SimpleFetch();
String apiUrl = 'https://jsonplaceholder.typicode.com/todos/';
Very simple use #
testGet()async{
List<Todo?> allProductsData = await simpleFetch.getList<Todo>(
url: apiUrl,
mapper: Todo.fromJson,
);
}
Examples #
Performing a GET request :
/// Fetch an object and make it a model type
void getOneDataItemFromEndpoint() async {
SimpleFetch simpleFetch = SimpleFetch();
String apiUrl = 'https://jsonplaceholder.typicode.com/todos/1';
try {
Todo? productsData = await simpleFetch.get<Todo>(
url: apiUrl,
mapper: Todo.fromJson,
// transformer: (transform) => transform['data'],
);
print(productsData?.toJson());
} on SimpleError catch (exception) {
print(exception.message);
} catch (e) {}
}
/// Fetch a List of object and make it a model type
void getDataFromEndpoint() async {
SimpleFetch simpleFetch = SimpleFetch();
String apiUrl = 'https://jsonplaceholder.typicode.com/todos/';
try {
List<Todo?> allProductsData = await simpleFetch.getList<Todo>(
url: apiUrl,
mapper: Todo.fromJson,
);
print(allProductsData.map((e) => e?.toJson()).toList());
} on SimpleError catch (exception) {
print(exception.message);
} catch (e) {}
}
Performing a POST request:
/// If the response of your post request is a single item
void postSingleResponse() async {
SimpleFetch simpleFetch = SimpleFetch();
String apiUrl = 'https://jsonplaceholder.typicode.com/todos/1';
try {
Todo? productsData = await simpleFetch.post<Todo>(
url: apiUrl,
data: {'id': 1, 'name': 'hello'},
mapper: Todo.fromJson,
// transformer: (transform) => transform['data'],
);
print(productsData?.toJson());
} on SimpleError catch (exception) {
print(exception.message);
} catch (e) {}
}
// If the response of your post request is a list of item
void postMultipleResponse() async {
SimpleFetch simpleFetch = SimpleFetch();
String apiUrl = 'https://jsonplaceholder.typicode.com/todos/';
try {
List<Todo?> allProductsData = await simpleFetch.postList<Todo>(
url: apiUrl,
data: {'id': 2, 'name': 'Hiiii'},
mapper: Todo.fromJson,
);
print(allProductsData.map((e) => e?.toJson()).toList());
} on SimpleError catch (exception) {
print(exception.message);
} catch (e) {}
}
Performing multiple concurrent requests:
response = await Future.wait([request1, request2]);
Transformers #
By default the packages is designed for you to simply retrieve data that is a list or json Sometimes you may want to remove,add or filter the data that is received before making it an object The transformer parameter helps you achieve this
{
"data":[
{
"userId": 1,
"id": 1,
"title": "delectus aut autem",
"completed": false
},
{
"userId": 2,
"id": 2,
"title": "User ovier vac",
"completed": true
},
]
}
In this case you may want to return an list so you can do
try {
List<Todo?> allProductsData = await simpleFetch.getList<Todo>(
url: apiUrl,
mapper: Todo.fromJson,
transformer: (transform) => transform['data'],
);
print(allProductsData.map((e) => e?.toJson()).toList());
} on SimpleError catch (exception) {
print(exception.message);
} catch (e) {}