Retrofit2.0使用-阿里云开发者社区

Retrofit2.0使用

2016-03-25 1238

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介： 转自：http://blog.csdn.net/qq_17766199/article/details/49946429 Retrofit项目Github主页：点击打开链接 Retrofit项目官方文档：点击打开链接首先是我参考的文章： ● Retrofit 2.0:有史以来最大的改进 ● 使用Retrofit请求API数据

转自：http://blog.csdn.net/qq_17766199/article/details/49946429

Retrofit项目Github主页：点击打开链接

Retrofit项目官方文档：点击打开链接

首先是我参考的文章：

● Retrofit 2.0:有史以来最大的改进

● 使用Retrofit请求API数据

● Retrofit2.0使用详解

● Retrofit 2.0使用详解，配合OkHttp、Gson，Android最强网络请求框架

● 用Retrofit 2 简化 HTTP 请求

这里感谢以上的作者对于 Retrofit使用的讲解，对我的帮助很大。

那么我根据自己的使用情况做一下汇总：因为也是第一次使用，没有接触过2.0之前的版本，所以不介绍与旧版区别。

1.设置

（1）权限：首先确保在AndroidManifest.xml中请求了网络权限：

[java]view plain copy 
     
 print?
 <uses-permission android:name="android.permission.INTERNET" />   

（2）Studio用户,在app/build.gradle文件中添加如下代码：

[java]view plain copy 
     
 print?
 dependencies {   
     compile 'com.squareup.retrofit:retrofit:2.0.0-beta2'   
     compile 'com.squareup.okhttp:okhttp:2.5.0'   
     compile 'com.squareup.okio:okio:1.6.0'   
 }   

Eclipse的用户，可以下载最新的jar：我将整理的jar包已上传：点击打开链接
注意：1.Retrofit必须使用okhttp请求了，如果项目中没有okhttp的依赖的话，肯定会出错。
2.okhttp内部依赖okio所以也要添加。

2.使用

（1）创建Retrofit实例

[java]view plain copy 
     
 print?
 public static final String BASE_URL = "http://api.myservice.com";   
 Retrofit retrofit = new Retrofit.Builder()   
     .baseUrl(BASE_URL)   
     .build();   

如果你想接收json 结果并解析成DAO，你必须把Gson Converter 作为一个独立的依赖添加进来。

[java]view plain copy 
     
 print?
 compile 'com.google.code.gson:gson:2.4'   
 compile 'com.squareup.retrofit:converter-gson:2.0.0-beta2'   

这里是Square提供的官方Converter modules列表。选择一个最满足你需求的。

Gson: com.squareup.retrofit:converter-gson

Jackson: com.squareup.retrofit:converter-jackson

Moshi: com.squareup.retrofit:converter-moshi

Protobuf: com.squareup.retrofit:converter-protobuf

Wire: com.squareup.retrofit:converter-wire

Simple XML: com.squareup.retrofit:converter-simplexml

你也可以通过实现Converter.Factoty接口来创建一个自定义的converter。

然后使用addConverterFactory把它添加进来：

[java]view plain copy 
     
 print?
 public static final String BASE_URL = "http://api.myservice.com";   
 Retrofit retrofit = new Retrofit.Builder()   
     .baseUrl(BASE_URL)   
     .addConverterFactory(GsonConverterFactory.create())   
     .build();   

（2）定义Endpoints，实现了转换HTTP API为Java接口

Retrofit提供了5种内置的注解：GET、POST、PUT、DELETE和HEAD，在注解中指定的资源的相对URL

[java]view plain copy 
     
 print?
 @GET("users/list")   

也可以在URL中指定查询参数

[java]view plain copy 
     
 print?
 @GET("users/list?sort=desc")   

请求的URL可以在函数中使用替换块和参数进行动态更新，替换块是{ and }包围的字母数字组成的字符串，相应的参数必须使用相同的字符串被@Path进行注释

