Retrofit2的基本用法

2023-11-06 15:12
文章标签 用法 基本 retrofit2

本文主要是介绍Retrofit2的基本用法，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

一、retrofit是什么？

Retrofit 是一个用于在 Android 应用程序中进行网络请求的开源库。它是由 Square 公司开发的，提供了一种方便的方式来处理 HTTP 请求和响应。Retrofit 可以帮助开发者将 HTTP 请求映射到 Java 接口，并将服务器的响应映射到 Java 对象，从而简化了网络通信的过程。本质还是OkHttp。

二、retrofit的优点？

  1. 基于注解的接口定义：您可以使用注解将 HTTP 请求的参数、路径、头部信息等与接口方法关联起来，使代码更加清晰和易于维护。
  2. 强类型的 HTTP 请求和响应：Retrofit 允许您使用强类型的 Java 对象来表示 HTTP 请求和响应的数据，从而减少了手动解析 JSON 或其他数据格式的工作。
  3. 内置的异步支持：Retrofit 支持异步操作，可以轻松地执行网络请求并在后台线程中处理响应数据，以避免阻塞主线程。

三、MultipartBody.Part与RequestBody的简单用法

RequestBody：

  • RequestBody 是 Retrofit 中的类，用于表示请求体的内容。它通常用于传输文本数据或二进制数据。
  • 您可以使用 RequestBody.create() 方法来创建 RequestBody 对象，以便将文本、JSON、XML 等数据添加到请求体中。
  • 通常，RequestBody 用于发送普通的文本数据或 JSON 数据，例如提交表单数据或发送请求体为 JSON 格式的数据。
        //用于发送一段文本内容RequestBody textRequestBody = RequestBody.create(MediaType.parse("text/plain; charset=utf-8"),"Hello 3G");//用于发送一段json数据RequestBody JsonRequestBody = RequestBody.create(MediaType.parse("application/json"),"{\"key\":\"value\"}");

常用内容类型（MediaType）：

  1. “text/html”：用于传输包含 HTML 标记的文本数据，通常在浏览器中显示网页内容。
  2. “application/json”：用于传输 JSON 格式的文本数据，通常用于 API 请求和响应，表示数据的结构化表示。
  3. “application/xml”：用于传输 XML 格式的文本数据，通常用于数据交换和配置文件。
  4. “text/css”：用于传输层叠样式表（CSS）的文本数据，通常用于定义网页的样式。
  5. “text/plain”：用于传输纯文本数据，没有特定的格式或编码。
  6. “application/octet-stream”: 表示二进制数据，通常用于文件上传。

charset=utf-8：表示编码格式

MultipartBody.Part:

  • MultipartBody.Part 是 Retrofit 中的类，用于表示多部分数据（multipart data）的一部分。它通常用于上传文件或二进制数据。
  • MultipartBody.Part 通常包含一个数据部分和一个请求头部分，用于描述要上传的文件或二进制数据。
  • 您可以使用 MultipartBody.Part.createFormData() 或 MultipartBody.Part.create() 方法来创建 MultipartBody.Part 对象，以便将文件或二进制数据添加到请求体中。
        File file = new File("数据.txt"); //要上传的文件的内容RequestBody fileRequestBody = RequestBody.create(MediaType.parse("application/octet-stream"), file);    //将文件转化为二进制数据MultipartBody.Part filePart = MultipartBody.Part.createFormData("file", "example.txt",fileRequestBody); //包装文件//这种创建方法只有内容，没有文件名和字段名
MultipartBody.Part part = MultipartBody.Part.create(fileRequestBody);
  1. "file": 这是请求中的字段名，它表示要上传的文件字段的名称。在服务器端，您可以使用这个字段名来识别和处理上传的文件。
  2. "example.txt": 这是上传的文件的文件名，它表示要上传的文件的名称。这是可选的，但通常用于标识文件的名称。服务器可能会使用该名称来保存上传的文件。
  3. "fileRequestBody":这是上传的文件

四、常用注解

1、请求方案注解

