实际开发过程中一般都会选择一些网络框架提升开发效率。随着Google对HttpClient 摒弃和Volley框架的逐渐没落。OkHttp開始异军突起。而Retrofit则对OkHttp进行了强制依赖,能够简单理解Retroifit在OKHttp基础上进一步完好。

Retrofit是由Square公司出品的针对于Android和Java的类型安全的Httpclient,眼下推出了2.0+的版本号。

Retrofit框架项目地址:https://github.com/square/retrofit

Retrofit官方文档地址: http://square.github.io/retrofit/

使用Retrofit

接下来我们来学习下怎样使用Retrofit。

首先须要在app/build.gradle加入依赖。

dependencies {
//...
//retrofit
compile 'com.squareup.retrofit2:retrofit:2.1.0'
//假设用到gson解析 须要加入以下的依赖
compile 'com.squareup.retrofit2:converter-gson:2.1.0'
}

我们以查号码归属地接口为例 https://www.juhe.cn/docs/api/id/11

Retrofit不能直接使用,须要进行初始化,在这里创建NetWork.java

public class NetWork {
private static Retrofit retrofit; /**返回Retrofit*/
public static Retrofit getRetrofit(){
if(retrofit==null){
Retrofit.Builder builder = new Retrofit.Builder();//创建Retrfit构建器
retrofit = builder.baseUrl("http://apis.juhe.cn/") //指定网络请求的baseUrl
.addConverterFactory(GsonConverterFactory.create())//返回的数据通过Gson解析
.build();
}
return retrofit;
}
}

Retrofit须要之地baseUrl。往往一个项目中有很多接口。接口都使用同样的server地址,这时候能够把接口地址同样的部分抽取到baseUrl中。Retrofit扩展性极好。能够指定返回的数据通过Gson解析,前提你须要保证项目中有Gson框架和com.squareup.retrofit2:converter-gson:2.1.0的依赖。

除了通过Gson解析还能够使用其他的方式解析,须要的依赖也不同。有例如以下几种:

  • Gson: com.squareup.retrofit:converter-gson
  • Jackson: com.squareup.retrofit:converter-jackson
  • Moshi: com.squareup.retrofit:converter-moshi
  • Protobuf: com.squareup.retrofit:converter-protobuf
  • Wire: com.squareup.retrofit:converter-wire
  • Simple XML: com.squareup.retrofit:converter-simplexml

Retrofit须要把Http的请求接口封装到一个接口文件里。

public interface NetInterface {
//获取号码归属地,返回来类型是Bean, 须要两个參数分别为phone何key
@GET("mobile/get")
Call<Bean> getAddress(@Query("phone") String phone, @Query("key") String key);
}

当中Bean是依据请求的结果创建的对象.

方法前加入@GET注解表示当前请求是Get方式请求,链接的地址是baseUrl+”mobile/get”。baseUrl在初始化Retrofit的时候指定了,拼到一起就是 http://apis.juhe.cn/mobile/get

对于 Retrofit 2.0中新的URL定义方式,这里是我的建议:

  • baseUrl: 总是以 /结尾
  • url: 不要以 / 开头

由于假设不是这样的方式,拼装后的结果和你期望的是不一样的,详情參考官方文档。

除了Get请求还有以下几种请求方式

  • @POST 表明这是post请求
  • @PUT 表明这是put请求
  • @DELETE 表明这是delete请求
  • @PATCH 表明这是一个patch请求。该请求是对put请求的补充。用于更新局部资源
  • @HEAD 表明这是一个head请求
  • @OPTIONS 表明这是一个option请求
  • @HTTP 通用注解,能够替换以上全部的注解。其拥有三个属性:method。path,hasBody

最后的HTTP通用注解写法比較特殊。请求能够取代之前的请求。以下的写法和之前的@GET效果是一样的。

/**
* method 表示请的方法,不区分大写和小写
* path表示路径
* hasBody表示是否有请求体
*/
@HTTP(method = "get",path = "mobile/get",hasBody = false)
Call<Bean> getAddress(@Query("phone") String phone, @Query("key") String key);

@Quert表示查询參数。用于GET查询,注解里的字符串是參数的key值,參数会自己主动拼装到Url后面。

除了上面的注解。再给大家介绍几种不同的注解。

经常使用的注解

@Url:使用全路径复写baseUrl,适用于非统一baseUrl的场景。演示样例代码:

@GET Call<ResponseBody> XXX(@Url String url);

@Streaming:用于下载大文件。演示样例代码:

@Streaming @GET Call<ResponseBody> downloadFileWithDynamicUrlAsync(@Url String fileUrl);

//获取数据的代码
ResponseBody body = response.body();
long fileSize = body.contentLength();
InputStream inputStream = body.byteStream();

@Path:URL占位符,用于替换和动态更新,相应的參数必须使用同样的字符串被@Path进行凝视

//实际请求地址会给句groupId的值发生变化--> http://baseurl/group/groupId/users
@GET("group/{id}/users") Call<List<User>> groupList(@Path("id") int groupId);

