简介
Retrofit是一个现在比较火的网络请求框架,它的底层是依靠okhttp实现的(okhttp也是一款很不错的框架之前有使用过),确切的讲,Retrofit是对okhttp的进一步封装,它功能强大,支持同步和异步、支持多种数据的解析(默认使用Gson),也支持RxJava。
对于我们软件开发者来言,一个框架是否好,这个框架是否简单易用占了很重要的一部分。而Retrofit一个优势,就是简洁易用,它通过注解配置网络请求的参数,采用大量的设计模式来简化我们的使用。而且它的拓展性也做的相当的好,Retrofit的功能模块高度封装,高内聚低耦合,我们可以自定义自己想要的组件,比如说我们可以自己选择解析工具而不用默认的Gson。
除此之外,Retrofit还有诸如性能好,处理速度快,代码简化等优势,给足了理由让我们去尝试使用这款网络请求框架。
试一试
在网上随便找了一个Api测试接口,豆瓣的Api接口 ,我们用retrofit来尝试调用一下。
首先,当然是创建retrofit的实例了,嗯,一个常见的builder模式。我们需要设置一个baseUrl,也就是网络请求的接口地址,豆瓣提供的接口地址为https://api.douban.com/v2/
简简单单的三行代码就可以创建一个retrofit实例,当然retrofit为我们提供了很多的方法
这些方法主要是用来自定义retrofit,比如说addConverterFactory是用来设置数据解析的工具,其默认的工具是Gson,如果我们想使用其他的解析工具比如说JackSon,那么就调用addConverterFactory来替换。当然我们这边只是简单的实现,就不深度定制我们的retrofit了,用默认的设置来创建一个实例足矣。
然后我们需要创建一个interface,我们将这个interface取名为BookService,之后有关book的网络请求都可以放在这里面定义。
我们定义了一个getBook方法,其返回类型为retrofit的Call类型,尖括号里是okhttp的ResponseBody类型,@GET注解的作用是声明采用GET的方法进行网络请求,@Path注解的作用是声明其之后的 int id 参数,将以路径的形式被替换到@GET注解括号里的{id}处。比如说,之后我们在调用getBook方法时传入参数1111,@GET注解里将会被转化为 book/1111 ,这个 book/1111 又会被接到我们之前设置的baseUrl之后,变成 https://api.douban.com/v2/book/1111,这样就变成了一个完整的网络请求地址。
关于注解,retrofit提供了基本的GET、POST、DELETE、PUT、OPTIONS、HEAD等常见的网络请求方法,我们现在常常用到的是GET和POST。原理大都相同,我们这里就用GET来测试一下。
定义好interface之后,我们需要创建一个call的实例,先用retrofit的create方法来创建一个bookService,一个call就代表一个网络请求,因此我们需要创建一个getBook的网络请求。可以看到我们这边传入了一个1220562作为参数。
创建完成之后,就可以进行网络请求了
调用call的enqueue方法,然后再new 一个CallBack类,可以发现CallBack里面有两个回调方法,onResponse和OnFailure,onResponse被调用时说明网络请求成功,其参数response即为网络请求后返回的数据,而如果网络请求失败,则会调用onFailure方法。
我们在相应的方法里加入对应的处理操作。
如果网络请求成功,就把返回的信息打印出来,如果失败,就把相应的报错信息打印。对了,上述的两个方法是运行在UI线程,因此我们可以直接在方法里进行更新UI的操作,比如说把获取到的信息显示到UI上,of course,我们在这个方法里就不能进行耗时的操作,否则会造成界面卡顿或直接崩溃。
看一下运行结果
可以看到,打印出了网络请求返回的信息。我们再在浏览器上看一下我们调用的接口地址https://api.douban.com/v2/book/1220562
可以发现与我们调用返回的信息是完全一样的。至此,我们成功地用retrofit进行了一次网络请求。
Retrofit这个词我查了一下是样式翻新的意思,的确,它是将okhttp进行了进一步的封装翻新,这个翻新为我们带来了很多的便捷。当然,我这里只是很简单的实现了一下,如果我们对Retrofit进行自定义设置,在设置的过程中,我们会发现retrofit更多的精妙之处,其实我们还可以用Retrofit来做一些有意思的事情,比如将它和RxJava结合使用,让网络请求变得更加简单高效。不过我还没试过,过几天试一下,emmmm.....
以上。