dio_nexus

Description:

dio nexus

Dio Nexus #

This library is a network management layer built on top of Dio.

It automatically parses JSON data from the API and returns it to you as a model class.
It converts generated exceptions into its own exception types and then returns these exceptions to you.
It automatically sends a refresh token request using the refresh token.

Getting started #
🎉 Add dependency #
You can use the command to add dio as a dependency with the latest stable version:

$ dart pub add dio_nexus

copied to clipboard
Or you can manually add dio into the dependencies section in your pubspec.yaml:

dio_nexus: '^replace-with-latest-version'

copied to clipboard
We start by initialize the library. Here you can give these features to your project by giving parameters such as baseUrl, baseOptions and networkConnection.

import 'package:dio_nexus/dio_nexus.dart';

IDioNexusManager networkManager = DioNexusManager(
printLogsDebugMode: false,
options: BaseOptions(
baseUrl: "https://reqres.in/",
headers: {'Content-type': 'application/json'},
receiveTimeout: const Duration(seconds: 15),
connectTimeout: const Duration(seconds: 15)));

copied to clipboard
Model parser #
The sendRequest function in the library allows you to send requests to APIs. It takes generic types R and T.
The R type specifies the return type of the request. Based on the responseModel provided within the library, the received data from the server is automatically parsed. You will receive the desired model within the IResponseModel. If an error occurs, the IResponseModel will not return a null IErrorModel, but instead provide the statusCode, errorMessage, and NetworkExceptions.
The T type indicates the model you want to parse. Your model class, representing the JSON data, should inherit from the IDioNexusNetworkModel. This allows the library to perform the parsing process.

Future<IResponseModel<R?>?> sendRequest<T extends IDioNexusNetworkModel<T>, R>();

copied to clipboard
Refresh token #
Use refresh Token for expired token. In case of Authentication fail, the refresh token you have given will work.

IDioNexusManager networkManager = DioNexusManager(
onRefreshFail: () {
// Action to be taken when refresh Token fails.
},
onRefreshToken: (error, options) {
// Write your refresh token code.
},
options: BaseOptions(
baseUrl: "https://reqres.in/",
headers: {NetworkHeadersEnum.ContentType.value: "application/json"},
receiveTimeout: const Duration(seconds: 15),
connectTimeout: const Duration(seconds: 15)));

copied to clipboard
🎉 Locale #
Call the translate function anytime you want to translate the app and provide it with the language code
It supports Turkish and English. Locale("tr) and Locale("en")

IDioNexusManager networkManager = DioNexusManager(
options: BaseOptions(
baseUrl: "https://reqres.in/",
headers: {NetworkHeadersEnum.ContentType.value: "application/json"},
receiveTimeout: const Duration(seconds: 15),
connectTimeout: const Duration(seconds: 15)),
locale: const Locale('tr'),
networkConnection: NetworkConnection(
context: context,
snackbarDuration: const Duration(seconds: 5)));

copied to clipboard
Network connection #
In situations where there is no internet connection, it displays a toast message to notify the user about the lack of internet. By clicking the Retry button, the user can send another request to the previous request.
snackbarDuration to set the visibility of the snackbar that appears.

IDioNexusManager networkManager = DioNexusManager(
options: BaseOptions(
baseUrl: "https://reqres.in/",
headers: {NetworkHeadersEnum.ContentType.value: "application/json"},
receiveTimeout: const Duration(seconds: 15),
connectTimeout: const Duration(seconds: 15)),
networkConnection: NetworkConnection(
context: context,
snackbarDuration: const Duration(seconds: 5)));

copied to clipboard
🎉 Result:

Timeout request #
When there is no response from the server or the server cannot be reached, a toast message is displayed by default, indicating a timeout. To use it, you only need to provide the constructor.
To utilize the functionality, simply instantiate the class by providing the necessary constructor:

IDioNexusManager networkManager = DioNexusManager(
options: BaseOptions(
baseUrl: "https://reqres.in/",
headers: {NetworkHeadersEnum.ContentType.value: "application/json"},
receiveTimeout: const Duration(seconds: 15),
connectTimeout: const Duration(seconds: 15)),
timeoutToast: TimeoutToast(showException: true));

copied to clipboard
🎉 Result:

Custom interceptor #
You can add your own custom interceptor.

IDioNexusManager networkManager = DioNexusManager(
interceptor: MyInterceptor(),
options: BaseOptions(
baseUrl: "https://reqres.in/",
headers: {NetworkHeadersEnum.ContentType.value: "application/json"},
receiveTimeout: const Duration(seconds: 15),
connectTimeout: const Duration(seconds: 15)));

copied to clipboard
Examples #
Return Users type:

Future<IResponseModel<Users?>?> getUsers() async {
IResponseModel<Users?>? response = await nexusManager.sendRequest<Users, Users>(
"api/users",
requestType: RequestType.GET,
responseModel: Users());
return response;
}

copied to clipboard
Return Model type:

Future<IResponseModel<List<Model>?>?> request() async {
return await nexusManager.sendRequest<Model, List<Model>>(
'api/path',
responseModel: Model(),
requestType: RequestType.GET,
queryParameters: {"key": value});
}

copied to clipboard

When the server does not return JSON data as a response, this is handled by the NexusModel. Based on the data received from the server, you provide a T type. This T type can be String, int, bool, double, or dynamic. The response will be parsed and presented to you based on the T type you specify.

Future<IResponseModel<NexusModel<String>?>?> request() async {
return await nexusManager.sendRequest<NexusModel, NexusModel<String>>(
'api/path',
responseModel: NexusModel<String>(),
requestType: RequestType.GET,
queryParameters: {"key": value});
}

copied to clipboard
Features #
When initializing DioNexusManager, you can provide the following properties:

/// [onRefrestToken] when HttpStatus return unauthorized, you can call your refrestToken manager
Future Function(DioException error, BaseOptions options)? onRefreshToken;

/// If [onRefrestToken] return fail, this metot will work.
///
/// Example: When refreshToken==fail, app will logout.
Function? onRefreshFail;

/// Set true to print requests or errors received.
final bool? printLogsDebugMode;

/// When no internet connection, request again to server
NetworkConnection? networkConnection;

/// Show toast when request or connection timeout.
/// Default value is false.
TimeoutToast? timeoutToast;

/// This variable is used for no internet connection.
/// You can modify this counter when initializing [DioNexusManager].
/// When your internet connection is lost, you can try re-requesting up to 5 times.
int maxNetworkTryCount;

/// Get all interceptors
Interceptors get showInterceptors;

copied to clipboard
Licence #

Safa Uludoğan