Retrofit中的注解

一、Retrofit中的注解有那些?

  • 方法注解:@GET ,@POST,@PUT,@DELETE,@PATH,@HEAD,@OPTIONS,@HTTP
  • 标记注解:@FormUrlEncoded,@Multpart,@Streaming
  • 参数注解:@Query,@QueryMap,@Body,@Field,@FieldMap,@Part,@PartMap
  • 其他注解:@path,@Header,@Headers,@Uri

二、了解方法注解@HTTP

@HTTP注解的作用是可以让我们自己自定义这次接口的请求方式。

java 复制代码
  @HTTP(method = "GET", path = "get", hasBody = false)
    @FormUrlEncoded
    Call<ResponseBody> http(@Field("userName") String userName, @Field("password") String pwd);

参数method:使用http注解时必须要指定method,method如果是POST就会执行http方法执行post请求,method如果指定GET就会执行http方法执行get请求。

参数书path:指定path,就需要把指定请求的接口的地址传入

参数hasBody:指定hasBody,就是请求体。post请求有请求体就指定hasBody = true。get请求没有请求体就指定haBody = false。

三、了解参数注解@Body

使用@Body注解在接口类对象中的定义

java 复制代码
    @POST("post")
    Call<ResponseBody> postBody(@Body RequestBody body);//自己指定requestBody

测试代码

java 复制代码
public class AnnotationUnitTest {
     Retrofit retrofit = new Retrofit.Builder().baseUrl("http://www.httpbin.org/").build();//创建retrofit对象

     HttpbinService httpbinService = retrofit.create(HttpbinService.class);//创建接口类对象,并且设置为全局变量。
    @Test
    public void bodyTest()throws IOException {
        FormBody formBody = new FormBody.Builder()
                .add("a", "1").add("b", "2").build();
        Response<ResponseBody> response = httpbinService.postBody(formBody).execute();
        System.out.println(response.body().string());
    }
}

测试结果

四、其他注解中的@path注解

在接口类对象中的使用

java 复制代码
    @POST("{id}")
    Call<ResponseBody> pathInPath(@Path("id") String path);//@path注解作用于参数部分,意思是id=path帮我们替换掉@POST注解里面的参数

@path注解作用于参数部分,意思是{id}里面是id会被@path中的id替换掉替换成参数path

测试代码:

java 复制代码
    @Test
    public void pathTest() throws IOException {
        //实际上请求到的是https://www。httpbin.org/post
        Response<ResponseBody> response = httpbinService.pathInPath("post").execute();
        System.out.println(response.body().string());
    }

测试结果:

可以看到请求的url是http://www.httpbin.org/post,使用的是post请求

五、那么我们尝试使用@path注解调用post请求,并且传递用户名和密码两个参数

在接口类对象中的使用

java 复制代码
@POST("{id}")
    @FormUrlEncoded
    Call<ResponseBody> pathInPath(@Path("id") String path,@Field("userName") String userName, @Field("password") String pwd);//@path注解作用于参数部分,意思是id=path帮我们替换掉@POST注解里面的参数

测试代码

java 复制代码
    @Test
    public void pathTest() throws IOException {
        //实际上请求到的是https://www。httpbin.org/post
        Response<ResponseBody> response = httpbinService.pathInPath("post","Anglin","rssqzqyp").execute();
        System.out.println(response.body().string());
    }

测试结果

六、其他注解中的@Header注解

@Header是用来设置请求头的

在接口类对象中的使用

java 复制代码
 @POST("{id}")
    @FormUrlEncoded
    Call<ResponseBody> pathInPath(@Path("id") String path, @Header("os")String os, @Field("userName") String userName, @Field("password") String pwd);//@path注解作用于参数部分,意思是id=path帮我们替换掉@POST注解里面的参数

测试代码

java 复制代码
   @Test
    public void pathTest() throws IOException {
        //实际上请求到的是https://www。httpbin.org/post
        Response<ResponseBody> response = httpbinService.pathInPath("post","Android","Anglin","rssqzqyp").execute();
        System.out.println(response.body().string());
    }

运行结果

七、其他注解中的@Headers注解

@Headers是添加多个请求头或者写一个请求头都可以,写多个要用花括号{}

在接口类对象中的使用

java 复制代码
    @Headers({"os:amdroid","version:1.0"})
    @POST("post")
    Call<ResponseBody> postWithHeaders();

测试代码

java 复制代码
    @Test
    public void headersTest() throws IOException {
        Call<ResponseBody> reponse = httpbinService.postWithHeaders();
        System.out.println(reponse.execute().body().string());
    }

测试结果

可以看到我们已经成功添加了请求头平台和版本号。

八、其他注解中的@Url

@url注解作用于参数中,作用是指定完整的http地址,不像之前的注解还要自己进行拼接。

在接口类对象中的使用

java 复制代码
   @POST
    Call<ResponseBody> postUrl(@Url String url);

测试代码

java 复制代码
   @Test
    public void urlTest() throws IOException {
        Response<ResponseBody> response = httpbinService.postUrl("http://www.httpbin.org/post").execute();
        System.out.println(response.body().string());
    }

测试结果

相关推荐
帅次1 个月前
解决 Android WebView 无法加载 H5 页面常见问题的实用指南
android·okhttp·gradle·binder·webview·retrofit·appcompat
追梦的鱼儿2 个月前
okhttp,retrofit,rxjava 是如何配合工作的 作用分别是什么
okhttp·rxjava·retrofit
愿相知2 个月前
【Android】最好用的网络库:Retrofit
网络·retrofit
要小鑫呐2 个月前
实际项目中,运用Retrofit和OkHttp调用其他项目接口
java·网络·okhttp·retrofit
江南一舟1103 个月前
TabLayout使用以及自定义tab标签
android·kotlin·retrofit
骑猪追大象4 个月前
使用Retrofit2+OkHttp监听上传或者下载进度会执行两次的问题
okhttp·retrofit·监听上传下载进度
Android_Trot5 个月前
鸿蒙开发HarmonyOS Next 网络框架retrofit 封装 viemodel使用
harmonyos·鸿蒙·retrofit
FranzLiszt18475 个月前
Harmony os Next——Retrofit网络库的使用和封装
网络·php·retrofit
哈龙_996 个月前
Android Retrofit 封装模版
retrofit
哈龙_996 个月前
Android retrofit使用模板
android·retrofit