如何使用Retrofit请求非Restful API.docVIP

如何使用Retrofit请求非Restful API 前言 2016年以来，越来越多Android开发者使用Retrofit作为HTTP请求框架。原因其一，Google发布Android 6.0 SDK (API 23) 抛弃了HttpClient；其二，Square在2016.1.2发布okhttp3.0、2016.3.11正式发布Retrofit 2.0。 HttpClient时代 作为深受Apache HttpClient毒害的一代青年，不得不吐槽HttpClient的版本维护和API文档有多糟糕。诟病缠身的HttpClient从3.x到4.x，api变更面目全非，甚至4.0-4.5，api改动也不少。如果你以前使用3.x，升级到4.0后，http代码几乎全改了。大家可以看看Apache官网看看httpClient发布历史（3.x历史、4.x历史）。文档嘛，Apache官网简直....连程序猿这审美观都不想看！ HttpClient发展历史相当长，最早是2001.10发布2.0-alpha 1，2004.11发布3.0-beta1，2008.1发布4.0-beta1，直到2012.2才发布4.2-beta1，2014.12发布4.4-release，2016.1发布5.0-alpha。由于源远流长，httpClient在国人心中根心蒂固。可以想象当年读书(也就4年前嘻嘻^_^)，翻墙未普及，天朝百度蛮横，搜“java http请求”出来的几乎都是httpClient（不信你现在百度）。 2013年以来，Google逐渐意识到httpClient的诟病，狠心之下，抛弃httpClient，因为我们有更好的选择：okhttp. OkHttp 美国移动支付公司Square，在2013.5.6开源一款 java http请求框架——OkHttp. 发布之后，在国外迅速流行起来，一方面是httpClient太繁琐、更新慢，另一方面okHttp确实好用。okHttp发布之后不断地改进，2014.5发布2.0-rc1，2016.1发布3.0，更新速度相当快，而且开发人员经常对代码进行维护，看看http://square.github.io/okhttp就知道了。相比之下，httpClient维护相当糟糕。 Api文档方面，我非常喜欢Square公司的设计风格，okHttp首页相当简洁，Overview、Example、Download全在首页展示，详细使用案例、说明，在github上很清晰。 Retrofit 从发布历史上来看，Retrofit和okhttp是兄弟，Square公司在2013.5.13发布1.0，2015.8发布2.0-beta1。 Retrofit底层基于OkHttp·，并且可以加很多Square开发的“周边产品”：converter-gson、adapter-rxjava等。Retrofit抱着gsonrxjava的大腿，这种聪明做法，也是最近大受欢迎的原因之一，所谓“Rxjava火了，Retrofit也火了”。Retrofit·不仅仅支持这两种周边，我们可以自定义convertercall adapter，可以你喜欢的其他第三方库。 介绍了主流java http请求库历史，大家对“为什么用retrofit”有个印象了吧？想想，如果没有Square公司，apahce httpClient还将毒害多少无知青年。 何为非Restful Api? Restful Api User数据，有uid、name，Restful Api返回数据： { name: kkmike999, uid: 1 } 在数据库没找到User，直接返回错误的http code。但弊端是当在浏览器调试api，后端查询出错时，很难查看错误码错误信息。（当然用chrome的开发者工具可以看，但麻烦） Not Restful Api 但不少后端工程师，并不一定喜欢用Restful Api，他们会自己在json中加入ret、msg这种数据。当User正确返回： { ret: 0, msg: 成功, data: { uid: 1, name: kkmike999 } } 错误返回： { ret: -1, msg: 失败 } 这样的好处，就是调试api方便，在任意浏览器都可以直观地看到错误码错误信息。 Retrofit一般用法 本来Retrofit对restful的支持，可以让我们写少很多冤枉代码。但后端这么搞一套，前端怎么玩呀？既然木已成舟，我们做APP的总不能老对后端指手画脚，友谊小船说翻就翻。 先说说retrofit普通用法 public class User