Retrofit2网络框架的使用（一）

Retrofit是Square公司研究开发的网络请求框架，它是基于okhttp实现的。废话不多说，现在就介绍下retrofit的使用方法。
首先呢，它是一个第三方库，我们需要导入它的依赖库，即在我们gradle文件下的dependencies中导入我们的依赖库，如下所示：

    //Retrofit网络请求框架
    compile 'com.squareup.retrofit2:retrofit:2.1.0'
    compile 'com.squareup.retrofit2:converter-gson:2.1.0'

由于现在的项目中都有图片的展示，下面我需要引用到的依赖库依然还是Square公司推出的picasso这个图片下载和缓存的第三方库：

compile 'com.squareup.picasso:picasso:2.3.2'

准备工作做完了，下面开始我们今天的主题，它的使用方法。
首先我们需要创建一个业务请求接口，在这之前我们先来讲解下他在接口中用到的一些注解的含义：
1.@Query、@QueryMap
用于get请求传递参数，如下：

@GET("jsonstudy/list.do")
Call<Data> getData(@Query("page") int page,@Query("rows") int rows);

他就等同于：

 @GET("jsonstudy/list.do?page=page&rows=rows")
    Call<Data> getData();

就是把@Query的key-value添加到url后面组成get方式的参数,@QueryMap同理。

2.@Field
用于post请求传递参数,需要在请求接口方法上添加@FormUrlEncoded,即以表单的方式传递参数，如下:

 //post传值是动态的运行的
    @POST("user/login.do?")
    @FormUrlEncoded
    Call<LoginResult> getData(@Field("userName") String name, @Field("passWord") String pw);

3.@Body
用于post请求,它是根据转换方式将实例对象转化为对应字符串传递参数.比如Retrofit添加GsonConverterFactory则是将body转化为gson字符串进行传递.

4.@Path
用于URL上的占位符，如下所示:

@GET("user/{id}/login.do?")
Call<LoginResult> getData(@Path("id") int id);

意思也就是将id变量的值替换到url上的id位置,Path可以用于任何请求方式，包括Post，Put，Delete等等

5.@Part
配合@Multipart使用,一般用于文件上传:

 // 上传单个文件
    @Multipart
    @POST("upload")
    Call<ResponseBody> uploadFile(
            @Part("description") RequestBody description,
            @Part MultipartBody.Part file);

    // 上传多个文件
    @Multipart
    @POST("upload")
    Call<ResponseBody> uploadMultipleFiles(
            @Part("description") RequestBody description,
            @Part MultipartBody.Part file1,
            @Part MultipartBody.Part file2);

以上就是一些基本的注解的释义。

下面开始上代码，讲解详细用法：
（1）创建Retrofit的实例

Retrofit retrofit = new Retrofit.Builder()
                .baseUrl("http://192.168.0.108:8080/JsonStudy/")
                .addConverterFactory(GsonConverterFactory.create())
                .build();

（2）创建接口

interface ApiManager {
    @GET("jsonstudy/list.do?page=1&rows=18")
    Call<Data> getData();

     //post传值是动态的运行的
    @POST("user/login.do?")
    @FormUrlEncoded
    Call<LoginResult> getData(@Field("userName") String name, @Field("passWord") String pw);
}

（3）异步请求这个接口（接着创建Retrofit的实例往下写）

ApiManager apiService = retrofit.create(ApiManager.class);
        Call<LoginResult> call = apiService.getData("xiaoming", "1234");
        call.enqueue(new Callback<LoginResult>() {
            @Override
            public void onResponse(Call<LoginResult> call, Response<LoginResult> response) {
                Log.e("===", "执行了：" + response.raw());
                if (response.body().getCurrentUser() != null
                        && response.body().getCurrentUser().size() > 0
                        && response.body().getCode().equals("000")) {
                    LoginResult.CurrentUserBean bean = response.body().getCurrentUser().get(0);
                    Log.e("===", "bean:" + bean.getUserName());
                    text_go.setText(bean.getUserName());
                    Toast.makeText(MainActivity.this,"登录成功",Toast.LENGTH_SHORT).show();
                }else {
                    Toast.makeText(MainActivity.this,"用户不存在",Toast.LENGTH_SHORT).show();
                }
            }

            @Override
            public void onFailure(Call<LoginResult> call, Throwable t) {
                Log.e("===", "请求失败:" + call.request().url());
            }
        });

以上就是我写的一个简单的登录的操作。

到这里Retrofit的基本使用已经讲完了，这个新的框架也是最近刚学，可能还存在一些问题，欢迎大家指正。