iOS本地文件上传到服务端

原创

mob64ca12f55920 2025-01-01 05:16:59 ©著作权

©著作权归作者所有：来自51CTO博客作者mob64ca12f55920的原创作品，请联系作者获取转载授权，否则将追究法律责任

iOS本地文件上传到服务端

在移动应用开发中，文件上传是一个常见的需求。今天，我们将一起学习如何将iOS本地文件上传到服务器。这个过程虽然涉及多个步骤，但只要我们逐步进行，就能够轻松实现。下面是整体流程的概述，以及实现每一步所需的代码。

流程概述

首先，我们来展示一下整个文件上传的流程：

步骤	内容
1	选择本地文件
2	准备请求，设置请求头和请求体
3	发送请求到服务端
4	处理响应

每一步的实现

接下来，我们来看一下每一步的具体实现方法。

步骤1：选择本地文件

要选择本地文件，我们可以使用 UIDocumentPickerViewController。下面是选择文件的代码：

import UIKit

class ViewController: UIViewController {
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        // 创建一个按钮来选择文件
        let button = UIButton(type: .system)
        button.setTitle("选择文件", for: .normal)
        button.addTarget(self, action: #selector(selectFile), for: .touchUpInside)
        button.frame = CGRect(x: 100, y: 100, width: 100, height: 50)
        self.view.addSubview(button)
    }
    
    // 文件选择方法
    @objc func selectFile() {
        let documentPicker = UIDocumentPickerViewController(documentTypes: ["public.data"], in: .import)
        documentPicker.delegate = self
        present(documentPicker, animated: true, completion: nil)
    }
}

extension ViewController: UIDocumentPickerDelegate {
    func documentPicker(_ controller: UIDocumentPickerViewController, didPickDocumentsAt urls: [URL]) {
        // 这里处理选择的文件
        guard let url = urls.first else { return }
        uploadFile(url: url)  // 选择文件后开始上传文件
    }
}

在这段代码中，我们创建了一个按钮来选择文件，并打开文档选择器。用户选择文件后，我们将调用 uploadFile 方法来上传文件。

步骤2：准备请求

在文件选择完成后，我们需要准备好 HTTP 请求，以便将文件发送到服务器。以下是请求准备的代码：

func uploadFile(url: URL) {
    guard let serverUrl = URL(string: " else { return }
    
    var request = URLRequest(url: serverUrl)
    request.httpMethod = "POST"
    
    // 创建断点和边界
    let boundary = UUID().uuidString
    request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")

    // 文件数据
    do {
        let fileData = try Data(contentsOf: url)
        // 在请求体中添加文件信息
        var body = ""
        body += "--\(boundary)\r\n"
        body += "Content-Disposition: form-data; name=\"file\"; filename=\"\(url.lastPathComponent)\"\r\n"
        body += "Content-Type: application/octet-stream\r\n\r\n"
        body += String(data: fileData, encoding: .utf8) ?? ""
        body += "\r\n--\(boundary)--\r\n"
        
        request.httpBody = body.data(using: .utf8)
    } catch {
        print("文件读取错误: \(error)")
    }
    
    // 发送请求
    sendRequest(request: request)
}

步骤3：发送请求

最后，我们通过 URLSession 发送请求，将文件上传到服务器。以下是发送请求的代码：

func sendRequest(request: URLRequest) {
    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()  // 启动任务
}

整体状态图和旅程图

在代码实现上，我们可以使用 mermaid 语法展示状态图和旅程图。以下是状态图的示例：

stateDiagram
    [*] --> 选择文件
    选择文件 --> 上传文件
    上传文件 --> 上传成功
    上传文件 --> 上传失败

接下来是旅程图：

journey
    title 文件上传到服务端的旅程
    section 选择文件
      用户选择文件: 5: 用户
    section 上传文件
      系统构建请求: 3: 系统
      系统发送请求: 5: 系统
    section 响应处理
      处理上传成功: 5: 系统
      处理上传失败: 5: 系统