retrofit 使用介绍（快速了解和集成retrofit）

一、简介

不废话！这里是retrofitGithub地址   这里是retrofit的官方文档  。单独学会使用retrofit  只需要进入github地址将最新的依赖包导入就可以使用  这里最新的是  jar包版本是 compile 'com.squareup.retrofit2:retrofit:2.2.0'  导入项目即可使用（retrfit包中已经自带了okhttp3的东西）。  然后只需要  定义跟地址  编写请求的接口  进行调用  三个步骤就可以使用retrofit了。

代码如下：

1.0 定义请求跟地址

public class Constant {

    public static String BaseURL = "http://litchiapi.jstv.com/";

}

2.0 定义请求接口（接口名字自己随意）

public interface Netinterface {
    
    @GET("api/GetFeeds?column=0&PageSize=20&pageIndex=1&val=100511D3BE5301280E0992C73A9DEC41")
    Call<LizhiNews> test01();
}

3.0  进行调用就可以实现请求了

 @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_retrfit);
        
        Retrofit retrofit = new Retrofit.Builder()
                .baseUrl(Constant.BaseURL)
                .build();
        Netinterface netinterface = retrofit.create(Netinterface.class);
        netinterface.test01().enqueue(new Callback<LizhiNews>() {
            @Override
            public void onResponse(Call<LizhiNews> call, Response<LizhiNews> response) {
                LizhiNews body = response.body();
                Log.e(TAG, body.toString());
            }
            @Override
            public void onFailure(Call<LizhiNews> call, Throwable t) {
            }
        });

    }

以上三步就可以实现retrofit的一个基本配置使用了。当然retrfit的使用绝对不仅仅局限于此  

二、配合Gson 、rxjava等使用

 为了配合Gson快速解析为java对象    要使用Gson进行解析  那就必须要导入Gson的依赖  studio里面自带有  就不在赘述了。 这里要说的是retrfit为了能够使用Gson解析还要添加一个Converters（转换器的依赖 、使用rxjava也是导入rxjava的依赖包  还要导入rxjava的转换器的依赖包）  最新的gson和rxjava等的converter是的包可以从Github项目中的一个叫做retrofit-converters中查找到  导入就可以就行使用了 。

  

然后剩下的就是根据项目需要去进行各种get post put 等等请求（建议不需要去过于苛刻的去记这些注解等等 只需要使用的时候查看文档就行）

这里借用一下 这是博主的原地址 这篇博客的案例（因为其确实讲解的很清晰）

  /** 
     * 通过@GET注解标记位get请求  @GET中填写baseUrl根路径后的路径 
     * 访问的网络地址由根路径和@GET注解后的路径连接组成 
     */  
  
//案例一：这种是将根路径后面的路径整个放入了get中进行拼接，相对比较简单，后期和根url拼接  
    @GET("api/GetFeeds?column=0&PageSize=20&pageIndex=1&val=100511D3BE5301280E0992C73A9DEC41")  
//此处的返回值可以自行设置，这里我就简单的让他返回请求体的内容：  
    Call<ResponseBody> getResonseBody();  
  
    @GET("api/GetFeeds?column=0&PageSize=20&pageIndex=1&val=100511D3BE5301280E0992C73A9DEC41")  
//案例二：此处的返回值我让他返回的是String类型，具体返回逻辑我一会儿在主方法中创建：  
 Call<String> getJsonString();  
  
//案例三：使用的是茶叶品牌的url,此处将根目录以后的部分进行了截取，但是返回的是一个Tea对象的集合,至于tea对象的生成大家一定都会使用Gson吧，这个我就不细说了。  
    @GET("category?app_id=161")  
    Call<List<Tea>> getTeas();  
  
//案例四：此处使用的是同案例一，但是path路径不确定的情况情况下，使用{type}代替，当做抽象方法中的一个参数进行接收，  
    @GET("api/{type}?column=0&PageSize=20&pageIndex=1&val=100511D3BE5301280E0992C73A9DEC41")  
//这里的path就是你要传入的type类型，这里@path“tyle”名称一定要和@get();中的type同名，  
    Call<NewsInfo> getNewsInfo(@Path("type") String type);//String type="GetFeeds"  
  
//案例五：有一个键值对的情况，如果不确定时，需要使用此方法，使用@query（键名）将你的值输入:  
    @GET("category")//category?app_id=161  
    Call<List<Tea>> getTeaByNetWork(@Query("app_id") int id);  
  
//案例六：如果键值对是很多的情况下，案例五很明先无法满足需要，这时候需要使用@querymap接收一个map集合来进行拼凑。  
    @GET("api/GetFeeds")  
    Call<NewsInfo> getInfoByNetWork(@QueryMap Map<String, String> map);  
  
//你也可以使用多种方式拼凑结合：使用{}，加上参数的拼接等，都是可以灵活运行  
案例七：  
//    @GET("api/{type}")  
//    Call<NewsInfo> getInfo(@Path("type") String type,@QueryMap Map<String,String> map);  
  
     //案例八：网络下载图片，  
    @GET("img")  
     Call<ResponseBody> downLoadImage();  
  
    //post形式提交表单数据  登录 注册，post需要服务器，这里无法进行演示，但是代码有，需要的话可以从自己的服务器中进行验证，  
    //@post注解说明采用post提交的形式 @Field("向服务器提交的key")  
    @POST("LoginServlet")  
    @FormUrlEncoded  
    Call<String> login(@Field("username") String userName,  
                       @Field("password") String password);  
  
  
    //上传单个文件 @Field和@Part 客户端向服务端携带参数发起请求  
    //@Part 可携带的参数类型更多样 数据流等  
    @Multipart  
    @POST("UpLoadAction")  
    Call<ResponseBody> upLoadFile(@Part("img") RequestBody body);  
  
  
    //可以上传表单中所有的数据  表单文本+附件  
    @POST("UpLoadAction")  
    Call<ResponseBody> upLoad(@Body() MultipartBody body);  

compile 'com.squareup.okhttp3:logging-interceptor:3.1.2'

最后附上 几篇可供参考的retrofit的使用的文章

文章01  文章02 文章03  文章04