Retrofit2.0 简单使用总结

原文出处：https://gold.xitu.io/entry/58aac9710ce463006b13914d

初始化Retrofit

String BASE_URL = "http://102.10.10.132/api/" ;Retrofit retrofit = new Retrofit.Builder() .baseUrl(BASE_URL) .build();

=================================== get请求 ====================================================

1.直接拼在后面

@GET ( "News" ) Call<NewsBean> getItem ();

效果： http://102.10.10.132/api/News

2.（@Path）替换括号内参数

@GET ( "News/{newsId}" ) Call<NewsBean> getItem (@Path( "newsId" ) String newsId) ;

@GET ( "News/{newsId}/{type}" ) Call<NewsBean> getItem (@Path( "newsId" ) String newsId， @ Path ( "type" ) String type) ;

效果： http://102.10.10.132/api/News/{资讯id}/{类型}

3.（@Query）相当于 ？a=1&b=2;

@GET ( "News" ) Call<NewsBean> getItem (@Query( "newsId" ) String newsId) ;

效果： http://102.10.10.132/api/News?newsId={资讯id}&type={类型}

4.（@Querymap）多个参数在URL问号之后，且个数不确定;

@GET ( "News" ) Call<NewsBean> getItem (@QueryMap Map<String, String> map) ;

@GET ( "News" ) Call<NewsBean> getItem ( @Query( "newsId" ) String newsId， @QueryMap Map<String, String> map) ;

=================================== POST请求 ====================================================

1.（@FormUrlEncoded）这个参数必须存在；(@Field)为一个表单；（@Path）这个参数直接替换

@FormUrlEncoded @POST ( "Comments/{newsId}" ) Call<Comment> reportComment ( @Path( "newsId" ) String commentId, @ Field ( "reason" ) String reason) ;

效果： http://102.10.10.132/api/Comments/{newsId}

2.（@FormUrlEncoded）这个参数必须存在；(@Field)为一个表单；（@Query）为拼接Url的？a=1&b=2;

@FormUrlEncoded @POST ( "Comments/{newsId}" ) Call<Comment> reportComment ( @Path( "newsId" ) String commentId, @ Query ( "access_token" ) String access_token, @ Field ( "reason" ) String reason) ;

效果： http://102.10.10.132/api/Comments/{newsId}?access_token={access_token}

3.（@FormUrlEncoded）这个参数必须存在；(@Field)为一个表单；（@Path）这个参数直接替换;（@Body）为一个Bean对象 不常用；

@POST ( "Comments/{newsId}" ) Call<Comment> reportComment ( @Path( "newsId" ) String commentId, @ Query ( "access_token" ) String access_token, @Body CommentBean bean) ;

效果： http://102.10.10.132/api/Comments/{newsId}?access_token={access_token}

总结

@Path：所有在网址中的参数（ URL的问号前面 ），如：

http://102.10.10.132/api/Accounts/{accountId}

@Query： URL问号后面的参数 ，如：

http://102.10.10.132/api/Comments?access_token={access_token}

@QueryMap： 相当于多个@Query

@Field： 用于POST请求，提交单个数据

@Body： 相当于多个@Field，以对象的形式提交

TIps

• Tip1

使用@Field时记得添加@FormUrlEncoded

• Tip2

若需要重新定义接口地址，可以使用@Url ，将地址以参数的形式传入即可。如

@GET Call<List<Activity>> getActivityList( @Url String url, @QueryMap Map<String, String> map);

Call<List<Activity>> call = service.getActivityList( "http://115.159.198.162:3001/api/ActivitySubjects" , map);