[java]view plain copy 
     
 print?
 @GET("group/{id}/users")   
 Call<List<User>> groupList(@Path("id") int groupId);   

也可以添加查询参数

[java]view plain copy 
     
 print?
 @GET("group/{id}/users")   
 Call<List<User>> groupList(@Path("id") int groupId, @Query("sort") String sort);   

复杂的查询参数可以使用Map进行组合

[java]view plain copy 
     
 print?
 @GET("group/{id}/users")   
 Call<List<User>> groupList(@Path("id") int groupId, @QueryMap Map<String, String> options);   

可以通过@Body注解指定一个对象作为Http请求的请求体

[java]view plain copy 
     
 print?
 @POST("users/new")   
 Call<User> createUser(@Body User user);   

使用@FormUrlEncoded发送表单数据，使用@Field注解和参数来指定每个表单项的Key,Value为参数的值。

[java]view plain copy 
     
 print?
 @FormUrlEncoded   
 @POST("user/edit")   
 Call<User> getUser(@Field("name") String name, @Field("password") String password);   

使用@FormUrlEncoded发送表单数据时，表单项过多时可以使用Map进行组合

[java]view plain copy 
     
 print?
 @FormUrlEncoded   
 @POST("user/edit")   
 Call<User> getUser(@FieldMap Map<String, String> map);   

使用@Multipart可以进行文件上传，使用@Part指定文件路径及类型

[java]view plain copy 
     
 print?
 @Multipart   
 @POST("/user/edit")   
 Call<User> upload(@Part("image\"; filename=\"文件名.jpg") RequestBody file);   

使用@MapPart可以方便批量上传

[java]view plain copy 
     
 print?
 @Multipart   
 @POST("/user/edit")   
 Call<User> upload(@PartMap Map<String, RequestBody> params);   

[java]view plain copy 
     
 print?
 RequestBody fileBody = RequestBody.create(MediaType.parse("image/png"), imgFile);   
 map.put("image\"; filename=\""+imgFile.getName()+"", fileBody);   

（3）Accessing the API

[java]view plain copy 
     
 print?
 public interface MyApiEndpointInterface {   
     // Request method and URL specified in the annotation   
     // Callback for the parsed response is the last parameter   
     @GET("/users/{username}")   
     Call<User> getUser(@Path("username") String username);   
 }   
 MyApiEndpointInterface apiService = retrofit.create(MyApiEndpointInterface.class);   

异步请求这个API

[java]view plain copy 
     
 print?
 String username = "sarahjean";   
 Call<User> call = apiService.getUser(username);   
 call.enqueue(new Callback<User>() {   
     @Override   
     public void onResponse(Response<User> response) {   
         int statusCode = response.code();   
         User user = response.body();     
     }   
     @Override   
     public void onFailure(Throwable t) {   
         // Log error here since request failed   
     }   
 });   

同步请求

[java]view plain copy 
     
 print?
 String username = "sarahjean";    
    
 Call<User> call = apiService.getUser(username);   
    
 User user = call.execute();

3.注意

（1）我们在同步方法使用时可以直接调用execute方法，但是这个方法只能调用一次。解决办法：需要用clone方法生成一个新的之后在调用execute方法：

[java]view plain copy 
     
 print?
 Call<List<Contributor>> call = gitHubService.repoContributors("square", "retrofit");   
 response = call.execute();   
 // This will throw IllegalStateException:   
 response = call.execute();   
 Call<List<Contributor>> call2 = call.clone();   
 // This will not throw:   
 response = call2.execute();   

（2）当我们执行的同步或异步加入队列后，可以随时使用cancel方法取消请求：

[java]view plain copy 
     
 print?
 Call<List<Contributor>> call = gitHubService.repoContributors("square", "retrofit");   
    
 call.enqueue(...);   
 // or...   
 call.execute();   
    
 // later...   
 call.cancel();   

Retrofit2.0使用

热门文章

最新文章

相关电子书