Senior Android Developer
Implementing a sample Android Application using MVP, RxJava, Dagger 2, Retrofit2, Test, and all the brand new modern methods and libraries
Let’s think that you have studied part1 and part2 which means you know everything about the sample project’s modules and structure and also get more familiar with Dagger usage in wiring up MVP layers.
now let’s continue…
Almost all mobile application communicate with their services using the internet. Retrofit is a perfect library contributed by Jake Wharton which can always come handy and help you with developing a network layer for your Android application.
Long story short, in this project Retrofit, uses an interface called MarvelApi which shows the way to API:
Using retrofit is really simple, as you can see there is a RESTful API method located at http://gateway.marvel.com:80/v1/public/characters which needed some parameters to retrieve what you want, which is character data using its name.
A good developer is the one who always read API documents, you can read more about Marvel APIs:
All networking and databasing stuff happen inside Model layer.
This layer only works with data and business logic and Presenter knows how to call or how to prepare data for the View layer.
Please stop manipulating data within theModel layer and pass it safe and sound to the Presentation layer, he knows what to do…
The Retrofit library uses OkHttp library within which is a powerful network library. All magic happens with Interceptors. I will explain one by one and finally show you how to apply them to your OkHttpClient.
By a little configuration you can ask this library to show you a decent log in logcat which always comes handy:
, but don’t forget to disable this logging thing in release version! you can do this by checking BuildConfig.DEBUG variable which generates during application build.
First time I do this inside a news reader application, all database record updating and queries almost killed all team members.
Using OkHttp cache feature you can handle header caches and also have an offline file caching which sometimes could be a perfect substitution for Database pain:
There are two cache interceptors in this sample,
Don’t panic if everything is new, you will learn how to use it after some sample project… ;)
Network connections are always lossy or even the service might be down for a few seconds and they may cause trouble for the app, so please try again before informing the user about the situation!
I look for retry policies using RxJava but none of them works with Retrofit, but this interceptor works:
you can customize it if you require more retry times or even more condition to decide to retry or not, but I think it is fine. :)
All interceptors are provided inside ClientModule, which also add them all to OkHttpClient:
Take care of the if(isDebug) statement which comes as the result of BuildConfig.DEBUG variable.
There is also the Network Timeout which tells OkHttp how long wait for the response.
Okay, all these codings was for the final step… Inside ApiModule we use that OkHttpClient to create the Retrofit instance and use it to create MarvelApi:
You have to provide BaseUrl that usually is the first static part of all your service API URLs, which in this sample is “http://gateway.marvel.com:80/”. (don’t forget the last ‘/’, it is required for the Retrofit library and may cause exception)
API provided in this way would be used by SearchInteractorImpl which communicates with service. Retrofit knows how to response using RxJava and you can easily capture the result parse it using Gson and use it with other RxJava operators (i.e map, flat map, filter, etc.) to manipulate and prepare a response and hand it to View layer to present to the user.
Please clone the project repo from GitHub and get more familiar with it because in next part I will explain more about RxJava and RxAndroid and how it helps with spreading response from core to View layer.
I look forward to your comments and helping for more improvements with this article.
Share this article if you think it is useful, and follow me for more articles Mohsen Mirhoseini.
To be continued…
Create your free account to unlock your custom reading experience.