Retrofit的简单使用

Retrofit的特性

1. Retrofit是对OKHttp的封装，OKHttp有的功能，Retrofit基本都有。
2. Retrofit将网络请求的方法转变成了接口(interface),通过自定义网络请求接口中的方法,通过Retrofit载入,最后调用自定义接口中的方法完成网络请求
3. 更多请参考官网介绍 http://square.github.io/retrofit/

具体使用

1. 在build.gradle(app)中添加依赖

//retrofit的jar包
compile 'com.squareup.retrofit2:retrofit:2.3.0'
//Gson解析工具
compile 'com.google.code.gson:gson:2.8.1'
//Retrofit将利用Gson转化成Java对象的工具
compile 'com.squareup.retrofit2:converter-gson:2.3.0'

2.构建自定义的接口

public interface MyRetrofit {
    //测试http地址的baseUrl为 "http://news-at.zhihu.com/"  (知乎日报的API)

    //会将下面的路径拼接到baseurl后面
    //返回的对象是JavaBean
    @GET("api/4/stories/latest")
    Call<JavaBean> getSimpleData();

    //@Path后面的参数会自动填充到{city}中,city相当于一个占位符
    @GET("weather_mini?city={city}")
    Call<Response> getString(@Path("city") String cityname);
}

更多注解请参考Retrofit官方介绍: http://square.github.io/retrofit/

3.具体使用

//1.创建Retrofit对象,实际上是使用了builder模式创建的
        Retrofit retrofit = new Retrofit.Builder()
                .baseUrl("http://news-at.zhihu.com/")   //基本Url,MyRetrofit中的"api/4/stories/latest"将会自动拼接到此链接后面          .addConverterFactory(GsonConverterFactory.create())   //也可以使用添加Gson转换器转换数据
                .build();

        //Retrofit根据MyRetrofit.class创建实例
        MyRetrofit myRetrofit = retrofit.create(MyRetrofit.class);
//2.
        Call<JavaBean> simpleData = myRetrofit.getSimpleData();

//3.执行
        simpleData.enqueue(new Callback<JavaBean>() {
            @Override
            public void onResponse(Call<JavaBean> call, Response<JavaBean> response) {
//                String result = null;
//                try {
//                    //从responsebody中获取得到url传回的数据
//                } catch (IOException e) {
//                    e.printStackTrace();
//                }
//                Gson gson = new Gson();
////                Log.d("xxx",result);
//                JavaBean javaBean = gson.fromJson(result, JavaBean.class);

                JavaBean body = response.body();
                Log.d("xxx", "javaBeans date : " + body.date);
            }

            @Override
            public void onFailure(Call<JavaBean> call, Throwable t) {
                Log.d("xxx", "javaBeans date : 出错啦!!!!" + t.getMessage());

            }
        });

注意:如果使用了GsonConverterFactory,对应的javaben类也应该按照gson的要求来写