vexana 1.2.2

flutter network helper project..

vexana

Vexana is easy use network proccess with dio. You can do dynamic model parse, base error model, timeout and many utitliy functions.

Getting Started 🔥

Let's talk use detail.

Network Manager 😎

Have a a lot options: baseurl, logger, interceptors, base model etc.

INetworkManager  networkManager = NetworkManager(isEnableLogger: true, errorModel: UserErrorModel(),
 options: BaseOptions(baseUrl: "https://jsonplaceholder.typicode.com/"));

Model Parse ⚔️

You have give to first parse model, second result model. (Result model could be list, model or primitive)

final response =
await networkManager.fetch<Todo, List<Todo>>("/todos", parseModel: Todo(), method: RequestType.GET);

HTTP Post Request with Request Body 🚀

The model to be found in the request body must extends the INetworkModel abstract class as follows.

class TodoPostRequestData extends INetworkModel<TodoPostRequestData>

Then, since the model will have toJson and fromJson properties, you can create the object and pass it directly to the fetch method.

So, it is sufficient to send only the request body object into the fetch method. You don't need to use toJson.

final todoPostRequestBody = TodoPostRequestData();
final response =
await networkManager.fetch<Todo, List<Todo>>("/todosPost", parseModel: Todo(), method: RequestType.POST, data: todoPostRequestBody);

Network Model 🛒

You must be wrap model to INetworkModel so we understand model has a toJson and fromJson properties.

class Todo extends INetworkModel<Todo>

Refresh Token ♻️

Many projects use authentication structure for mobile security (like a jwt). It could need to renew an older token when the token expires. This time have a refresh token options, and I do lock all requests until the token refresh process is complete.

Since i locked all requests, I am giving a new service instance.

INetworkManager  networkManager = NetworkManager(isEnableLogger: true, options: BaseOptions(baseUrl: "https://jsonplaceholder.typicode.com/",
onRefreshFail: () {  //Navigate to login },
 onRefreshToken: (error, newService) async {
    <!-- Write your refresh token business -->
    <!-- Then update error.req.headers to new token -->
    return error;
}));

Caching 🧲

You need to write a response model in the mobile device cache sometimes. It's here now. You can say expiration date and lay back 🙏

    await networkManager.fetch<Todo, List<Todo>>("/todos",
        parseModel: Todo(),
        expiration: Duration(seconds: 3),
        method: RequestType.GET);

You must be declare caching type. It has FileCache and SharedCache options now. NetworkManager(fileManager: LocalFile());

If you want to more deatil for cache, you should read this article

Tasks

---

• ✅ Example project
• ✅ Unit Test with json place holder
• ✅ Unit Test with custom api
• ❌ Make a unit test all layers.
• ✅ Cache Option
  • ❌ SQlite Support
• ✅ Refresh Token Architecture
• ❌ Usage Utility

License

2020 created for @VB10

Youtube Channel

---