Retrofit的基本使用

retrofit介绍

Retrofit与okhttp共同出自于Square公司，retrofit就是对okhttp做了一层封装。把网络请求都交给给了Okhttp，我们只需要通过简单的配置就能使用retrofit来进行网络请求了，其主要作者是Android大神JakeWharton
有兴趣的可以到官网查看：
retorfit官网

retrofit使用

导包

直接build gradle里添加依赖就可以了:

//Retrofit2所需要的包
compile ‘com.squareup.retrofit2:retrofit:2.0.0-beta4’
//ConverterFactory的Gson依赖包
compile ‘com.squareup.retrofit2:converter-gson:2.0.0-beta4’
//ConverterFactory的String依赖包
compile ‘com.squareup.retrofit2:converter-scalars:2.0.0-beta4’

使用

Retrofit提供的请求方式注解有@GET和@POST，参数注解有@PATH和@Query等
详细的注解对应的解释及处理方式
可参考此文章：http://blog.csdn.net/fuhao476200/article/details/52980318

Get请求

示例：
创建RetrofitNetService业务访问接口添加如下注解:

 @GET("goods/{id}") Call<ResponseBody> getgoods(@Path("id") int id);

Call ，此处T是返回的数据类型，如知道则可填写相对应的类型，如不知则可用泛型代替，或者ResponseBody代替。
@Path用于替换Url路径中的变量字符，这里的参数id会被填充至{id}中，形成完整的Url请求地址，{id}相当于一个占位符；

示例：

    @GET("book/search")    Call<BookSearchResponse> getSearchBooks( @Query("name") String name,     @Query("tag") String tag);                                                                                   

@Query
用于拼接在Url路径后的查询参数，但相对于直接在Url后拼接，@Query则是添加一个变量：类似BaseUrl+book/search？name={name}&type={type}
推荐：
类型及对应url模式可以查看

@QueryMap与Query一样，只不过是多个参数示例：

  @GET("News")  Call<NewsBean> getItem(@QueryMap Map<String, String> map);

或者

  @GET("News")  Call<NewsBean> getItem( @Query("newsId") String newsId，@QueryMap Map<String, String> map);

post请求

@Post post请求大约有四种方式，常用的就两种，
以键值对表单提交方式：

  @FormUrlEncoded    @POST("Comments/{newsId}")    Call<Comment> reportComment(        @Path("newsId") String commentId,        @Query("access_token") String access_token,        @Field("reason") String reason);

@body类型提交方式：
RequestBody

//登入接口       @Headers({"Contenttype:application/json;charset=UTF-8"})     @POST("login")    Call<LoginReturnBean> loginApp(@Body RequestBody requestBody);    

添加header

使用注解的方式

添加一个Header参数

@Headers({"Contenttype:application/json;charset=UTF-8"})    @GET("/tasks")      Call<List<Task>> getTasks(); 

添加多个Header参数

  @Headers({          "Accept: application/vnd.yourapi.v1.full+json",          "User-Agent: Your-App-Name"      })      @GET("/tasks/{task_id}")      Call<Task> getTask(@Path("task_id") long taskId); 

动态添加Header

    @FormUrlEncoded    @POST("checkout")    Call<CheckOutResponse> checkout(@Header("userid") String userId, @FieldMap Map<String, String> params);

统一添加header

使用代码的方式，则需要使用拦截器

OkHttpClient.Builder httpClient = new OkHttpClient.Builder();    httpClient.addInterceptor(new Interceptor() {        @Override      public Response intercept(Interceptor.Chain chain) throws IOException {          Request original = chain.request();          Request request = original.newBuilder()              .header("token", "a")            .header("tokenb","b")                         .method(original.method(), original.body())              .build();          return chain.proceed(request);      }  }  OkHttpClient client = httpClient.build();    Retrofit retrofit = new Retrofit.Builder()        .baseUrl(API_BASE_URL)      .addConverterFactory(GsonConverterFactory.create())      .client(client)      .build();  

简单分装

** * @创建者 wyj * @创建时间 2017/11/8 10:22. * @描述 * @更新者 * @更新时间 2017/11/8 10:22. */public class RetrofitUtil {    private static Retrofit retrofit;    private static OkHttpClient.Builder sHttpClient;    private static OkHttpClient sClient;    /**     * @return retrofit 实例     */    public static Retrofit getRetrofitInstance() {        if (retrofit == null) {            synchronized (Retrofit.class) {                retrofit = new Retrofit.Builder()                        .baseUrl(Url.BaseUrl)                       .addConverterFactory(GsonConverterFactory.create())                        .client(getOkHttpClient())                        .build();            }        }        return retrofit;    }    private static OkHttpClient getOkHttpClient() {        if (sHttpClient == null) {            sHttpClient = new OkHttpClient.Builder();            sHttpClient.addInterceptor(new Interceptor() {                @Override                public okhttp3.Response intercept(Chain chain) throws IOException {                    Request original = chain.request();                    Request request = original.newBuilder()                            .addHeader("token","efgh")                            .addHeader("code","abcd")                            .method(original.method(), original.body())                            .build();                    return chain.proceed(request);                }            });            if (sClient == null) {                sClient = sHttpClient.build();            }        }        return  sClient;    }    /**     * @return 接口实例     */    public static RetrofitNetService getHttpServiceInstance() {         return  getRetrofitInstance().create(RetrofitNetService.class);    }}

使用方式：

 RetrofitNetService httpServiceInstance = RetrofitUtil.getHttpServiceInstance();RequestBody bod2y = RequestBody.create(MediaType.parse("application/json; charset=utf-8"),GsonTools.createGsonString(loginBody));        Call<LoginReturnBean> call = httpServiceInstance.loginApp(bod2y);   //同步请求     /*   try {            Response<LoginReturnBean> execute = call.execute();        } catch (IOException e) {            e.printStackTrace();        }*/        //异步请求        call.enqueue(new Callback<LoginReturnBean>() {           @Override           public void onResponse(Call<LoginReturnBean> call, Response<LoginReturnBean> response) {               if (response.isSuccessful()) {             LoginReturnBean body =response.body();                }           }           @Override           public void onFailure(Call<LoginReturnBean> call, Throwable t) {           }       });

关于http的一些基础知识：
http://www.jianshu.com/p/e544b7a76dac
使用方法参考文章：
http://www.jianshu.com/p/331f0bf161c2
http://www.jianshu.com/p/308f3c54abdd