android Retrofit2网络请求封装介绍
更新时间：2021年12月30日 09:24:40 作者：扒鸡撕坦
大家好，本篇文章主要讲的是android Retrofit2网络请求封装介绍，感兴趣的同学赶快来看一看吧，对你有帮助的话记得收藏一下，方便下次浏览
1. Retrofit使用
Retrofit是一个现在网络请求框架，先来说一下怎么使用
网络权限（添加到AndroidManifest.xml）
<uses-permission android:name="android.permission.INTERNET" />
gradle依赖（添加到build.gradle）
implementation("com.squareup.okhttp3:okhttp:4.9.2")
implementation 'com.squareup.retrofit2:retrofit:2.9.0'
implementation 'com.squareup.retrofit2:converter-gson:2.9.0'
implementation 'com.squareup.retrofit2:converter-scalars:2.9.0'
定义接口,网络请求的方法
public interface Request {
@GET("/xx/xx")
Call<ResponseBody> get();
}
实例化Retrofit
Retrofit retrofit = new Retrofit.Builder().baseUrl("BASE_URL").build();
通过Retrofit实例创建接口服务对象
Request request = retrofit.create(Request.class);
调用接口中的方法
Call<ResponseBody> call = request.get();
执行异步请求（同步请求需要创建一个新的线程去执行）
call.enqueue(new retrofit2.Callback<ResponseBody>() {
@Override
public void onResponse(retrofit2.Call<ResponseBody> call, retrofit2.Response<ResponseBody> response) {
}
@Override
public void onFailure(retrofit2.Call<ResponseBody> call, Throwable t) {
}
});
2. Retrofit封装
以上可以看出Retrofit是个好东西，可是用起来是比较麻烦的，所有在实际使用中对Retrofit进行一下小小的封装是很有必要的。
定义接口（所有的请求参数都是以map的形式）
public interface Request {
/**
* 不带参数的get请求
* @param url
* @return
*/
@GET()
Call<ResponseBody> get(@Url String url);
/**
* 带参数的get请求
* @param url
* @param map 参数默认是map
* @return
*/
@GET()
Call<ResponseBody> get(@Url String url, @QueryMap Map<String,String> map);
/**
* 不带参数的post请求
* @param url
* @return
*/
@POST()
Call<ResponseBody> post(@Url String url);
/**
* 带参数的post请求
* @param url
* @param map
* @return
*/
@POST()
@FormUrlEncoded
Call<ResponseBody> post(@Url String url, @FieldMap Map<String,String> map);
}
定义RetrofitManager，以单例模式获取Retrofit实例
public enum RetrofitManager {
/**
* RetrofitManager的实例
*/
INSTANCE;
/**
*
* 后端接口的baseUrl，且只考虑一个url的情况（ip+端口，或者域名）
*/
private static final String BASE_URL = " Your BASE_URL";
private Retrofit retrofit;
/**
* 返回Retrofit实例，不添加转换器
* @return
*/
public Retrofit getRetrofit(){
if(retrofit == null){
retrofit = new Retrofit.Builder()
.baseUrl(BASE_URL)
.build();
}
return retrofit;
}
}
自定义的RetrofitCallback,在发送请求时，通过匿名对象作为参数获取后端的响应结果。
public abstract class RetrofitCallback {
/**
* 开始执行的方法
*/
public void onStart(){
//开启loading
}
/**
* 结束执行的方法
*/
public void onCompleted(){
//关闭loading
}
/**
* 执行成功
* @param resultJsonString 返回的json字符串
*/
public abstract void onSuccess(String resultJsonString);
/**
* 失败
* @param t 异常
*/
public abstract void onError(Throwable t);
/**
* 提示：服务异常
*/
public void serverErrMsg(){
//xxx
}
/**
* 提示：请求失败
*/
public void reqErrMsg(){
//xxx
}
/**
* 提示：成功
*/
public void okMsg(){
//xxx
}
}
定义RetrofitUtil,封装get和post方法。将RetrofitCallback作为请求参数，在发送请求时重写onSuccess和onError方法，执行具体的操作。
public class RetrofitUtil {
private Retrofit(){}
/**
* 无参的get请求
* @param url
* @param callback
*/
public static void get(String url, RetrofitCallback callback){
sendRequest(getRequest().get(url),callback);
}
/**
* 有参的get请求
* @param url 请求的url
* @param map 参数
* @param callback 请求结束的回调
*/
public static void get(String url, Map<String,String> map, RetrofitCallback callback){
sendRequest(getRequest().get(url,map),callback);
}
/**
* 无参的post请求
* @param url
* @param callback
*/
public static void post(String url, RetrofitCallback callback){
sendRequest(getRequest().post(url), callback);
}
/**
* 有参的post请求
* @param url
* @param map
* @param callback
*/
public static void post(String url, Map<String,String> map, RetrofitCallback callback){
sendRequest(getRequest().post(url,map), callback);
}
/**
* 获取Request实例
* @return
*/
private static Request getRequest(){
Retrofit retrofit = RetrofitManager.INSTANCE.getRetrofit();
return retrofit.create(Request.class);
}
/**
* 发送请求的共通方法，并对响应结果进行处理
* @param call
* @param callback 自定义的Callback
*/
private void sendRequest(Call<ResponseBody> call,RetrofitCallback callback){
//开启loading
callback.onStart();
//异步请求
call.enqueue(new Callback<ResponseBody>() {
@Override
public void onResponse(Call<ResponseBody> call, Response<ResponseBody> response) {
//关闭loading
callback.onCompleted();
if(response.isSuccessful()){
//执行RetrofitCallback的onSuccess方法，获取响应结果的json字符串
try {
String result = response.body().string();
callback.onSuccess(result);
//响应成功
if(StringUtils.equals(result, Constant.SUCCESS)){
callback.okMsg();
}
} catch (IOException e) {
e.printStackTrace();
}
}else{
//服务异常
callback.serverErrMsg();
}
}
@Override
public void onFailure(Call<ResponseBody> call, Throwable t) {
callback.onCompleted();
//请求失败
callback.onError(t);
callback.reqErrMsg();
}
}
});
}
}
3. RetrofitUtil使用
get无参请求
RetrofitUtil.get("/xx/xx", new RetrofitCallback() {
@Override
public void onSuccess(String resultJsonString) {
}
@Override
public void onError(Throwable t) {
}
});
get有参请求
Map<String,String> map = new HashMap<>(16);
map.put("key","value");
//xxx
RetrofitUtil.get("/xx/xx", map,new RetrofitCallback() {
@Override
public void onSuccess(String resultJsonString) {
xxxx
}
@Override
public void onError(Throwable t) {
xxxx
}
});
post请求和get的使用方法相似
最后
本次只对get和post进行了封装，项目中只用到了这些就没有对文件上传下载以及别的请求方式进行封装。且没有添加转换器，可在RetrofitManager的getRetrofit()方法中自行添加。大概的封装思路就是这样的，可以自行发挥。
此文也只是在记录项目中对Retrofit的使用，对Retrofit的原理并没有较深的了解。
到此这篇关于android Retrofit2网络请求封装介绍的文章就介绍到这了,更多相关android Retrofit2网络封装内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
这篇文章主要为大家详细介绍了Android实现计步器功能，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2021-03-03
这篇文章主要为大家详细介绍了Android短信验证码，使用Mob短信验证，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2017-05-05
Android 利用ViewPager实现图片可以左右循环滑动效果附代码下载
本文通过一个小demo给大家展示一段代码实现viewpage图片左右循环滑动效果，对viewgager循环滑动相关知识感兴趣的朋友一起学习吧2015-11-11
分析一下自动调节屏幕亮度手机随着光线的强度自我调节，也就是在亮的光线下屏幕自动亮一些，暗的时候就自动调暗一些，本文将详细介绍android 屏幕亮度调节2012-11-11
在项目中经常需要一个需要一个树状框架,因为一些原因没有使用系统自带的控件，所以就自己写了一个，现在分享给大家2014-01-01
android开发仿ios的UIScrollView实例代码
下面小编就为大家分享一篇android开发仿ios的UIScrollView实例代码，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2018-01-01
这篇文章主要为大家详细介绍了android实现多点触摸应用，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2022-05-05
这篇文章主要为大家详细介绍了RecyclerView仿应用列表实现网格布局，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2019-09-09
Android中AndroidStudio&Kotlin安装到运行过程及常见问题汇总
这篇文章主要介绍了Android（AndroidStudio&Kotlin）安装到运行过程及常见问题汇总,本文通过图文并茂的形式给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴借鉴价值，需要的朋友可以参考下2020-03-03
这篇文章主要介绍了Android开发中Button组件的使用,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2020-07-07
最新评论