@QueryMap:查询參数,和@Query相似。差别就是后面须要Map集合參数。演示样例代码:

Call<List<News>> getNews((@QueryMap(encoded=true) Map<String, String> options);

@Body:用于POST请求体。将实例对象依据转换方式转换为相应的json字符串參数。这个转化方式是GsonConverterFactory定义的。 演示样例代码:

@POST("add")
Call<List<User>> addUser(@Body User user);

@Field,@FieldMap:Post方式传递简单的键值对,须要加入@FormUrlEncoded表示表单提交

@FormUrlEncoded @POST("user/edit") Call<User> updateUser(@Field("first_name") String first, @Field("last_name") String last);

@Part,@PartMap:用于POST文件上传,当中@Part MultipartBody.Part代表文件,@Part(“key”) RequestBody代表參数,须要加入@Multipart表示支持文件上传的表单。

@Multipart
@POST("upload")
Call<ResponseBody> upload(@Part("description") RequestBody description,
@Part MultipartBody.Part file);

完毕请求实例

了解了Retrofit,我们用Retrofit请求完毕请求。Retrofit使用起来比較省事,核心代码例如以下所看到的:

//初始化Retrofit,载入接口
NetInterface netInterface = NetWork.getRetrofit().create(NetInterface.class);
//请求接口
netInterface.getAddress(editText.getText().toString(),"你的app key")
.enqueue(new Callback<Bean>() {
@Override
public void onResponse(Call<Bean> call, Response<Bean> response) {
//请求成功
Bean bean = response.body();
//...
} @Override
public void onFailure(Call<Bean> call, Throwable t) {
//请求失败
}
});

Retrofit会自己主动在子线程中进行网络请求。请求结束切换到主线程中。并且内部使用了线程池。对网络请求的缓存控制的也很到位,网络响应速度也是很快的,使用起来很的爽!

RxJava和Retrofit结合

RxJava很强大。就连Retrofit都要抱下他的大腿,Retrofit也能够用RxJava方式进行网络请求。仅仅须要对上面的代码进行改造就可以。

首先加入框架依赖。

dependencies {
//... compile 'io.reactivex:rxandroid:1.2.1'
compile 'io.reactivex:rxjava:1.1.6' compile 'com.google.code.gson:gson:2.8.0' compile 'com.squareup.retrofit2:retrofit:2.1.0'
//假设用到gson解析 须要加入以下的依赖
compile 'com.squareup.retrofit2:converter-gson:2.1.0'
//Retrofit使用RxJava须要的依赖
compile 'com.squareup.retrofit2:adapter-rxjava:2.1.0' }

改动Retrofit初始化的代码:

public class NetWork {
private static Retrofit retrofit; /**返回Retrofit*/
public static Retrofit getRetrofit(){
if(retrofit==null){
//创建Retrfit构建器
Retrofit.Builder builder = new Retrofit.Builder();
//指定网络请求的baseUrl
retrofit = builder.baseUrl("http://apis.juhe.cn/")
//返回的数据通过Gson解析
.addConverterFactory(GsonConverterFactory.create())
//使用RxJava模式
.addCallAdapterFactory(RxJavaCallAdapterFactory.create())
.build();
}
return retrofit;
}
}

上面代码我们通过,加入代码addCallAdapterFactory(RxJavaCallAdapterFactory.create())就变成了使用RxJava模式。

接口也须要改动,把方法的返回值类型由Call改成了RxJava中的Observable。

public interface NetInterface {
//获取号码归属地,返回来类型是Bean, 须要两个參数分别为phone何key
@GET("mobile/get")
Observable<Bean> getAddress(@Query("phone") String phone, @Query("key") String key);
}

接下来改动终于网络请求的代码,能够改成RxJava方式了。

  NetInterface netInterface = NetWork.getRetrofit().create(NetInterface.class);
//RxJava方式
netInterface.getAddress(editText.getText().toString(),"你的app key")
.subscribeOn(Schedulers.io())//设置网络请求在子线程中
.observeOn(AndroidSchedulers.mainThread())// 回调在主线程中
.subscribe(new Action1<Bean>() {
@Override
public void call(Bean bean) {
//请求成功
}
}, new Action1<Throwable>() {
@Override
public void call(Throwable throwable) {
//请求失败
}
});

总结

这是Retrofit基础篇, 后面有时间再继续深入研究


很多其他精彩请关注微信公众账号likeDev

Retrofit全攻略——基础篇的更多相关文章

  1. Retrofit全攻略——进阶篇

    最近事比较多,距离上次写文章已经过去了一个月了.上一篇文章Retrofit全攻略——基础篇 介绍了Retrofit的基础用法,这篇文章介绍点进阶的用法. 打印网络日志 在开发阶段,为了方便调试,我们需 ...

  2. vscode 开发项目, Prettier ESLint的配置全攻略(基础篇)

    我们在做项目尤其是多人合作开发的时候经常会因为不同的开发规范和代码风格导致出现冲突, 为了能统一代码风格和规范我们需要使用到prettier和eslint,接下来就一vscode编辑器为例详细讲解下: ...

  3. BOOST 线程完全攻略 - 基础篇

    http://blog.csdn.net/iamnieo/article/details/2908621 2008-09-10 12:48 9202人阅读 评论(3) 收藏 举报 thread多线程l ...

  4. 【C/C++】BOOST 线程完全攻略 - 基础篇

    C++多线程开发是一个复杂的事情,mfc下提供了CWinThread类,和AfxBeginThread等等函数,但是在使用中会遇到很多麻烦事情,例如线程之间参数传递的问题,我们一般都是把参数new一个 ...

  5. 打造一个高逼格的android开源项目——小白全攻略 (转)

    转自:打造一个高逼格的android开源项目 小引子 在平时的开发过程中,我们经常会查阅很多的资料,最常参考的是 github 的开源项目.通常在项目的主页面能看到项目的简介和基本使用,并且时不时能看 ...

  6. VS2013全攻略(安装,技巧,快捷键,插件)!

    工欲善其事,必先利其器.VS2013全攻略(安装,技巧,快捷键,插件)! 之前一篇<c++的性能, c#的产能?!鱼和熊掌可以兼得,.NET NATIVE初窥>承蒙大家喜爱和编辑推荐,在此 ...

  7. CSS Grid网格布局全攻略

    CSS Grid网格布局全攻略 所有奇技淫巧都只在方寸之间. 几乎从我们踏入前端开发这个领域开始,就不停地接触不同的布局技术.从常见的浮动到表格布局,再到如今大行其道的flex布局,css布局技术一直 ...

  8. Android屏幕适配全攻略(最权威的官方适配指导)屏幕尺寸 屏幕分辨率 屏幕像素密度 dpdipdpisppx mdpihdpixdpixxdpi

    Android屏幕适配全攻略(最权威的官方适配指导)原创赵凯强 发布于2015-05-19 11:34:17 阅读数 153734 收藏展开 转载请注明出处:http://blog.csdn.net/ ...

  9. 【C#代码实战】群蚁算法理论与实践全攻略——旅行商等路径优化问题的新方法

    若干年前读研的时候,学院有一个教授,专门做群蚁算法的,很厉害,偶尔了解了一点点.感觉也是生物智能的一个体现,和遗传算法.神经网络有异曲同工之妙.只不过当时没有实际需求学习,所以没去研究.最近有一个这样 ...

随机推荐

  1. JavaScript阻止修改对象的三种方式

    JavaScript中,我们希望别人无法修改我们创建的对象.比如,代码库的作者很可能想锁定核心库的某些部分来保证它们不被意外地修改.ES5中引入了三种锁定修改的级别:防止扩展preventExtens ...

  2. TCP 粘包及其解决方案(zz)

    首先,我们回顾一下 TCP 和 UDP 的头部信息: 具体说明看:http://www.cnblogs.com/aomi/p/7776582.html 我们知道,TCP 和 UDP 是 TCP/IP ...

  3. HBuilder开发移动App——manifest.json文件解析

    以前做过Android App开发,对于各项配置都是在AndroidManifest.xml文件中完成的,包括权限的设定.图标.标签.App的名字.Activity注册等等 使用HBuilder开发移 ...

  4. times、 time、clock函数说明

    sysconf( _SC_CLK_TCK )  功能  获取系统的 时钟滴答的频率. clock_gettime() clock()返回的是各个线程运行cpu时间的和, 返回值一直都是0. 定义函数: ...

  5. 使用rosbag记录openni2_launch消息

    首先看教程 http://wiki.ros.org/openni_launch/Tutorials/BagRecordingPlayback http://wiki.ros.org/Bags http ...

  6. [xunsearch] 在thinkphp中使用xunsearch

    file: XunSearchController.class.php <?php namespace Home\Controller; include '/opt/xunsearch/sdk/ ...

  7. 直接利用本地git上传项目到github

    http://m.blog.csdn.net/article/details?id=50441442 本文将详细介绍如何托管你的项目到github上   转载请标明出处: http://blog.cs ...

  8. 简单DP【p1934】封印

    Description 很久以前,魔界大旱,水井全部干涸,温度也越来越高.为了拯救居民,夜叉族国王龙溟希望能打破神魔之井,进入人界"窃取"水灵珠,以修复大地水脉.可是六界之间皆有封 ...

  9. 7、Flask实战第7天:Jinjia2模板

    Jinja2模板介绍和查找路径 在前面的章节中,视图只是直接返回文本,然而在实际生产环境中其实很少这样用,因为实际的页面大多带有样式和复杂逻辑的HTML代码,这可以让浏览器其渲染出非常漂亮的页面. 我 ...

  10. [CEOI2017]One-Way Streets

    题目大意: 给你一个无向图,现在告诉你一些点对(u,v), 要你在保证从u到v的所有路径都不变的情况下,尽可能把所有的边变成单向边, 问你可以唯一确定哪些边的方向,以及方向是从u到v还是从v到u. 思 ...