Retrofit使用教程(一)- Retrofit入门详解
转载请注明博客地址:http://blog.csdn.net/gdutxiaoxu/article/details/52745491
源码下载地址:https://github.com/gdutxiaoxu/RetrofitDemo.git
本人已经好久没有更新 博客了,这次更新博客打算写一下retrofit的使用教程系列的 博客,写作思路大概如下
- 先从retrofit的基本使用讲起;
- 接着将retrofit结合RxJava的使用;
- 接着讲Retrofit的封装使用,(包括错误统一处理);
- 有时间和能力的话会尝试研究一下retrofit的 源码.
本篇博客主要讲解以下问题
- Retrofit简介
- Retrofit的简单使用例子
- Retrofit的get请求
- Retrofit的put请求(提交表单数据)
- 如何为 retrofit添加header
- 如何提交json数据
Retrofit简介
Retrofit是square开源的网络请求库,底层是使用OKHttp封装的,网络请求速度很快.
主要有一下几种请求方法
格式 | 含义 |
---|---|
@GET | 表示这是一个GET请求 |
@POST | 表示这个一个POST请求 |
@PUT | 表示这是一个PUT请求 |
@DELETE | 表示这是一个DELETE请求 |
@HEAD | 表示这是一个HEAD请求 |
@OPTIONS | 表示这是一个OPTION请求 |
@PATCH | 表示这是一个PAT请求 |
各种请求注解的意思
格式 | 含义 |
---|---|
@Headers | 添加请求头 |
@Path | 替换路径 |
@Query | 替代参数值,通常是结合get请求的 |
@FormUrlEncoded | 用表单数据提交 |
@Field | 替换参数值,是结合post请求的 |
Retrofit的简单使用例子
要使用retrofit请求网络数据,大概可以分为以下几步
- 1)添加依赖,这里以AndroidStudio为例:在build.grale添加如下依赖
compile 'com.squareup.retrofit2:retrofit:2.1.0'
compile 'com.squareup.retrofit2:converter-gson:2.1.0'
- 1
- 2
- 1
- 2
- 2) 创建Retrofit对象
Retrofit retrofit = new Retrofit.Builder()//使用自定义的mGsonConverterFactory.addConverterFactory(GsonConverterFactory.create()).baseUrl("http://apis.baidu.com/txapi/").build();
mApi = retrofit.create(APi.class);
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 3)发起网络请求
mApi = retrofit.create(APi.class);
Call<News> news = mApi.getNews("1", "10");
news.enqueue(new Callback<News>() {@Overridepublic void onResponse(Call<News> call, Response<News> response) {}@Overridepublic void onFailure(Call<News> call, Throwable t) {}
});
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
public interface APi {@Headers("apikey:81bf9da930c7f9825a3c3383f1d8d766")@GET("word/word")Call<News> getNews(@Query("num") String num,@Query("page")String page);
}
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 1
- 2
- 3
- 4
- 5
- 6
- 7
到此一个简单的使用retrofit的网络请求就完成了。接下来我们来了解retrofit的各种请求方式。
Retrofit的get请求
加入我们想请求这样的网址:http://apis.baidu.com/txapi/world/world?num=10&page=1,header为”apikey:81bf9da930c7f9825a3c3383f1d8d766”,我们可以这样请求:
第一步,在interface Api中 增加如下方法
@Headers("apikey:81bf9da930c7f9825a3c3383f1d8d766")@GET("word/word")Call<News> getNews(@Query("num") String num,@Query("page")String page);
- 1
- 2
- 3
- 4
- 5
- 1
- 2
- 3
- 4
- 5
第二部,在代码里面请求
//创建retrofit对象
Retrofit retrofit = new Retrofit.Builder()//使用自定义的mGsonConverterFactory.addConverterFactory(GsonConverterFactory.create()).baseUrl("http://apis.baidu.com/txapi/").build();
// 实例化我们的mApi对象
mApi = retrofit.create(APi.class); // 调用我们的响应的方法
Call<News> news = mApi.getNews(number, page);
news.enqueue(new Callback<News>() {@Overridepublic void onResponse(Call<News> call, Response<News> response) {News body = response.body();Logger.i("onResponse: ="+body.toString());}@Overridepublic void onFailure(Call<News> call, Throwable t) {Logger.i("onResponse: ="+t.getMessage());}
});
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
解释说明
假设BaseUrl是http://apis.baidu.com/txapi/的前提下
- 1)其中 @GET(“word/word”)会追加到baseUrl :http://apis.baidu.com/txapi/的后面,即变成:http://apis.baidu.com/txapi/world/world
- 2)@Query(“num”) String num,@Query(“page”)String page;分别对应键值的名称与值。会追加到http://apis.baidu.com/txapi/world/world的后面,请求网址即变成:http://apis.baidu.com/txapi/world/world?num=10&page=1
- 3) @Headers(“apikey:81bf9da930c7f9825a3c3383f1d8d766”)是 在基础之上为 其添加响应头
4)如果想继续增加参数,只需要在方法参数追加这样的形式就OK了:
,@Query(“page”)String page@Headers("apikey:81bf9da930c7f9825a3c3383f1d8d766") @GET("word/word") Call<News> getNews(@Query("num") String num,@Query("page")String page,@Query("type") String type);
- 1
- 2
- 3
- 1
- 2
- 3
5)加入我们想要请求这样的网址http://apis.baidu.com/txapi/tiyu/tiyu?num=10&page=1,,我们可以这样写
@Headers({"apikey:81bf9da930c7f9825a3c3383f1d8d766" ,"Content-Type:application/json"}) @GET("{type}/{type}") Call<News> tiYu(@Path("type") String type, @Query("num") String num,@Query("page")String page); String type="tiyu"; Call<News> news = api.tiYu(type,number, page);
- 1
- 2
- 3
- 4
- 5
- 1
- 2
- 3
- 4
- 5
retrofit的post请求
假如我们想要 请求这样的网址http://apis.baidu.com/txapi/world/world?以post的 方式提交这样的 数据:num=10&page=1,我们可以写成 如下的 样子,注意post的时候必须使用@Field这种形式的注解,而不是使用@Query这种形式的注解,其他的 与get请求一样,这样只给出核心代码
@FormUrlEncoded
@Headers({"apikey:81bf9da930c7f9825a3c3383f1d8d766" ,"Content-Type:application/json"})
@POST("world/world")
Call<News> postNews(@Field("num") String num, @Field("page")String page);
- 1
- 2
- 3
- 4
- 5
- 6
- 1
- 2
- 3
- 4
- 5
- 6
如何为retrofit添加请求头head
总共有以下几种方式
第一种方法
在OKHttpClient interceptors里面进行处理,这样添加的headKey不会覆盖掉 前面的 headKey
okHttpClient.interceptors().add(new Interceptor() { @Overridepublic Response intercept(Interceptor.Chain chain) throws IOException {Request original = chain.request();// Request customization: add request headersRequest.Builder requestBuilder = original.newBuilder().addHeader("header-key", "value1").addHeader("header-key", "value2");Request request = requestBuilder.build();return chain.proceed(request);}
});
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
第二种方法
同样在在OKHttpClient interceptors里面进行处理,这样添加的headKey会覆盖掉 前面的 headKey
okHttpClient.interceptors().add(new Interceptor() { @Overridepublic Response intercept(Interceptor.Chain chain) throws IOException {Request original = chain.request();// Request customization: add request headersRequest.Builder requestBuilder = original.newBuilder().header("headerkey", "header-value"); // <-- this is the important lineRequest request = requestBuilder.build();return chain.proceed(request);}
});
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
第三种方法
利用 retrofit自带的注解,比如我们想要添加这样的请求头:”apikey:81bf9da930c7f9825a3c3383f1d8d766” ,”Content-Type:application/json”;则可以写成如下的 样式
@Headers({"apikey:81bf9da930c7f9825a3c3383f1d8d766" ,"Content-Type:application/json"})
@GET("world/world")
Call<News> getNews(@Query("num") String num,@Query("page")String page);
- 1
- 2
- 3
- 4
- 5
- 1
- 2
- 3
- 4
- 5
通过post提交json数据
Post 提交JSON数据
有时提交的数据量比较大时,用键值对的方式提交参数不太方便,Retrofit可以通过@Body注释,直接传递一个对象给请求主体,Retrofit通过JSON转化器,把对象映射成JSON数据。
假设我们需要提交的数据为
{"id": 1,"text": "my task title"
}
- 1
- 2
- 3
- 4
- 1
- 2
- 3
- 4
接口定义:
public interface TaskService { @Headers({"Content-Type: application/json","Accept: application/json"}) @POST("/tasks") Call<Task> createTask(@Body Task task); }
- 1
- 2
- 3
- 4
- 5
- 1
- 2
- 3
- 4
- 5
传递实体需要有Model:
public class Task { private long id; private String text;public Task() {} public Task(long id, String text) {this.id = id;this.text = text; } }
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
客户端调用:
Task task = new Task(1, "my task title"); Call<Task> call = taskService.createTask(task); call.enqueue(new Callback<Task>() {});
- 1
- 2
- 3
- 1
- 2
- 3
这样,服务端得到的是JOSN数据:
{ "id": 1, "text": "my task title" }
- 1
- 2
- 3
- 4
- 1
- 2
- 3
- 4
到此,这篇博客为止
题外话:
其实retrofit在5月份实习的时候就接触了,之前为什么不写 博客了,因为网上的 使用教程很多,觉得没有必要。到后面学习的时候,发现retrofit的使用时 比较灵活的,并且使用方法也是相对较多的,于是,就写了retrofit这系列的使用博客。
转载请注明博客地址:http://blog.csdn.net/gdutxiaoxu/article/details/52745491
源码下载地址:https://github.com/gdutxiaoxu/RetrofitDemo.git
参考官网地址http://square.github.io/retrofit/
Retrofit使用教程(一)- Retrofit入门详解相关推荐
- xposed模块编写教程_Xposed插件开发入门详解,
Xposed插件开发入门详解, 前言 Xposed的用处不必言说,能hook任意java写的代码,修改替换apk内部的资源文件. 至于如何开发一个XPosed的插件,官方给出的答案如下: https: ...
- xposed模块编写教程_Xposed插件开发入门详解
前言 Xposed的用处不必言说,能hook任意java写的代码,修改替换apk内部的资源文件. 至于如何开发一个XPosed的插件,官方给出的答案如下: 看完这篇文章,基本能写出一个最简单的demo ...
- python语言入门详解-python初级教程:入门详解
python初级教程:入门详解 Crifan Li 目录 前言 .................................................................... ...
- Java Spring框架入门详解教程【多测师_何sir】
Spring框架入门详解教程 spring概述 spring结构 spring IOC spring DI spring概述 Spring是一个非常活跃的开源框架, 它是一个基于IOC和AOP来构架多 ...
- 【GCN】图卷积网络(GCN)入门详解
机器学习算法与自然语言处理出品 @公众号原创专栏作者 Don.hub 单位 | 京东算法工程师 学校 | 帝国理工大学 图卷积网络(GCN)入门详解 什么是GCN GCN 概述 模型定义 数学推导 G ...
- 【JSON】JSON入门详解(二)
文章目录 JSON基础文章荐读 JavaScript创建JSON对象 JSON与XML的那些事 JSON与XML的相同之处 JSON与XML的不同之处 AJAX相关JSON与XML JSON与XML的 ...
- mac电脑使用入门详解
大家来到MAC系统以后,首先在使用习惯以及界面上,都需要有一个适应的过程,小编为大家整理了这个小白教程,有助于你快速习惯这个MAC系统. 讲个笑话: 我一朋友看到Mac界面很酷,就买了个Mac笔记本, ...
- Jetpack Compose入门详解(实时更新)
Jetpack Compose入门详解 前排提醒 前言(Compose是什么) 1.实战准备 一.优势与缺点 二.前四课 三.标准布局组件 1.Column 2.Row 3.Box 四.xml和com ...
- FFmpeg入门详解之104:Win10快速安装OpenSSL(不用编译源码)
win10x64安装OpenSSL:不用编译源码 网上一堆的教程教你去下载opensll源代码并用vs进行编译,虽然我有安装vs2015,但是看到那么长的编译步骤,太心累了. 懒人只得找简单的方法,最 ...
- html5离线存储图片,HTML5教程 离线存储技术详解
本篇教程探讨了HTML5教程 离线存储技术详解,希望阅读本篇文章以后大家有所收获,帮助大家HTML5+CSS3从入门到精通 . < 随着Web App的发展,越来越多的移动端App使用HTML5 ...
最新文章
- Windows下创建进程简介
- 云计算之路:数据库迁移方案
- java web 显示项目下的图片_[适合初中级Java程序员修炼手册从0搭建整个Web项目](一)...
- Visual Studio 2017常用快捷键(小白入)
- 查询一个表中某个字段最大值的集合
- 3.1 哈尔空间 V0
- Leetcode--22. 括号生成
- 一杯水怎么测试_天气渐热食欲差、体质虚怎么办?每天一杯能量水——驼奶
- 【分享】美图个性化Push AI探索之路(附交流视频和PPT下载链接)
- 使用windows live writer连接CSDN和博客园博客
- MDM主数据清洗和编码集成说明
- 2019腾讯后台开发详细面试流程
- iPhone提示“软件更新失败”下载时出错怎么办?教你解决!
- 树莓派3B+安装系统(Raspbian)以及配置环境
- 网络安全与计算机信息管理论文,计算机信息管理技术在网络安全的应用论文
- ArrayList.toArray()的用法
- 三菱系统四轴正反转参数_三菱M70四轴调试
- 轮训、长轮训、长连接
- 继Pyecharts之后,蚂蚁又开源一款国产可视化利器
- 微信小程序蓝牙模块通信
热门文章
- 爱快路由,通过域名分流解决QQ网吧特权不生效的问题
- (八)冰点还原安装及使用
- 最新主流 Markdown 编辑器推荐
- linux 所有软件免费,Linux 系统下常用软件一览表
- xml文件怎么转换成wps_Office 12使用XML格式存储文件 正式回击WPS
- ElasticJob‐Lite:扩展作业类型
- 左程云算法笔记(三)堆排序、桶排序、排序总结
- js根据身份证获取性别、年龄、出生日期及根据出生日期获取年龄
- 三星c9000刷android7.0,三星C9 Pro C9000官方原厂rom线刷包刷机包C9000ZCU1CRI1
- [产品经理]产品管理的工作流程