请求方法注解说明
@GETGET 请求，通常用于获取（或读取）服务器上的资源
@POSTPOST 请求，通常用于向服务器提交数据
@PUTPUT 请求，PUT 请求通常用于更新或替换服务器上的资源，请求体包含要更新的数据，通常用于整体替换而不是部分修改。
@DELETEDELETE 请求，DELETE 请求通常用于删除服务器上的资源
@PATCHPATCH 请求，PATCH 请求类似于 PUT 请求，但通常用于部分更新资源，而不是整体替换。请求体包含要应用的部分更改。
@HEADHEAD 请求，HEAD 请求与 GET 请求类似，但服务器不会返回响应主体，**只返回响应头信息。**它通常用于检查是否修改过或资源是否存在。
@OPTIONSOPTIONS 请求，OPTIONS 请求用于获取关于资源的通信选项
@HTTP可替代以上所有注解，具有三个属性：method、path、hasBody

@PUT的用法：

  1. @Path("id") int resourceId: 这是一个路径参数，它表示要更新的资源的唯一标识符。在请求 URL 中的 {id} 将被替换为提供的 resourceId。
  2. @Body RequestBody requestBody: 这是请求体，它包含要发送到服务器的数据。
public interface ApiService {@PUT("resource/{id}")Call<ResponseBody> updateResource(@Path("id") int resourceId, @Body RequestBody requestBody);
}

@DELETE:

public interface ApiService {@DELETE("resource/{id}")Call<ResponseBody> deleteResource(@Path("id") int resourceId);
}

@PATCH:

public interface ApiService {@PATCH("resource/{id}")Call<ResponseBody> patchResource(@Path("id") int resourceId, @Body RequestBody requestBody);
}

@HTTP的用法：

method 属性：method 属性用于指定请求方法，即您要执行的 HTTP 请求类型。这可以是标准的 HTTP 方法，如 “GET”、“POST”、“PUT”、“DELETE” 等，也可以是自定义的方法名。

path 属性：path 属性用于指定请求的路径或终端端点。

hasBody 属性：hasBody 属性是一个布尔值，**用于指示请求是否包含请求体。**通常，对于 GET 请求，请求体为空，因此 hasBody 属性通常设置为 false。对于 POST、PUT 等请求，请求体包含数据，因此 hasBody 属性通常设置为 true。

例如：

@HTTP(method = "SEARCH", path = "search", hasBody = true)
Call<SearchResult> search(@Body SearchRequest searchRequest);

2、请求头注解

请求头注解说明
@Headers用于添加固定请求头，可以同时添加多个，通过该注解的请求头不会相互覆盖，而是共同存在
@Header作为方法的参数传入，用于添加不固定的header，它会更新已有请求头

请求头用于说明是谁或什么在发送请求、请求源于何处，或者客户端的喜好及能力。

例如：

使用Headers添加固定的请求头

@Headers({"Authorization: Bearer Token123","User-Agent: My-App"
})
@GET("user/profile")
Call<UserProfile> getUserProfile();

使用Header动态添加请求头

@GET("user/profile")
Call<UserProfile> getUserProfile(@Header("Authorization") String authToken);

3、请求和相应格式（标记）注解

标记类注解说明
@FromUrlCoded用于表示请求发送编码表单数据，通常与 @Field 注解一起使用，每个键值对需要使用 @Field 注解来注解。
@Multipart用于表示请求发送 multipart/form-data 格式的数据，通常在需要文件上传的场景中使用。每个键值对需要使用 @Part 注解来注解键名，随后的对象需要提供给 @Part 注解。
@Streaming用于表示希望以字节流的形式返回响应。如果不使用该注解，默认情况下 Retrofit 会将数据全部加载到内存中。用于处理大文件下载。

4、请求参数注解

请求参数注解说明
@Body用于使用Post请求发送数据，将实例对象转化为Json数据。
@Filed用于发送表单，需要结合@FormUrlEncoded使用
@FiledMap用于发送表单，需要结合@FormUrlEncoded使用，允许您动态构建键值对的 Map，对于需要发送大量表单字段或需要动态构建表单数据的情况非常有用。
@Part用于上传文件或二进制数据，例如图像、音频文件等，需要结合@Multipart使用
@PartMap@PartMap 注解通常用于上传多个文件，需要结合@Multipart使用
@Path用于Url中的占位符
@Query用于Get请求中的参数
@QueryMap与Query类似，用于不确定表单参数
@Url指定请求路径
  • @Filed的基本使用方法：
@FormUrlEncoded
@POST("submit-form")
Call<ResponseBody> submitForm(@Field("name") String name, @Field("email") String email);
  • @FiledMap的基本使用方法：
