### 使用 `multipart/form-data` 数据类型的 HTTP 请求 当需要通过 HTTP 请求上传文件或者传输二进制数据时，通常会使用 `Content-Type: multipart/form-data`。这种类型允许在一个请求中同时发送文本字段和文件内容。 #### 基本原理 `multipart/form-data` 的核心在于将不同的部分（part）组合成一个整体消息体。每一部分都有自己的头部信息来描述其内容类型和其他元数据[^1]。以下是构建此类请求的关键要素： - **边界字符串 (Boundary)** 边界字符串用于分隔不同部分的数据，默认情况下是由服务器自动生成的一串随机字符。客户端在设置请求头时需指定该值，并将其嵌入到消息体内作为分割符。 - **每部分内容结构** 每一部分的内容遵循特定格式，包括但不限于字段名、文件名称以及实际数据本身。具体形式如下所示： ``` --boundary-string\r\n Content-Disposition: form-data; name="field-name"; filename="file-name"\r\n Content-Type: mime-type-of-file\r\n \r\n file-content-here...\r\n ``` #### 实现方式 ##### JavaScript/AJAX 示例 如果希望通过 AJAX 发送带有附件的表单，则需要注意调整默认行为并显式声明所需的 MIME 类型。下面是一个简单的例子展示如何操作： ```javascript let formData = new FormData(); formData.append('text_field', 'some text'); formData.append('upload_file', document.getElementById('file_input').files[0]); fetch('/your-endpoint-url', { method: 'POST', body: formData, }) .then(response => response.json()) .catch(error => console.error('Error:', error)); ``` 注意这里无需手动设定 `Content-Type` 头部因为浏览器能够自动处理它基于所提供的 `FormData` 对象[^3]。 ##### Java 自定义实现 对于某些场景可能需要完全控制整个过程而不依赖框架辅助函数。此时可以参照以下代码片段创建原始字节流表示法： ```java import java.io.*; import java.net.HttpURLConnection; import java.nio.charset.StandardCharsets; public class MultipartExample { public static void main(String[] args)throws Exception{ String boundary = "===" + System.currentTimeMillis() +"=="; HttpURLConnection connection = null; DataOutputStream outputStream = null; InputStream inputStream = null; try { URL url = new URL("http://example.com/upload"); connection = (HttpURLConnection)url.openConnection(); connection.setDoOutput(true); connection.setRequestMethod("POST"); // Set headers. connection.addRequestProperty("Accept", "*/*"); connection.addRequestProperty("Connection", "Keep-Alive"); connection.addRequestProperty("Cache-Control", "no-cache"); connection.addRequestProperty( "Content-Type", "multipart/form-data; boundary="+boundary); StringBuilder sb = new StringBuilder(); sb.append("--").append(boundary).append("\r\n"); sb.append("Content-Disposition:form-data;name=\"param_name\"\r\n\r\n"); sb.append("value_of_param").append("\r\n"); byte[] bytes = sb.toString().getBytes(StandardCharsets.UTF_8); outputStream = new DataOutputStream(connection.getOutputStream()); outputStream.write(bytes); FileInputStream fis = new FileInputStream(new File("/path/to/file")); sb.delete(0,sb.length()); sb.append("--").append(boundary).append("\r\n"); sb.append("Content-Disposition:form-data;name=\"uploaded_file\";filename=\"test.txt\"\r\n"); sb.append("Content-Type:text/plain\r\n\r\n"); bytes = sb.toString().getBytes(StandardCharsets.UTF_8); outputStream.write(bytes); int bytesRead=-1; while((bytesRead=fis.read())!=-1){ outputStream.write(bytesRead); } fis.close(); sb.delete(0,sb.length()); sb.append("\r\n--").append(boundary).append("--\r\n"); bytes=sb.toString().getBytes(StandardCharsets.UTF_8); outputStream.write(bytes); outputStream.flush(); outputStream.close(); BufferedReader br=new BufferedReader(new InputStreamReader(connection.getInputStream())); String line=null; StringBuffer resp=new StringBuffer(); while ((line=br.readLine())!=null){ resp.append(line+"\n"); } br.close(); System.out.println(resp.toString()); } finally { if(outputStream !=null){outputStream.close();} if(inputStream !=null){inputStream.close();} if(connection !=null){connection.disconnect();} } } } ``` 此段程序展示了怎样构造一个多部件的消息主体并通过标准库完成网络通信[^2]。 ---