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中深入学习对象的四种引用类型

    Android中深入学习对象的四种引用类型

    这篇文章主要介绍Android中深入学习对象的四种引用类型,Java中,一切被视为对象,引用则是用来操纵对象的;在JDK1.2就把对象引用分为四种级别,从而使程序能更灵活控制它的生命周期,级别由高到底依次为强引用、软引用、弱引用、虚引用,需要的朋友可以参考一下
    2021-10-10
  • Android UI自定义ListView实现下拉刷新和加载更多效果

    Android UI自定义ListView实现下拉刷新和加载更多效果

    这篇文章主要介绍了Android UI自定义ListView实现下拉刷新和加载更多效果,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2016-11-11
  • Android Studio实现仿微信APP门户界面详解及源码

    Android Studio实现仿微信APP门户界面详解及源码

    这篇文章带你通过Android studio来实现微信APP的门户界面,主要说明框架的各部分功能与实现过程,下文包含了整个开发过程,以及解决问题的思路并再末尾提供了源码链接
    2021-10-10
  • 常见Android选项菜单样式集合

    常见Android选项菜单样式集合

    这篇文章主要为大家分享了一份属于你自己的常见Android菜单样式集合,方便大家开发使用Android菜单,对OptionMenu感兴趣的小伙伴们可以参考一下
    2016-02-02
  • Android 菜单栏DIY实现效果详解

    Android 菜单栏DIY实现效果详解

    这篇文章主要为大家介绍了Android 菜单栏DIY实现效果详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-09-09
  • Android仿京东顶部搜索框滑动伸缩动画效果

    Android仿京东顶部搜索框滑动伸缩动画效果

    这篇文章主要为大家详细介绍了Android仿京东顶部搜索框滑动伸缩动画效果,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2019-07-07
  • android  指纹识别调用实现方法及示例代码

    android 指纹识别调用实现方法及示例代码

    这里主要介绍Android 指纹识别的简单实现代码,希望能帮助开发这部分应用的朋友,有需要的小伙伴可以参考下
    2016-09-09
  • 详解Android WebView加载html片段

    详解Android WebView加载html片段

    本篇文章主要介绍了详解Android WebView加载html片段,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-08-08
  • Taro打包Android apk过程详解

    Taro打包Android apk过程详解

    这篇文章主要为大家介绍了Taro打包Android apk的过程及详解步骤,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-02-02
  • Android开发实现的电话窃听和拦截应用

    Android开发实现的电话窃听和拦截应用

    这篇文章主要介绍了Android开发实现的电话窃听和拦截应用,结合实例形式分析了Android针对电话的监听与拦截的相关技巧,需要的朋友可以参考下
    2016-08-08

最新评论