@FormUrlEncoded
@POST("submit-form")
Call<ResponseBody> submitForm(@FieldMap Map<String, String> formData);

@Filed和FiledMap的区别：

  1. 使用方式:
    • @Field 注解用于单独指定每个表单字段的名称和值，每个字段都需要在方法参数中单独列出。这适用于已知要发送的字段，且字段数量较少的情况。
    • @FieldMap 注解允许将多个表单字段的键值对表示为一个 Map，并将整个 Map 作为参数传递给方法。这对于需要发送大量表单字段或需要动态构建表单数据的情况非常有用。
  2. 动态性:
    • @Field 注解的字段名称和值通常是硬编码的，即在代码中显式指定。如果需要在每次请求中更改字段名称或值，需要修改方法参数和注解。
    • @FieldMap 注解允许动态构建键值对的 Map，因此可以根据需要添加、删除或修改字段。
  • @Part的使用方法：
@Multipart
@POST("upload-mixed")
Call<ResponseBody> uploadMixedData(@Part MultipartBody.Part file, 	//上传整个文件@Part("description") RequestBody description	//上传文本数据
);
  • @PartMap的使用方法：
@Multipart
@POST("upload-multiple")
Call<ResponseBody> uploadMultipleFiles(@PartMap Map<String, MultipartBody.Part> files);
  • @Path的用法：
@GET("user/{userId}/orders/{orderId}")
Call<Order> getOrderDetails(@Path("userId") String userId, @Path("orderId") String orderId);
  • @Query的用法：
    @GET("https://devapi.qweather.com/v7/weather/3d")Call<WeatherData> getWeatherDataById(@Query("location") String location, @Query("key") String key);
  • @QueryMap的用法:
 @GET("v7/weather/3d")Call<WeatherData> get3DayWeather(@QueryMap Map<String, String> queryParams);
  • @Url的用法：
    @GETCall<ResponseBody> fetchData(@Url String url);

五、简单网络请求的使用方法

1、添加网络权限

        <!-- 添加网络权限--><uses-permission android:name="android.permission.INTERNET" />

2、导入相关依赖

    implementation 'com.squareup.retrofit2:retrofit:2.9.0'implementation 'com.squareup.retrofit2:converter-gson:2.9.0'implementation 'com.google.code.gson:gson:2.10.1'

简化数据类的定义：

   implementation 'org.projectlombok:lombok:1.18.30'

可以在Gradle/Maven仓库查询所有的依赖：

Gradle仓库

Maven

3、创建实体数据类

使用GsonFromatPlus插件，一键解析JSON数据格式

@lombok.NoArgsConstructor
@lombok.Data
public class WeatherData {@SerializedName("code")private String code;@SerializedName("updateTime")private String updateTime;@SerializedName("fxLink")private String fxLink;@SerializedName("daily")private List<DailyDTO> daily;@SerializedName("refer")private ReferDTO refer;@lombok.NoArgsConstructor@lombok.Datapublic static class ReferDTO {@SerializedName("sources")private List<String> sources;@SerializedName("license")private List<String> license;}@lombok.NoArgsConstructor@lombok.Datapublic static class DailyDTO {@SerializedName("fxDate")private String fxDate;@SerializedName("sunrise")private String sunrise;@SerializedName("sunset")private String sunset;@SerializedName("moonrise")private String moonrise;@SerializedName("moonset")private String moonset;@SerializedName("moonPhase")private String moonPhase;@SerializedName("moonPhaseIcon")private String moonPhaseIcon;@SerializedName("tempMax")private String tempMax;@SerializedName("tempMin")private String tempMin;@SerializedName("iconDay")private String iconDay;@SerializedName("textDay")private String textDay;@SerializedName("iconNight")private String iconNight;@SerializedName("textNight")private String textNight;@SerializedName("wind360Day")private String wind360Day;@SerializedName("windDirDay")private String windDirDay;@SerializedName("windScaleDay")private String windScaleDay;@SerializedName("windSpeedDay")private String windSpeedDay;@SerializedName("wind360Night")private String wind360Night;@SerializedName("windDirNight")private String windDirNight;@SerializedName("windScaleNight")private String windScaleNight;@SerializedName("windSpeedNight")private String windSpeedNight;@SerializedName("humidity")private String humidity;@SerializedName("precip")private String precip;@SerializedName("pressure")private String pressure;@SerializedName("vis")private String vis;@SerializedName("cloud")private String cloud;@SerializedName("uvIndex")private String uvIndex;}@Overridepublic String toString() {return "WeatherData{" +"code='" + code + '\'' +", updateTime='" + updateTime + '\'' +", fxLink='" + fxLink + '\'' +", daily=" + daily +", refer=" + refer +'}';}
}

