com.baidubce.util

Class RequestBodyUtils

java.lang.Object

com.baidubce.util.RequestBodyUtils

public class RequestBodyUtils
extends Object

请求体编码工具类，支持多种 BodyType 格式

Since:

2024-04-26

Author:

SDK Team

Field Summary

Fields

Modifier and Type	Field and Description
static String	CONTENT_TYPE_FORM Form Content-Type
static String	CONTENT_TYPE_JSON JSON Content-Type
static String	CONTENT_TYPE_MULTIPART Multipart Form Data Content-Type
static String	CONTENT_TYPE_OCTET_STREAM Octet Stream Content-Type

Method Summary

Modifier and Type	Method and Description
static void	fillPayload(InternalRequest internalRequest, AbstractBceRequest bceRequest, BodyType bodyType) 使用指定的 BodyType 填充请求体
static void	fillPayload(InternalRequest internalRequest, AbstractBceRequest bceRequest, BodyType bodyType, String customContentType) 使用指定的 BodyType 填充请求体，支持自定义 contentType
static void	fillPayloadAsByteArray(InternalRequest internalRequest, byte[] data, BodyType bodyType) 使用字节数组填充请求体（自动计算 contentLength）
static void	fillPayloadAsByteArray(InternalRequest internalRequest, byte[] data, BodyType bodyType, String customContentType) 使用字节数组填充请求体（支持自定义 contentType）
static void	fillPayloadAsByteArray(InternalRequest internalRequest, byte[] data, String contentType) 使用字节数组填充请求体（自定义 Content-Type字符串）
static void	fillPayloadAsForm(InternalRequest internalRequest, AbstractBceRequest bceRequest) 使用表单格式填充请求体（向后兼容的便捷方法）
static void	fillPayloadAsForm(InternalRequest internalRequest, AbstractBceRequest bceRequest, String contentType) 使用表单格式填充请求体（自定义 Content-Type）
static void	fillPayloadAsJson(InternalRequest internalRequest, AbstractBceRequest bceRequest) 使用 JSON 格式填充请求体（向后兼容的便捷方法）
static void	fillPayloadAsJson(InternalRequest internalRequest, AbstractBceRequest bceRequest, String contentType) 使用 JSON 格式填充请求体（自定义 Content-Type）
static void	fillPayloadAsStream(InternalRequest internalRequest, InputStream inputStream) 使用二进制流格式填充请求体（使用默认 BodyType.BINARY）
static void	fillPayloadAsStream(InternalRequest internalRequest, InputStream inputStream, BodyType bodyType) 使用二进制流格式填充请求体（指定 BodyType）
static void	fillPayloadAsStream(InternalRequest internalRequest, InputStream inputStream, Long contentLength, BodyType bodyType) 使用二进制流格式填充请求体（显式传递 contentLength，指定 BodyType）
static void	fillPayloadAsStream(InternalRequest internalRequest, InputStream inputStream, Long contentLength, BodyType bodyType, String customContentType) 使用二进制流格式填充请求体（完整参数版本，支持自定义 contentType）
static void	fillPayloadAsStream(InternalRequest internalRequest, InputStream inputStream, String contentType) 使用二进制流格式填充请求体（自定义 Content-Type）

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

CONTENT_TYPE_JSON

public static final String CONTENT_TYPE_JSON

JSON Content-Type

See Also:

Constant Field Values

CONTENT_TYPE_FORM

public static final String CONTENT_TYPE_FORM

Form Content-Type

See Also:

Constant Field Values

CONTENT_TYPE_OCTET_STREAM

public static final String CONTENT_TYPE_OCTET_STREAM

Octet Stream Content-Type

See Also:

Constant Field Values

CONTENT_TYPE_MULTIPART

public static final String CONTENT_TYPE_MULTIPART

Multipart Form Data Content-Type

See Also:

Constant Field Values

Method Detail

fillPayload

public static void fillPayload(InternalRequest internalRequest,
                               AbstractBceRequest bceRequest,
                               BodyType bodyType)

使用指定的 BodyType 填充请求体

Parameters:

internalRequest - 内部请求对象

bceRequest - 原始请求对象

bodyType - Body类型（JSON/FORM/BINARY/XML/NONE）

fillPayload

public static void fillPayload(InternalRequest internalRequest,
                               AbstractBceRequest bceRequest,
                               BodyType bodyType,
                               String customContentType)

使用指定的 BodyType 填充请求体，支持自定义 contentType

Parameters:

internalRequest - 内部请求对象

bceRequest - 原始请求对象

bodyType - Body类型（JSON/FORM/BINARY/XML/NONE）

customContentType - 自定义 Content-Type（如果为 null，使用 bodyType 的默认值）

fillPayloadAsJson

