每天记录学习的新知识：Content-type_contenttype有哪些类型

一、什么是？

Content-type是指在网络通信中客户端和服务器之间传输的数据格式。
它是一个HTTP头部，用于指定传输的数据类型。
Content-type头部被用于客户端和服务器双方确定如何解析传输的数据。
最常见的Content-type类型包括text/html用于HTML文档、application/json用于JSON数据、image/jpeg用于JPEG图像等等。
Content-type头部对于确保客户端和服务器能够正确解释传输的数据以及支持在Web应用程序中使用不同类型的数据至关重要。

二、都有哪些种？

以下是常见的 Content-type 类型：

text/plain：纯文本格式；
text/html：HTML格式；
text/css：Cascading Style Sheets；
text/javascript：JavaScript代码；
application/json：JSON格式数据；
application/xml：XML格式数据；
application/octet-stream：二进制流数据；
image/jpeg：JPEG格式图片；
image/gif：GIF格式图片；
image/png：PNG格式图片；
audio/mpeg：MP3格式音频；
video/mp4：MP4格式视频；
multipart/form-data：表单数据；
application/x-www-form-urlencoded：URL编码表单数据；
还有许多其他的 Content-type 类型，具体使用取决于需要传输的数据格式。

三、在 retrofit 中的使用

3.1、application/x-www-form-urlencoded

在 Retrofit 中使用 application/x-www-form-urlencoded Content-type 可以通过在请求的接口方法中使用 @FormUrlEncoded 和 @Field 注解来实现。下面是一个使用例子：

首先，在 Retrofit 接口方法上添加 @FormUrlEncoded 注解以指示我们将使用表单编码格式：

@FormUrlEncoded
@POST("login")
Call<LoginResponse> login(@Field("username") String username, @Field("password") String password);
1
2
3

然后，在表单中添加需要传递的数据，使用 @Field 注解指定每个表单字段的键名和值：

Call<LoginResponse> call = apiService.login("your-username", "your-password");

1
2

在这个例子中，我们向服务器发送了一个 POST 请求，以执行登录操作。表单中包含了两个字段，分别是 username 和 password，它们的值分别是 “your-username” 和 “your-password”。Retrofit 将会自动将这些字段编码为表单格式，并将其作为请求体发送到服务器。

注意，在使用表单编码格式时，请求体的内容将被编码为 key=value 的形式，并使用 & 连接多个字段。例如，在上面的例子中，请求体的内容将会被编码为 username=your-username&password=your-password。

3.2、application/json

在 Retrofit 中使用 application/json Content-type 可以通过在请求的接口方法中使用 @Body 注解来实现。下面是一个使用例子：

首先，在 Retrofit 接口方法上添加请求方法类型和请求路径：

@POST("api/user")
Call<User> createUser(@Body User user);
1
2

然后，在发送请求时，创建一个 JSON 对象并将其作为参数传递给接口方法：

User user = new User(“user123”, “password456”);
Call call = apiService.createUser(user);

在这个例子中，我们创建了一个 User 对象，并将其作为参数传递给了 createUser 接口方法。Retrofit 将会自动将 User 对象转换为 JSON 格式，并将其作为请求体发送到服务器。

注意，在使用 JSON 格式时，请求体的内容将被编码为 JSON 字符串，并将其作为请求体发送到服务器。如果你希望在请求中使用其他的 JSON 序列化库，你可以在 Retrofit 的配置中指定自己的转换器，例如 Gson 或者 Moshi。

如何设置 Content-type 内容为application/json

在 Retrofit 中设置 Content-type 为 application/json 可以通过在请求的接口方法中添加 @Headers 注解来实现。下面是一个使用例子：

@Headers("Content-Type: application/json")
@POST("api/user")
Call<User> createUser(@Body User user);
1
2
3

在这个例子中，我们在接口方法上添加了一个 @Headers 注解，其中包含一个 Content-Type 头部的键值对，该键值对的值设置为 application/json。当我们向服务器发送请求时，Retrofit 将会自动将请求头中的 Content-type 设置为 application/json，以告诉服务器我们发送的请求体是一个 JSON 格式的数据。

注意，在使用 @Headers 注解时，如果需要同时添加多个请求头，可以在注解中使用多个键值对，使用英文分号 ; 分隔，例如：

@Headers({
    "Content-Type: application/json",
    "Authorization: Bearer YOUR_ACCESS_TOKEN"
})
@POST("api/user")
Call<User> createUser(@Body User user);

1
2
3
4
5
6
7

在这个例子中，我们同时添加了 Content-Type 和 Authorization 两个请求头。

在 retrofit 中 application/json 如何使用还有其他写法吗

在 Retrofit 中，除了在请求方法上使用 @Headers 注解指定 Content-type 为 application/json，还有其他写法来指定 Content-type。

一种常见的方法是在 Retrofit 的 Converter.Factory 中添加一个 JSON 转换器（例如 Gson 或 Moshi），然后在接口方法中使用 @Body 注解来指定请求体的对象，如下所示：

public interface ApiService {
    @POST("api/user")
    Call<User> createUser(@Body RequestBody requestBody);
}

// 创建 Gson 转换器
Gson gson = new GsonBuilder()
    .setLenient()
    .create();

// 创建 Retrofit 实例，并添加 Gson 转换器
Retrofit retrofit = new Retrofit.Builder()
    .baseUrl(BASE_URL)
    .addConverterFactory(GsonConverterFactory.create(gson))
    .build();

// 创建请求体，将 User 对象转换为 JSON 格式
User user = new User("user123", "password456");
RequestBody requestBody = RequestBody.create(MediaType.parse("application/json"), gson.toJson(user));

// 发送请求
ApiService apiService = retrofit.create(ApiService.class);
Call<User> call = apiService.createUser(requestBody);

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

在这个例子中，我们创建了一个 Gson 转换器，并在 Retrofit 实例中添加它。接着，我们创建了一个 RequestBody 对象，将 User 对象转换为 JSON 格式，并将其作为参数传递给 createUser 接口方法。Retrofit 将会自动使用 Gson 转换器将 RequestBody 对象转换为 JSON 格式，并将其作为请求体发送到服务器。

另外，如果你使用的是 Retrofit 2.4.0 及以上版本，还可以使用 @Body 注解和对象作为请求方法的参数，而不需要显式地创建 RequestBody 对象。Retrofit 将会自动使用内置的 JSON 转换器将对象转换为 JSON 格式，并将其作为请求体发送到服务器。例如：


1
2
3
4
5

public interface ApiService {
    @POST("api/user")
    Call<User> createUser(@Body User user);
}

// 创建 Retrofit 实例，并添加 Gson 转换器
Retrofit retrofit = new Retrofit.Builder()
    .baseUrl(BASE_URL)
    .addConverterFactory(GsonConverterFactory.create())
    .build();

// 发送请求，传递一个 User 对象作为参数
ApiService apiService = retrofit.create(ApiService.class);
User user = new User("user123", "password456");
Call<User> call = apiService.createUser(user);

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

在这个例子中，我们直接将 User 对象作为参数传递给了 createUser 接口方法。Retrofit 将会自动使用内置的 JSON 转换器将对象转换为 JSON 格式，并将其作为请求体发送到服务器。

参考地址

chatgpt