4、创建请求接口类

命名方式：以功能开头，以Service结尾。

public interface WeatherService {/*** @GET("posts/{Key}") : @Get是Retrofit的一个注解，表示HTTP的GET请求，* 这个请求内容是动态的，使用{Id}来表示,是实际请求中{Id}被替换为具体数据。** Call<*> : *是一个自定义的数据类型，get方法用于获取特定Id的文章* @Query("location") : 使用Retrofit注解‘@Query’用来指定动态的URL内容参数。*///完整的请求地址：https://devapi.qweather.com/v7/weather/3d?location=101010100&key=64f323b501dc410cb7ec4fd1b503aab4@GET("https://devapi.qweather.com/v7/weather/3d")Call<WeatherData> getWeatherDataById(@Query("location") String location, @Query("key") String key);/*** 也可以写为：*     @GET("/v7/weather/3d") 这样的格式*     这里可以省略是因为在构建retrofit时有指定头Url*//*** @POST("Posts") : @Post是Retrofit的一个注解，HTTP POST 请求，用于创建新的文章。请求的 URL 是 "posts"。** Call<*> 该方法返回一个 Call 对象，用于执行网络请求，并在请求成功或失败时提供响应。* @Body WeatherData weatherData : 使用了 Retrofit 注解 @Body，* 表示方法参数WeatherData weatherData将被转换为请求的请求体.* 将数据发送到Posts地址处*/@POST("Posts")Call<WeatherData> createPost(@Body WeatherData weatherData);@Multipart@POST("upload-mixed")Call<ResponseBody> uploadMixedData(@Part MultipartBody.Part file,@Part("description") RequestBody description);}

5、使用请求接口获取/发送数据

public class MainActivity extends AppCompatActivity {@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);Retrofit retrofit = new Retrofit.Builder().baseUrl("https://devapi.qweather.com").addConverterFactory(GsonConverterFactory.create()) //转化器.build();//实例化API接口WeatherService apiService = retrofit.create(WeatherService.class);Call<WeatherData> call = apiService.getWeatherDataById("101010100", "64f323b501dc410cb7ec4fd1b503aab4");String URl = call.request().url().toString();call.enqueue(new Callback<WeatherData>() {@Overridepublic void onResponse(Call<WeatherData> call, Response<WeatherData> response) {if (response.isSuccessful()) {WeatherData data = response.body();Log.d("TAG", "onResponse: " + data.toString());Log.d("TAG", "onResponse: " + URl);}}@Overridepublic void onFailure(Call<WeatherData> call, Throwable t) {Log.d("TAG", "onResponse: " + "data.toString()");Log.d("TAG", "onResponse: " + URl);}});//用于发送一段文本内容RequestBody textRequestBody = RequestBody.create(MediaType.parse("text/plain; charset=utf-8"),"Hello 3G");//用于发送一段json数据RequestBody JsonRequestBody = RequestBody.create(MediaType.parse("application/json"),"{\"key\":\"value\"}");File file = new File("数据.txt"); //要上传的文件的内容RequestBody fileRequestBody = RequestBody.create(MediaType.parse("application/octet-stream"), file);    //将文件转化为二进制数据MultipartBody.Part filePart = MultipartBody.Part.createFormData("file", "example.txt",fileRequestBody); //包装文件MultipartBody.Part part = MultipartBody.Part.create(fileRequestBody);}
}

其中使用了Retrofit.Builder()构建一个Retrofit对象，baseUrl用于指定了一个Retorfit请求的根路径，addConverterFactory方法用于指定Retorfit进行解析数据的转化库。这两个方法是必须调用的。

这篇关于Retrofit2的基本用法的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/357390。

相关文章

使用Python进行文件读写操作的基本方法

使用Python进行文件读写操作的基本方法