public static void fillPayloadAsJson(InternalRequest internalRequest,
                                     AbstractBceRequest bceRequest)

使用 JSON 格式填充请求体（向后兼容的便捷方法）

Parameters:

internalRequest - 内部请求对象

bceRequest - 原始请求对象

fillPayloadAsJson

public static void fillPayloadAsJson(InternalRequest internalRequest,
                                     AbstractBceRequest bceRequest,
                                     String contentType)

使用 JSON 格式填充请求体（自定义 Content-Type）

Parameters:

internalRequest - 内部请求对象

bceRequest - 原始请求对象

contentType - 自定义 Content-Type（如 "application/json; charset=gbk"）

fillPayloadAsForm

public static void fillPayloadAsForm(InternalRequest internalRequest,
                                     AbstractBceRequest bceRequest)

使用表单格式填充请求体（向后兼容的便捷方法）

Parameters:

internalRequest - 内部请求对象

bceRequest - 原始请求对象

fillPayloadAsForm

public static void fillPayloadAsForm(InternalRequest internalRequest,
                                     AbstractBceRequest bceRequest,
                                     String contentType)

使用表单格式填充请求体（自定义 Content-Type）

Parameters:

internalRequest - 内部请求对象

bceRequest - 原始请求对象

contentType - 自定义 Content-Type

fillPayloadAsStream

public static void fillPayloadAsStream(InternalRequest internalRequest,
                                       InputStream inputStream)

使用二进制流格式填充请求体（使用默认 BodyType.BINARY）

自动计算 contentLength：

• ByteArrayInputStream - 直接获取 available()（最高效）
• FileInputStream - 从文件 channel 获取大小（高效，不读取文件内容）
• 其他类型的流 - 使用 Chunked Transfer Encoding（流式传输，完全避免 OOM）

Parameters:

internalRequest - 内部请求对象

inputStream - 输入流

fillPayloadAsStream

public static void fillPayloadAsStream(InternalRequest internalRequest,
                                       InputStream inputStream,
                                       BodyType bodyType)

使用二进制流格式填充请求体（指定 BodyType）

Parameters:

internalRequest - 内部请求对象

inputStream - 输入流

bodyType - Body类型（通常使用 BodyType.BINARY）

fillPayloadAsStream

public static void fillPayloadAsStream(InternalRequest internalRequest,
                                       InputStream inputStream,
                                       String contentType)

使用二进制流格式填充请求体（自定义 Content-Type）

Parameters:

internalRequest - 内部请求对象

inputStream - 输入流

contentType - 自定义 Content-Type（如 "image/jpeg", "video/mp4"）

fillPayloadAsStream

public static void fillPayloadAsStream(InternalRequest internalRequest,
                                       InputStream inputStream,
                                       Long contentLength,
                                       BodyType bodyType)

使用二进制流格式填充请求体（显式传递 contentLength，指定 BodyType）

Parameters:

internalRequest - 内部请求对象

inputStream - 输入流

contentLength - 内容长度（如果为 null，则自动计算）

bodyType - Body类型（通常使用 BodyType.BINARY）

fillPayloadAsStream

public static void fillPayloadAsStream(InternalRequest internalRequest,
                                       InputStream inputStream,
                                       Long contentLength,
                                       BodyType bodyType,
                                       String customContentType)

使用二进制流格式填充请求体（完整参数版本，支持自定义 contentType）

Parameters:

internalRequest - 内部请求对象

inputStream - 输入流

contentLength - 内容长度（如果为 null，则自动计算）

bodyType - Body类型（通常使用 BodyType.BINARY）

customContentType - 自定义 Content-Type（如果为 null，使用 bodyType 的默认值）

fillPayloadAsByteArray

public static void fillPayloadAsByteArray(InternalRequest internalRequest,
                                          byte[] data,
                                          BodyType bodyType)

使用字节数组填充请求体（自动计算 contentLength）

Parameters:

internalRequest - 内部请求对象

data - 字节数组

bodyType - Body类型（通常使用 BodyType.BINARY）

fillPayloadAsByteArray

public static void fillPayloadAsByteArray(InternalRequest internalRequest,
                                          byte[] data,
                                          BodyType bodyType,
                                          String customContentType)

使用字节数组填充请求体（支持自定义 contentType）

Parameters:

internalRequest - 内部请求对象

data - 字节数组

bodyType - Body类型（通常使用 BodyType.BINARY）

customContentType - 自定义 Content-Type（如果为 null，使用 bodyType 的默认值）

fillPayloadAsByteArray

public static void fillPayloadAsByteArray(InternalRequest internalRequest,
                                          byte[] data,
                                          String contentType)

使用字节数组填充请求体（自定义 Content-Type字符串）

Parameters:

internalRequest - 内部请求对象

data - 字节数组

contentType - 自定义 Content-Type