Android中Retrofit的混淆 安卓 retrofit

简介

Retrofit是Square开发的一个Android和Java的REST客户端库。这个库非常简单并且具有很多特性，相比其他的网络库，更容易让初学者快速掌握。它可以处理GET、POST、PUT、DELETE…等请求，还可以使用picasso加载图片。

为什么要使用retrofit，看一下下面一张图就明了了。

实现步骤

1、添加Retrofit库到项目中
MAVEN

<dependency>
  <groupId>com.squareup.retrofit2</groupId>
  <artifactId>retrofit</artifactId>
  <version>2.0.0-beta3</version>
</dependency>

或者Gradle

compile 'com.squareup.retrofit2:retrofit:2.0.0-beta3'

2、添加网络权限

<uses-permission android:name="android.permission.INTERNET" />

3、实例化Retrofit

Retrofit retrofit = new Retrofit.Builder()
            .baseUrl(HttpUtil.URL_BASE)
            .build();

baseUrl里面的一般都放基本的链接

在Retrofit 2.0中，OkHttp 是必须的，并且自动设置为了依赖，OkHttp已经自动被用作HTTP 接口。下面的代码是从Retrofit 2.0的pom文件中抓取的。你不需要再做任何事情了。

<okhttp.version>3.0.0</okhttp.version>

      <dependency>
        <groupId>com.squareup.okhttp3</groupId>
        <artifactId>okhttp</artifactId>
        <version>${okhttp.version}</version>
      </dependency>

4、设置解析库
在Retrofit 2.0中，Converter 不再包含在package 中了。你需要自己插入一个Converter， 不然的话Retrofit 只能接收字符串结果。同样的，Retrofit 2.0也不再依赖于Gson 。
如果你想接收json 结果并解析成DAO，你必须把Gson Converter 作为一个独立的依赖添加进来。

compile 'com.squareup.retrofit2:converter-gson:2.0.0-beta3'

然后使用addConverterFactory把它添加进来。注意RestAdapter的别名仍然为Retrofit。

Retrofit retrofit = new Retrofit.Builder()
                .baseUrl(HttpUtil.URL_BASE)
                .addConverterFactory(GsonConverterFactory.create())
                .build();

注意：
如果你不需要解析json，只要字符串，那就不需要使用addConverterFactory。

当然，Retrofit 2 现在支持许多种解析方式来解析响应数据，如下：

Gson: com.squareup.retrofit2:converter-gson
Jackson: com.squareup.retrofit2:converter-jackson
Moshi: com.squareup.retrofit2:converter-moshi
Protobuf: com.squareup.retrofit2:converter-protobuf
Wire: com.squareup.retrofit2:converter-wire
Simple XML: com.squareup.retrofit2:converter-simplexml
Scalars (primitives, boxed, and String): com.squareup.retrofit2:converter-scalars

5、service接口

public interface APIService {

    @GET("getForumNoteListV1.0.php")
    Call<JsonObjectResult<JsonArrayResult<NoteListModel>>> loadForumNoteList(@Query("plateItemID") String plateItemID,@Query("searchType") String searchType,@Query("index") int index);

    @GET("adat/sk/{cityId}.html")
    Call<ResponseBody> getWeather(@Path("cityId") String cityId);
}

如上述代码中的2个Endpoints，需要提醒以下几点：
a)@GET是指用get请求，@POST是指post请求

b)Retrofit 2后，返回值始终是一个参数化了的Call<T>对象,比如
Call<JsonObjectResult<JsonArrayResult<NoteListModel>>>。如果你不需要任何类型安全的响应，你可以把返回值指定为Call<ResponseBody>。

c)一般地，base URL是在实例化 Retrofit instance的时候定义的。Retrofit 2 允许你在注解里面重写base URL 。例如HttpUtil.URL_BASE的值为
http://www.xxxx.com/appapi/，那么第一个Endpoints的地址就是
http://www.xxxx.com/appapi/getForumNoteListV1.0.php
当然，写法不同，地址就不同，出于安全考虑，
建议：
- Base URL: 总是以 /结尾
- @Url: 不要以 / 开头

d)每个endpoint 都指定了一个关于HTTP(GET, POST, 等等。) 方法的注解以及用于分发网络调用的方法。而且这些方法的参数也可以有特殊的注解。

6、接口请求
做好了上述准备后，就可以在代码中请求数据了。

public void loadData(final String plateItemID, final String plateItemName, String searchType, int page) {

        Retrofit retrofit = new Retrofit.Builder()
                .baseUrl(HttpUtil.URL_BASE)
                .addConverterFactory(GsonConverterFactory.create())
                .build();

        APIService service = retrofit.create(APIService.class);
        Call<JsonObjectResult<JsonArrayResult<NoteListModel>>> call = service.loadForumNoteList(plateItemID, searchType, page);

        call.enqueue(new Callback<JsonObjectResult<JsonArrayResult<NoteListModel>>>() {
            @Override
            public void onResponse(Response<JsonObjectResult<JsonArrayResult<NoteListModel>>> response) {
                modelList.clear();
                String mTotalCount = "";

                String success = response.body().getSuccess();
                LogCat.i("success=" + success);

                if (success != null && success.equals(Constant.JSON_SUCCESS_BACK)) {
                    modelList = response.body().getData().getDataList();
                    mTotalCount = response.body().getData().getTotalCount();
                    LogCat.i("mTotalCount=" + mTotalCount);
                }
            }

            @Override
            public void onFailure(Throwable t) {
            }
        });

    }

以上代码发起了一个在后台线程的请求并从response 的response.body()方法中获取一个结果对象。注意这里的onResponse和onFailure方法是在主线程中调用的。