《使用Python进行文件读写操作的基本方法》今天的内容来介绍Python中进行文件读写操作的方法,这在学习Python时是必不可少的技术点,希望可以帮助到正在学习python的小伙伴,以下是Pyth... 目录一、文件读取：二、文件写入：三、文件追加：四、文件读写的二进制模式：五、使用 json 模块读写
阅读更多...
oracle中exists和not exists用法举例详解

oracle中exists和not exists用法举例详解

《oracle中exists和notexists用法举例详解》：本文主要介绍oracle中exists和notexists用法的相关资料,EXISTS用于检测子查询是否返回任何行,而NOTE... 目录基本概念：举例语法pub_name总结 exists （sql 返回结果集为真）not exists (s
阅读更多...
Springboot中Jackson用法详解

Springboot中Jackson用法详解

《Springboot中Jackson用法详解》Springboot自带默认json解析Jackson,可以在不引入其他json解析包情况下,解析json字段,下面我们就来聊聊Springboot中J... 目录前言Jackson用法将对象解析为json字符串将json解析为对象将json文件转换为json
阅读更多...
基本知识点

基本知识点

1、c++的输入加上ios::sync_with_stdio(false);  等价于 c的输入，读取速度会加快（但是在字符串的题里面和容易出现问题） 2、lower_bound()和upper_bound() iterator lower_bound( const key_type &key ): 返回一个迭代器，指向键值>= key的第一个元素。 iterator upper_bou
阅读更多...
【IPV6从入门到起飞】5-1 IPV6+Home Assistant(搭建基本环境)

【IPV6从入门到起飞】5-1 IPV6+Home Assistant(搭建基本环境)

【IPV6从入门到起飞】5-1 IPV6+Home Assistant #搭建基本环境 1 背景2 docker下载 hass3 创建容器4 浏览器访问 hass5 手机APP远程访问hass6 更多玩法 1 背景 既然电脑可以IPV6入站，手机流量可以访问IPV6网络的服务，为什么不在电脑搭建Home Assistant（hass），来控制你的设备呢？@智能家居 @万物互联
阅读更多...
bytes.split的用法和注意事项

bytes.split的用法和注意事项

当然，我很乐意详细介绍 bytes.Split 的用法和注意事项。这个函数是 Go 标准库中 bytes 包的一个重要组成部分，用于分割字节切片。 基本用法 bytes.Split 的函数签名如下： func Split(s, sep []byte) [][]byte s 是要分割的字节切片sep 是用作分隔符的字节切片返回值是一个二维字节切片，包含分割后的结果 基本使用示例： pa
阅读更多...
C 语言的基本数据类型

C 语言的基本数据类型

C 语言的基本数据类型 注：本文面向 C 语言初学者，如果你是熟手，那就不用看了。 有人问我，char、short、int、long、float、double 等这些关键字到底是什么意思，如果说他们是数据类型的话，那么为啥有这么多数据类型呢？ 如果写了一句： int a; 那么执行的时候在内存中会有什么变化呢？ 橡皮泥大家都玩过吧，一般你买橡皮泥的时候，店家会赠送一些模板。 上
阅读更多...
FreeRTOS-基本介绍和移植STM32

FreeRTOS-基本介绍和移植STM32

FreeRTOS-基本介绍和STM32移植 一、裸机开发和操作系统开发介绍二、任务调度和任务状态介绍2.1 任务调度2.1.1 抢占式调度2.1.2 时间片调度 2.2 任务状态 三、FreeRTOS源码和移植STM323.1 FreeRTOS源码3.2 FreeRTOS移植STM323.2.1 代码移植3.2.2 时钟中断配置 一、裸机开发和操作系统开发介绍 裸机：前后台系
阅读更多...
Java 多线程的基本方式

Java 多线程的基本方式

Java 多线程的基本方式 基础实现两种方式： 通过实现Callable 接口方式（可得到返回值)：
阅读更多...
UVM：callback机制的意义和用法

UVM：callback机制的意义和用法

1. 作用         Callback机制在UVM验证平台，最大用处就是为了提高验证平台的可重用性。在不创建复杂的OOP层次结构前提下，针对组件中的某些行为，在其之前后之后，内置一些函数，增加或者修改UVM组件的操作，增加新的功能，从而实现一个环境多个用例。此外还可以通过Callback机制构建异常的测试用例。 2. 使用步骤         （1）在UVM组件中内嵌callback函
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2