Retrofit 的使用

Retrofit

一、概述

Retrofit是Square公司开发的一个类型安全的Java和Android 的HTTP客户端库。

A type-safe HTTP client for Android and Java.

二、简单使用

• 采用豆瓣电影TOP250的API

1. 添加 gradle 依赖

• 通过 Android Studio - File - Project Structure - app - Dependencies - “+” - Library Dependency 里搜索添加
• 通过到官网查询最新依赖，并在 build.gradle 里添加

compile 'com.squareup.retrofit2:retrofit:2.2.0'compile 'com.google.code.gson:gson:2.8.0'compile 'com.squareup.retrofit2:converter-gson:2.2.0'

2. 在 AndroidManifest.xml 里加入网络访问权限

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

3. 创建 MovieEntity 实体类，解析服务器返回的 JSON 数据

• 建议使用 Gson 解析，使用 GsonFormat 或 GsonOrXmlFormat 插件一键生成

// 代码不贴了

4. 创建一个Java接口 ApiService 来作为HTTP请求接口

public interface ApiService {    @GET("top250")    Call<MovieEntity> getTopMovies(@Query("start") int start, @Query("count") int count);    }

5. 实例化 Retrofit ，并通过 Retrofit 对象实现上面的接口

String baseUrl = "https://api.douban.com/v2/movie/";Retrofit retrofit = new Retrofit        .Builder()        .baseUrl(baseUrl)        .addConverterFactory(GsonConverterFactory.create())        .build();ApiService apiService = retrofit.create(ApiService.class);

6. 通过接口发起请求

• 同步调用

MovieEntity movieEntity = call.execute();

• 异步调用

Call<MovieEntity> call = apiService.getTopMovies(0,10);call.enqueue(new Callback<MovieEntity>() {    @Override    public void onResponse(Call<MovieEntity> call, Response<MovieEntity> response) {        // 处理请求返回的数据    }    @Override    public void onFailure(Call<MovieEntity> call, Throwable t) {        // 请求错误处理    }});

7. 取消请求,即使是正在执行的请求,也能够立即终止。

call.cancel();

• 效果图
  

源码：https://github.com/bazhancong/SimpleRetrofitDemo

---

参考：

1. RxJava 与 Retrofit 结合的最佳实践

2. Retrofit官网