@Get 基本注解

@GET("blog/{id}") //這里的{id} 表示是一個變量
Call<ResponseBody> getBlog(/** 這里的id表示的是上面的{id} */@Path("id") int id);

@Http 全名注解

/**
 * method 表示請求的方法驾中，區(qū)分大小寫焚鲜，retrofit 不會做處理
 * path表示路徑
 * hasBody表示是否有請求體
 */
@HTTP(method = "GET", path = "blog/{id}", hasBody = false)
Call<ResponseBody> getBlog(@Path("id") int id);

@Post :

/**
 * {@link FormUrlEncoded} 表明是一個表單格式的請求（Content-Type:application/x-www-form-urlencoded）
 * <code>Field("username")</code> 表示將后面的 <code>String name</code> 中name的取值作為 username 的值
 */
@POST("/form")
@FormUrlEncoded
Call<ResponseBody> testFormUrlEncoded1(@Field("username") String name, @Field("age") int age);

/**
 * Map的key作為表單的鍵
 */
@POST("/form")
@FormUrlEncoded
Call<ResponseBody> testFormUrlEncoded2(@FieldMap Map<String, Object> map);

@Headers 和 @Header

@GET("/headers?showAll=true")
@Headers({"CustomHeader1: customHeaderValue1", "CustomHeader2: customHeaderValue2"})
Call<ResponseBody> testHeader(@Header("CustomHeader3") String customHeaderValue3);

@Headers ： 用在方法上面车摄，請求的時候添加固定的 Header 值

@Header ： 只能用在方法參數(shù)中摸柄，可以動態(tài)的傳遞 Header 參數(shù)

@Query 和 @QueryMap

/**
 * 當(dāng)GET丧靡、POST...HTTP等方法中沒有設(shè)置Url時，則必須使用 {@link Url}提供
 * 對于Query和QueryMap辣吃，如果不是String（或Map的第二個泛型參數(shù)不是String）時
 * 會被默認(rèn)會調(diào)用toString轉(zhuǎn)換成String類型
 * Url支持的類型有 okhttp3.HttpUrl, String, java.net.URI, android.net.Uri
 * {@link retrofit2.http.QueryMap} 用法和{@link retrofit2.http.FieldMap} 用法一樣蒿叠，不再說明
 */
@GET //當(dāng)有URL注解時，這里的URL就省略了
Call<ResponseBody> testUrlAndQuery(@Url String url, @Query("showAll") boolean showAll);

當(dāng)@GET券册、POST...HTTP等注解中沒有設(shè)置Url時频轿，則必須在方法參數(shù)中使用 @Url 來提供 Url

@Query 和 @QueryMap 會自動當(dāng)成參數(shù)來拼接 Url

@Body

@POST("blog")
Call<Result<Blog>> createBlog(@Body Blog blog);

當(dāng)參數(shù)比較多的時候，一種是使用 @FieldMap 注解汁掠，一種是使用 @Body 傳遞一個對象略吨，當(dāng)對象作為參數(shù)的時候，需要在 Retrofit 配置一個轉(zhuǎn)換器考阱，例如下面，這樣就會自動把這個對象進(jìn)行一次轉(zhuǎn)換放到 request 的 body 里傳過去

Retrofit retrofit = new Retrofit.Builder()
        .baseUrl("http://localhost:4567/")
        //可以接收自定義的Gson鞠苟，當(dāng)然也可以不傳
        .addConverterFactory(GsonConverterFactory.create(gson))
        .build();

?