Multipart upload

假设我们想在一个请求中上传GIF的同时附带额外的参数。那么我们如何来解决这个问题? 其实它取决于这个参数是body(e.g. POST, PUT)的一部分，还是是URL的一部分(e.g. GET)。

设置

假设我们有一个遵循TargetType协议的 MyService 服务 :

swift

public enum MyService {
    case uploadGif(Data, description: String)
}

这儿, 我们附加的参数是 description, 它是 String类型.

body中的参数

当我们想在一个请求body中完成附加参数的多部分上传请求时，我们必须为每个创建一个MultipartFormData对象，然后在 task中返回一个.uploadMultipartFormData(_:)实例对象 :

swift

extension MyService: TargetType {
//...
    public var task: Task {
        switch self {
        case let .uploadGif(data, description):
            let gifData = MultipartFormBodyPart(provider: .data(data), name: "file", fileName: "gif.gif", mimeType: "image/gif")
            let descriptionData = MultipartFormBodyPart(provider: .data(description.data(using: .utf8)!), name: "description")
            let multipartData: MultipartFormData = [gifData, descriptionData]
            // Or if you want to specify the boundary and file manager:
            // let multipartData = MultipartFormData(fileManager: .default, boundary: "...", parts: [gifData, descriptionData])

            return .uploadMultipartFormData(multipartData)
        }
    }
//...
}

在 URL中的参数

在 URL中的附加参数, 我们只需要使用新的 Task 类型, uploadCompositeMultipartFormData(_:urlParameters):

swift

extension MyService: TargetType {
//...
    public var task: Task {
        switch self {
        case let .uploadGif(data, description):
            let gifData = MultipartFormBodyPart(provider: .data(data), name: "file", fileName: "gif.gif", mimeType: "image/gif")
            let multipartData: MultipartFormData = [gifData]
            // Or if you want to specify the boundary and file manager:
            // let multipartData = MultipartFormData(fileManager: .default, boundary: "...", parts: [gifData])
            
            let urlParameters = ["description": description]

            return .uploadCompositeMultipartFormData(multipartData, urlParameters: urlParameters)
        }
    }
//...
}