RetroFit请求参数和返回格式说明

1 Get请求
通过@Query注解请求参数，如下：
@POST("banner/api/5item.json")
Observable<TestResponse> login(@Query("bId") String bId, @Query("name") String name);
发出的请求形式如下：
http://7xk9dj.com1.z0.glb.clouddn.com/banner/api/5item.json? bId =test1& name =test3
参数都被添加到请求Url的后面


通过@ QueryMap注解请求参数，如下：
@POST("banner/api/5item.json ")
Observable<TestResponse> login(@QueryMap Map<String, String> params);
发出的请求形式与上例一致。
2 简单Post请求
@POST("banner/api/5item.json")
Observable<TestResponse> login(@Query("p") String p, @Body TestRequest request);
其中TestRequest为请求body，如下：
public class TestRequest extends BaseRequest {
@SerializedName("request")
public Request request;


public TestRequest(){
   request = new Request();
}


public static class Request{
   public String wContact;
   public String wSuggestion;
}
}
发出的请求形式如下:
 
1. P参数依然会放在url后面
2. 整个TestRequest会以json的格式放在http请求的body中传输
3 FormUrlEncoded
 通过@Field注解添加表单，如下：
@FormUrlEncoded
@POST("banner/api/5item.json")
Observable<TestResponse> login(@Field("param1 ") String param1, @Field(" param2") String param2);
 通过@FieldMap注解添加表单，如下：
@FormUrlEncoded
@POST("banner/api/5item.json ")
Observable<TestResponse> login(@FieldMap Map<String, String> params);

发出的请求形式如下:
 

注：这种形式和简单Post中body的数据格式是不一样的。
4 Multipart
该方式是支持上传文件的
 通过@Part注解请求参数，如下：
@Multipart
@POST("banner/api/5item.json")
Observable<TestResponse> login(@Part RequestBody body);
 通过@PartMap注解请求参数，如下：
@Multipart
@POST("banner/api/5item.json")
Observable<TestResponse> login(@PartMap Map<String, RequestBody> params);

上传文件使用方法如下：
示例为一个bid请求参数和2张图片
File file1 = new File(SDCardUtils.getSDCardPath() + "DCIM/100MEDIA/IMAG0009.jpg");
File file2 = new File(SDCardUtils.getSDCardPath() + "DCIM/100MEDIA/IMAG0010.jpg");

Map<String, RequestBody> map = new HashMap<>();
RequestBody bId = RequestBody.create(MediaType.parse("text/plain"), "1");
RequestBody imgFile1 = RequestBody.create(MediaType.parse("image/*"), file1);
RequestBody imgFile2 = RequestBody.create(MediaType.parse("image/*"), file2);

map.put("bId", bId);
map.put("headImage1\"; filename=\"" + file1.getName(), imgFile1);
map.put("headImage1\"; filename=\"" + file2.getName(), imgFile2);
注意：上传文件时map中key的格式必须是"headImage1\"; filename=\"" + file1.getName()。
1. headImage1：为参数key的名字
2. "; filename=\"" + file1.getName()：为的文件的名字。
上传多张图片时，key的名字可以是相同的


 参考<四种常见的 POST 提交数据方式>:
http://www.cnblogs.com/aaronjs/p/4165049.html