Retrofit——新手学习分享

这篇文章旨在分享学习 Retrofit 的一些心得,由于我接触安卓开发不到一个月,这篇文章的分享对象是那些初学安卓开发,又没有学习过网络请求的新手。就更不敢妄谈“教程”、“经验”这些字眼,只能说把我的学习路程分享给大家,以供参考。

如果有哪些地方不正确,也请大家多多指教。

主要参考:这是一份很详细的 Retrofit 2.0 使用教程(含实例讲解)

我希望它能帮助你更快的上手 Retrofit ,但由于个人能力有限,所涉及内容都十分之基础,甚至有些粗浅。不过我会随着我的学习不定期更新这篇文章。

希望它能对你有帮助。


一、什么是Retrofit

Retrofit 是一个 RESTful 的 HTTP 网络请求框架的封装(基于OkHttp)。

如果你和我一样是一个新手,那你应该和我一样看到这行文字是一脸懵逼的。

什么是 RESTful ??什么是 HTTP ??(这玩意儿除了输网址的时候能看到过几次,平时对它一点了解都没有)什么是 OkHttp ??

这个时候,我们先试着把这句话精简一下:

Retrofit 是一个网络请求框架的封装。

这样看是不是好理解一些?说到底,Retrofit 的作用就是进行网络请求。

那什么是网络请求?

按照我的理解,网络请求就是向服务器 发送/接收 数据 的一个过程。这个技术在生活中无处不在,比如,你登录一下微信,App 就要把你输入的 账号、密码 发送到服务器,然后再从服务器中接收你的 好友列表、账号头像……等等数据。这就是网络请求。

学习 Retrofit 主要就是为了实现 网络请求 这一功能。

二、如何实现 Retrofit ?

1.添加库的依赖

Retrofit 是一个网络请求框架的封装。

既然是封装,我们实现 Retrofit 的第一步当然是添加 Retrofit库 的依赖。

在 app/build.grandle 中,添加这么几行:


applyplugin:'com.android.application'

......

dependencies {

    ......

    implementation'com.squareup.retrofit2:retrofit:2.4.0'
    implementation'com.squareup.okhttp3:okhttp:3.4.1'
}

又因为是网络请求,肯定还要有网络权限,是吧?

在 AndroidManifest 中添加如下代码:




    
    ......


2.创建 接收服务器返回数据 的类

我们在实现网络请求这个功能,就绕不过数据。

以一段 JSON格式 的数据为例,我们来看一看。

{"status":true,"message":"成功","data":[{"username":"测试1","password":"8887","birthday":"8886"},{"username":"测试2","password":"1887","birthday":"1886"}]}

这个是服务器上的数据,我们要要接收这些数据,那么就肯定要创建一个类来接收这些数据。

对上列数据也可以进行一个简单的总结归纳,就可以创建出这么一个类:

public class AceptData {
    private String status;

    private String message;

    private RetrofitData[] data;

    private static class RetrofitData {
        private String username;
        private String password;
        private String birthday;
    }

}

接收收数据的类是有了,那怎么接收数据?

3.创建 用于描述网络请求 的接口

public interface GetRequest_Interface {
    @GET("phpapi/test_api.php")
    Call getCall();
}

你看,利用泛型,接收数据这个操作简单的不行。

至于 @GET 则是一种网络请求方法,看英文就知道这个方法目的是接收数据(没有其他操作了)。而括号中的内容则在下一步说明。

当然还有 @POST 、@PUT 等共 8种 请求,已经有贴子把这方面介绍的十分详尽了,这里就不介绍了。

HTTP请求方法说明

4.创建 Retrofit 实例

数据处理完了,我们应该去在程序中实现它了。

Retrofit retrofit = new Retrofit.Builder()
                .baseUrl("http://119.29.134.162/") // 设置 网络请求 Url
                .addConverterFactory(GsonConverterFactory.create()) //设置使用Gson解析(记得加入依赖)
                .build();

上面这一段代码 baseUrl() 中的内容和之前 @GET() 中的内容结合在一起就正好是一个网址!

这两个请求放在一起就很好理解了,就是在对这个 网址 进行 网络请求 。

至于为什么这么写,我觉得这么做相较于放整个目录来说,可以对多目录进行编辑,让写程序更方便。

而 addConverterFactory(GsonConverterFactory.create()) 就是将网络数据格式装换为我们想要的数据格式,我这里转化的是 JSON格式,所以还要在 app/build.grandle 中,刚才的依赖下添加上这一句:


applyplugin:'com.android.application'

......

dependencies {

    ......

    implementation'com.squareup.retrofit2:converter-gson:2.4.0'

}

5.创建 网络请求接口实例

GetRequest_Interface request = retrofit.create(GetRequest_Interface.class);  // 创建实例
Call call = request.getCall();  // 对 发送请求 进行封装

这段就不用多说了吧?就向我们建立一个按钮就要写 "Button button = ....." 一样,Retrofit 也需要创建一个这样的实例。

6.发送网络请求(异步 / 同步)并处理接收数据

我们看到标题中有两个不熟悉的词汇,同步 与 异步。关于这个,我在网上找到这段话:

通信的同步:指客户端在发送请求后,必须要在服务端有回应后客户端才继续发送其他请求,所以这时所有请求将会在服务端得到同步,直到服务端返回请求。

通信的异步:指客户端在发送请求后,不必等待服务端的回应就可以发送下一个请求,对所有的请求动作来说将会在服务端得到异步,这条请求的链路就像是一个请求队列,所有的请求动作在这里不会得到同步。

总结一下上面的话,对于 同步 与 异步,他们最大的区别是:客户端发送请求后,进行下一请求之前等不等服务器回应。如果等,那么客户端与服务端同步,不等就是不同步。

精简以后:

同步:下一个线程需要上一个线程的数据,没有上一个线程下一个线程无法运行。

异步:两个线程可能有数据交换,但是各自独自运行,相互之间没有影响。

更详细的:Android 同步异步区别

所以选择同步还是异步具体还是要视情况而定。现在再看代码:

//发送网络请求(异步)
        call.enqueue(new Callback() {
            //请求成功时回调
            @Override
            public void onResponse(Call call, Response response) {
                //请求处理,输出结果
                response.body().show();
            }

            //请求失败时候的回调
            @Override
            public void onFailure(Call call, Throwable throwable) {
                System.out.println("连接失败");
            }
        });

// 发送网络请求(同步)
  Response response = call.execute();
  // 对返回数据进行处理
  response.body().show();

在请求成功中,我们可以加入相关方法对接收的数据进行处理。这里是通过 response类 的 body()对返回的数据进行处理。

而方法 show() 则在接收数据的类中创建,代码如下:

public class AceptData {
......
    public void show(){        // 向日志输出得到的数据
        Log.i("MainActivity","Status is "+status);
        Log.i("MainActivity","Message is "+message);
        Log.i("MainActivity","Username is "+data[0].username);
        Log.i("MainActivity","Password is "+data[0].password);
        Log.i("MainActivity","Birthday is "+data[0].birthday);
        Log.i("MainActivity","Username is "+data[1].username);
        Log.i("MainActivity","Password is "+data[1].password);
        Log.i("MainActivity","Birthday is "+data[1].birthday);
    }

}

经过这些步骤,一个最基本的 Retrofit 就实现了,我们运行一下程序看看结果。

image

当然网络请求方式不止 Retrofit 一种,但 Retrofit 应该是近年来最好用的了,而之前广泛使用的 OkHttp 上还要管理线程,自然是不如 Retrofit 的。

源码稍后补充……

你可能感兴趣的:(Retrofit——新手学习分享)