one
An tool to help developer to use Retrofit elegantly while using kotlinx.coroutines.
Feature
- Transform different data structs to one.
{errorCode, data, messsage},{status, data, messsage}etc to one like{code, data, message}.
- No try catch needed when call a suspend method.
- try catch has been processed by reproxy interface.
Example
// call `proxyRetrofit` after `Retrofit#create`, in this method it will handle
// exception automatically.
val service = retrofit.create(WanAndroidService::class.java).proxyRetrofit()
// test
service.test()
.onSuccess { println("execute test success ==> $it") }
.onFailure { println("execute test() failure ==> $it") }
// userInfo
.onFailureThen { service.userInfo() }
?.onSuccess { println("execute userInfo success ==> $it") }
?.onFailure { println("execute userInfo() failure ==> $it") }
// banner
?.onFailureThen { service.banner() }
?.onSuccess { println("execute banner() success ==> $it") }
?.onFailure { println("execute banner() failure ==> $it") }
Is that realy simple and clean without try catch? If so, continuate to read following sections.
Usage
- Define a
BaseAPIResult. - Define a
ThrowableResolverto handle throwable and return aBaseAPIRsultwhich contains failure. - Define a
ResponseThransformerto transfrom different response data struct to the same response data struct. - Add
TansformConverterFactorytoRetrofitConverter.Factory list at first. - Call
proxyRetrofitafter callingRetrofit#create.
Read OneTest to understand details.
About the one
Why the repository is named one, just because I cannot figure how to name it.
License
Copyright 2021 ParadiseHell.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
12 Dec 16, 2022
2 May 29, 2022
3 Nov 5, 2022
6 Mar 31, 2022
22 Oct 3, 2022
198 Jan 1, 2023
32 Dec 20, 2022
37 Nov 30, 2022
362 Dec 29, 2022
34 Dec 30, 2022
132 Dec 9, 2022
23 Dec 27, 2022
32 Jan 4, 2023
4 Aug 18, 2022
8 Dec 1, 2022
10 Dec 13, 2022
69 Nov 9, 2022
41 Dec 21, 2022
50 Nov 20, 2022