multipart/form-data 是一种 HTTP 请求编码方式，常用于上传文件、图片和复杂的表单数据。它的作用是将数据按不同字段分块上传，并使用唯一的边界（boundary）来区分每个字段，使服务器能正确解析上传的文件和参数。
在 Swift 中，这种编码方式虽然复杂，但在上传图片和多参数表单时依然非常常用，尤其在构建 RESTful API 或文件传输时。尽管如此，直接在 Swift 原生代码中实现 multipart/form-data 可能显得繁琐，所以通常会借助第三方网络库来简化处理。
1、基本结构
multipart/form-data 请求的基本结构如下：
边界（boundary）：分隔每个部分的唯一标识符。
头信息（Content-Disposition）：每部分的头信息，包括字段名称、文件名称（如果是文件）等。
内容：字段内容或文件内容。
2、构建 multipart/form-data 请求
首先，我们可以通过 URLRequest 和 URLSession.uploadTask 来发送此类请求。以下是构建 multipart/form-data 请求的步骤：
import Foundation
func uploadImageAndText(url: URL, image: UIImage, parameters: [String: String]) {
let boundary = "Boundary-\(UUID().uuidString)"
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")
// 构建请求体
var requestBody = Data()
// 添加文本字段
for (key, value) in parameters {
requestBody.append("--\(boundary)\r\n".data(using: .utf8)!)
requestBody.append("Content-Disposition: form-data; name=\"\(key)\"\r\n\r\n".data(using: .utf8)!)
requestBody.append("\(value)\r\n".data(using: .utf8)!)
}
// 添加图片文件字段
if let imageData = image.jpegData(compressionQuality: 1.0) {
requestBody.append("--\(boundary)\r\n".data(using: .utf8)!)
requestBody.append("Content-Disposition: form-data; name=\"file\"; filename=\"image.jpg\"\r\n".data(using: .utf8)!)
requestBody.append("Content-Type: image/jpeg\r\n\r\n".data(using: .utf8)!)
requestBody.append(imageData)
requestBody.append("\r\n".data(using: .utf8)!)
}
// 添加结束边界
requestBody.append("--\(boundary)--\r\n".data(using: .utf8)!)
// 设置请求体
request.httpBody = requestBody
// 创建上传任务
let task = URLSession.shared.dataTask(with: request) { data, response, error in
if let error = error {
print("上传失败：\(error)")
return
}
if let response = response as? HTTPURLResponse, response.statusCode == 200 {
print("上传成功")
} else {
print("服务器返回错误")
}
}
task.resume()
}3、解释代码
解释1:函数签名
func uploadImageAndText(url: URL, image: UIImage, parameters: [String: String])url：请求发送的服务器地址。
image：要上传的图片，以 UIImage 对象传入。
parameters：字典类型的文本参数，包含字段名称和对应的值。
解释2:Boundary
用于将 multipart/form-data 内容分隔为多个部分。边界值应该是唯一的，使用 UUID 来生成一个随机字符串作为边界。
boundary 的格式和使用
// 配置boundary
let boundary = "Boundary-\(UUID().uuidString)"
// 配置URLRequest中的boundary
request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")
// 每个字段之间通过 --boundary\r\n 分隔
requestBody.append("--\(boundary)\r\n".data(using: .utf8)!)
// 结尾的结束标识使用 --boundary--\r\n 表示请求体的结束
requestBody.append("--\(boundary)--\r\n".data(using: .utf8)!)boundary 一般由客户端随机生成，并在 Content-Type 中指定，例如 Content-Type: multipart/form-data; boundary=Boundary-12345abcd。请求体的每一部分都以 –boundary 开始，并在每部分的内容后面加上 –boundary，最后以 –boundary– 结尾，表示请求体的结束。
为什么要使用 boundary 分隔？
1、识别每个部分的边界：上传的内容可能包含多个字段或文件。boundary 作为分隔符，能够标记出每个数据部分的开始和结束，使服务器能够识别并分别处理每个字段或文件。
2、支持不同类型的数据：在 multipart/form-data 请求中，每个部分的数据类型可能不同（比如纯文本和二进制文件）。通过 boundary 分隔，服务器可以方便地对每个部分进行独立解析。
3、解析顺序：服务器通过 boundary 定位每个部分的开头和结尾，确保数据在按顺序解析时不会混淆。
分隔后的数据格式
例如，以下是一个带有 boundary 的 multipart/form-data 请求体：
--Boundary-12345abcd
Content-Disposition: form-data; name="username"
user123
--Boundary-12345abcd
Content-Disposition: form-data; name="file"; filename="image.jpg"
Content-Type: image/jpeg
[二进制图片数据]
--Boundary-12345abcd--服务器处理流程
1、读取 boundary：服务器接收到请求后，首先读取 Content-Type 头中的 boundary。
2、按边界分割内容：服务器根据 boundary 分割请求体内容，提取出每一个部分。
3、解析每个部分的头和内容：对于每个分割出来的部分，服务器检查其头信息（如 Content-Disposition）以获取字段名、文件名等信息。
4、处理内容：服务器将每个字段内容分别处理，文本内容作为表单数据，文件内容则可能被存储或进一步处理。
boundary 是确保服务器能够按分段处理数据的关键。它不仅确保了请求体中的多个字段和文件能够分离，还保证了服务器能够正确解析和处理每个独立部分。
解释3:配置URLRequest
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")URLRequest 用于描述请求的各种参数，这里配置了 POST 方法来上传数据。
Content-Type 设置为 multipart/form-data，并指定 boundary，告诉服务器这是一个带有边界的多部分请求。
解释4:构建请求体（requestBody）
var requestBody = Data()requestBody 是请求的内容部分，使用 Data 类型。它将包含每个字段的数据和文件内容。
解释5:添加文本到请求体
for (key, value) in parameters {
requestBody.append("--\(boundary)\r\n".data(using: .utf8)!)
requestBody.append("Content-Disposition: form-data; name=\"\(key)\"\r\n\r\n".data(using: .utf8)!)
requestBody.append("\(value)\r\n".data(using: .utf8)!)
}对于 parameters 中的每个键值对：
添加 –boundary 来标记每个字段的开始。
添加 Content-Disposition 来说明这是一个表单字段，指定字段的名称 name。
添加字段的实际内容 value，最后添加 \r\n 换行符，标识当前字段的结束。
解释5:添加图片到请求体
if let imageData = image.jpegData(compressionQuality: 1.0) {
requestBody.append("--\(boundary)\r\n".data(using: .utf8)!)
requestBody.append("Content-Disposition: form-data; name=\"file\"; filename=\"image.jpg\"\r\n".data(using: .utf8)!)
requestBody.append("Content-Type: image/jpeg\r\n\r\n".data(using: .utf8)!)
requestBody.append(imageData)
requestBody.append("\r\n".data(using: .utf8)!)
}将 UIImage 转换为 JPEG 格式的数据。
添加 –boundary 和 Content-Disposition，指定文件的字段名称和文件名。
Content-Type 设置为 image/jpeg，告知服务器这是一个 JPEG 格式的文件。
添加图片数据 imageData 到请求体。
用 \r\n 换行符来结束当前部分。
解释6:结束边界
requestBody.append("--\(boundary)--\r\n".data(using: .utf8)!)添加 –boundary– 来标识请求体的结束。
解释7:将请求体分配给 URLRequest
request.httpBody = requestBody将构建好的 requestBody 设置为 URLRequest 的 httpBody，它将作为请求的内容发送到服务器。
解释8:创建并执行上传任务
let task = URLSession.shared.dataTask(with: request) { data, response, error in
if let error = error {
print("上传失败：\(error)")
return
}
if let response = response as? HTTPURLResponse, response.statusCode == 200 {
print("上传成功")
} else {
print("服务器返回错误")
}
}
task.resume()使用 URLSession.shared.dataTask 发送请求并接收服务器的响应。
如果 error 不为空，打印错误信息；否则检查 statusCode 是否为 200（表示请求成功）。
task.resume() 开始任务。
4、整体流程总结
这段代码主要完成了以下操作：
构建请求：配置 URLRequest 并设置 POST 方法和 Content-Type。
构建请求体：逐步将文本字段、图片数据和边界添加到请求体中。
执行请求：使用 dataTask 发送请求并处理服务器响应。
这种方式适合上传包含文本参数和文件（如图片）的复杂请求。
5、调用流程
这段代码的调用方式是通过传递一个包含表单字段的字典 (parameters)，一个 UIImage 对象 (image)，以及上传的目标 URL，构建一个 multipart/form-data 请求，适用于提交图片和文字内容的表单。各字段的值通过 parameters 字典传入。具体调用可以如下：
// 1. 创建 URL 指向服务器端的接口
let url = URL(string: "https://example.com/upload")!
// 2. 准备图片对象和表单数据
let image = UIImage(named: "exampleImage")! // 假设这个 UIImage 已经存在
let parameters: [String: String] = [
"username": "user123",
"email": "user@example.com",
"description": "This is an image upload"
]
// 3. 调用上传函数
uploadImageAndText(url: url, image: image, parameters: parameters)代码中的参数传递逻辑
1、表单字段：在 parameters 字典中，键值对（例如 “username”: “user123”, “email”: “user@example.com”）代表表单中的各个文本字段。这些字段将按代码中的 for (key, value) in parameters 循环逐一添加到请求体中。
2、图片文件：UIImage 对象（此处为 image）使用 jpegData(compressionQuality:) 转换为二进制数据并添加到请求体中，模拟文件上传。
3、URL：代表服务器的上传端点，如示例中的 https://example.com/upload。
multipart/form-data 的常用情景
multipart/form-data 的格式用于表单中包含多种类型的数据（如文本字段、文件等）时。它在上传带有文件的表单时特别有用，因为每个表单字段都有边界 (boundary) 作为分隔，服务器可以根据 Content-Disposition 头解析每个字段内容。这种请求体格式可以包含任意数量的字段，参数名会按需求传入 parameters 字典，上传过程无需显式指定每个字段。
6、注意事项
文件类型：上传图片时要注意 Content-Type 与文件类型对应（如 image/jpeg）。
编码：边界和 Content-Disposition 头信息需使用 .utf8 编码。
文件大小：建议在上传大文件时使用 URLSession.uploadTask 和 fromFile 参数，避免内存占用过大。
第三方网络库
Alamofire（第三方库）
特点：Alamofire 是 Swift 中流行的网络请求库，它封装了 HTTP 请求、数据编码、文件上传等多项功能，使代码更简洁。
适用场景：适合所有类型的网络请求，尤其是复杂的多参数请求和文件上传。
实现方法：
使用 AF.upload 方法可以直接上传 multipart/form-data，它会自动处理边界和数据格式等细节。
优点：代码简洁，处理细节少。
