使用Retrofit2.0实现GoogleDrive相关API

做移动开发的相信对Retrofit一点也不陌生，它是一套RESTful架构的Android(Java)客户端实现，可以利用接口，方法和注解参数（parameter annotations）来声明式定义一个请求应该如何被创建。它的出现使我们只需关注接口所定义的功能而非拘泥于具体实现中，极大简化和提升了开发效率。

Retrofit2.0实现接口定义

根据上面的接口描述我们可以用Retrofit如下定义出接口：（注意@FormUrlEncoded和@Multipart必不可少否则会抛出异常，@Part可以描述Multipart中的某part数据，@Field描述Post的某字段）

public interface DriveApi {

    @POST("oauth2/v4/token")
    @FormUrlEncoded
    Call<Token> requestToken(
            @Field("client_id") String clientId,
            @Field("client_secret") String clientSecret,
            @Field("code") String code,
            @Field("redirect_uri") String redirectUri,
            @Field("grant_type") String grantType);

    @POST("oauth2/v4/token")
    @FormUrlEncoded
    Call<Token> requestTokenRefresh(
            @Field("refresh_token") String refreshToken,
            @Field("client_id") String clientId,
            @Field("client_secret") String clientSecret,
            @Field("grant_type") String grantType);

    @GET("oauth2/v3/userinfo")
    Call<UserInfo> requestUserInfo(
            @Header("Authorization") String authToken);

    @POST("upload/drive/v3/files?uploadType=multipart")
    @Multipart
    Call<UploadResult> uploadFileMutil(
            @Header("Authorization") String authToken,
            @Part MultipartBody.Part metaPart,
            @Part MultipartBody.Part dataPart);
}

然后通过Retrofit对象的create()方法即可实例化上述接口，完全不需要关注具体的实现，只需关注接口的参数和返回值就OK了，是不是爽到爆？这里用到了GsonConverterFactory，自动将返回的json数据转换为POJO，默认是根据POJO类的字段名实现映射。

Retrofit retrofit = new Retrofit.Builder()
    .baseUrl("https://www.googleapis.com/")
    .addConverterFactory(GsonConverterFactory.create())
    .build();
DriveApi driveApi = retrofit.create(DriveApi.class);

接下来就是使用DriveApi进行接口的调用了。在Retrofit2.0中，接口的定义统一返回Call对象，与1.x版本相比变化还是挺大的。2.0中如果要调用同步请求，只需调用Call对象的execute()方法，调用enqueue()则可以发起一个异步请求。

同步请求：

// Synchronous Call in Retrofit 2.0
  
Call<Token> call = driveApi.requestToken();
Token token = call.execute();

异步请求：

// Asynchronous Call in Retrofit 2.0
  
Call<Token> call = driveApi.requestToken();
call.enqueue(new Callback<Token>() {
    @Override
    public void onResponse(Response<Token> response) {
        // Get result Token from response.body()
    }
  
    @Override
    public void onFailure(Throwable t) {
  
    }
});

取消请求（直接cacel()即可，2.0统一改成返回call对象可以方便的让我们直接取消正在进行的请求）
1
call.cancel();

有关Retrofit2.0的一些改进，建议可以看下面这篇：Retrofit 2.0：有史以来最大的改进，总结得挺全面的。

最后别忘记添加相关依赖：

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile 'com.squareup.okhttp3:okhttp:3.2.0'
    compile 'com.squareup.retrofit2:retrofit:2.0.0'
    compile 'com.squareup.retrofit2:converter-gson:2.0.0'
}

相关API接口及请求参数

Retrofit2.0实现接口定义