深入理解Retrofit2（一） —— 注解

0. 前言

在 retrofit2.http 包中，注解一共有24个

1. 注解分类

方法注解：8个

@DELETE

@GET

@HEAD

@PATCH

@POST

@PUT

@OPTIONS

@HTTP

标记类—方法注解：4个

@Headers

@Multipart

@FormUrlEncoded

@Streaming

参数注解：12个

@Url

@Path

@Query  @QueryName  @QueryMap

@Header  @HeaderMap

@Field  @FieldMap

@Part  @PartMap

@Body

2. Retrofit 官方示例

标记类—方法注解

@FormUrlEncoded

@FormUrlEncoded
@POST("user/edit")
Call<User> updateUser(@Field("first_name") String first, @Field("last_name") String last);

@Multipart

@Multipart
@PUT("user/photo")
Call<User> updateUser(@Part("photo") RequestBody photo, @Part("description") RequestBody description);

@Headers

@Headers("Cache-Control: max-age=640000")
@GET("widget/list")
Call<List<Widget>> widgetList();

@Headers({
    "Accept: application/vnd.github.v3.full+json",
    "User-Agent: Retrofit-Simple-App"
})
@GET("users/{username}")
Call<User> getUser(@Path("username") String username);