《一》四种网络请求方式：
- GET : 向服务器发起数据请求，获取信息。类似于数据库的select操作，只是查询，不会影响资源的内容。
- POST : 向服务器发送数据，该请求会改变数据的种类等资源。类似于数据库的insert操作，会创建新的内容。
- DELETE：用来删除某一个资源。类似于数据库的delete操作。
- PUT ： 向服务器发送数据，从而改变信息。类似于数据库的update操作，用来修改内容。
《二》Retrofit通过注解的方式，配置不同的网络请求。主要涉及到@Path、@Query、@QueryMap、@Body、@Field的用法等。
假设你的BASE_URL = "http://192.168.0.1/"
1、GET请求:
（1）情形一：
@Query
仅带查询参数：http://192.168.0.1/weather?city=北京
@GET("weather")
Observable<WeatherEntity> getWeather(@Query("city") String city);
AI 代码解读
（2）情形二：
@Path
请求参数直接跟在请求路径下：http://192.168.0.1/weather/北京
@GET("weather/{city_name}")
Observable<Object> getWeather(@Path("city_name") String city_name);
AI 代码解读
（3）情形三：
@Path和@QueryMap结合
此种情形用得比较少：http://192.168.0.1/weather/北京?user_id=1&user_name=jojo
@GET("weather/{city_name}")
Observable<Object> getWeather(@Path("city_name")String city_name, @QueryMap Map<String, String> queryParams);
AI 代码解读
HashMap<String, String> queryParams= new HashMap<>();
hashMap.put("user_id","1");
hashMap.put("user_name","jojo");
AI 代码解读
2、POST请求:
（1）情形一： http://192.168.0.1/comment
body参数：{"comment_id":"1","content":"我是评论","user_id":"1001"}
@Filed 方式处理
@FormUrlEncoded //使用@Field时记得添加@FormUrlEncoded
@POST("comment")
void doComments(@Field("comment_id")String comment_id, @Field("content")String content, @Field("user_id") String user_id);
AI 代码解读
@FieldMap 方式处理
@FormUrlEncoded
@POST("comment")
void doComments(@FieldMap Map<String, String> paramsMap );
AI 代码解读
通过键值对，以表单的形式提交：
HashMap<String, String> hashMap = new HashMap<>();
hashMap.put("comment_id","1");
hashMap.put("content","我是评论");
hashMap.put("user_id","1001");
AI 代码解读
@Body方式处理
@POST("comment")
void doComments(@Body Object reqBean);
AI 代码解读
@POST("comment")
void doComments(@Body List<Object> requestList);
AI 代码解读
(2)情形二：Retrofit文件上传： http://192.168.0.1/upload/
/**
* 文件上传
*/
@POST("upload/")
Observable<Object> uploadFile(@Body RequestBody requestBody);
AI 代码解读
只不过文件上传传入的是RequestBody类型,下面是构建RequestBody的方式：
File file = new File(mFilePath); //mImagePath为上传的文件绝对路径
//构建body
RequestBody requestBody = new MultipartBody.Builder()
.setType(MultipartBody.FORM)
.addFormDataPart("file", file.getName(), RequestBody.create(MediaType.parse("multipart/form-data"), file))
.build();
AI 代码解读
3、PUT请求:
（1）情形一：http://192.168.0.1/comment/88
@PUT("comment/{comment_id}")
void comment(@Path("comment_id") String comment_id);
AI 代码解读
（2）情形二：http://192.168.0.1/comment/88?user_id=1001
@PUT("comment/{comment_id}")
void comment(@Path("comment_id") String comment_id @Query("user_id") String user_id);
AI 代码解读
（3）情形三：http://192.168.0.1/comment/88?user_id=1001
加body参数：{"content":"我是评论"，"type":"1"}
此类请求的应用场景：适合于body中需要传入多个请求参数，这样可以将多个请求的参数字段封装到一个实体中，这样就不用写多个@Filed了。
public class RequestBean {
public String content;
public String type;
//实际中可能还有多个请求字段
}
AI 代码解读
RequestBean requestBean = new RequestBean();
requestBean .content = "我是评论";
requestBean .type = "1";
AI 代码解读
@PUT("comment/{comment_id}")
void comment(@Path("comment_id") String comment_id @Query("user_id") String user_id @Body RequestBean reqBean);
AI 代码解读
4、DELETE请求:
假如删除评论：http://192.168.0.1/comment/88
@DELETE("comment/{comment_id}")
void comment(@Path("comment_id") String comment_id);
AI 代码解读
其他可能的delete请求，配置方式都是类似的，这里就不多举例了。主要是要好好理解下面这些常用的请求参数注解的作用和用法。
综上所述，可以归纳出上面几个注解的用法：
@Path ： 请求的参数值直接跟在URL后面时，用@Path配置
@Query： 表示查询参数，以?key1=value1&key2=value2的形式跟在请求域名后面时使用@Query
@QueryMap ：以map的方式直接传入多个键值对的查询参数
@Field： 多用于post请求中表单字段，每个@Field后面，对应一对键值对。
@FieldMap ：以map的方式传入多个键值对，作为body参数
@Body: 相当于多个@Field，以对象的形式提交
注意：Filed和FieldMap需要FormUrlEncoded结合使用，否则会抛异常！
更多配置URL请求路径的注解的了解可以参考：
Retrofit网络请求参数注解
Retrofit常用注解解释
