Vapor框架中如何为文件流响应添加自定义头部

在Vapor框架开发过程中，处理文件下载是一个常见需求。框架提供了便捷的streamFile方法来处理文件流传输，但开发者有时需要为这些响应添加自定义HTTP头部信息。

核心解决方案

Vapor的streamFile方法实际上返回的是一个完整的Response对象。这意味着我们可以像处理普通响应一样，对这个响应对象进行各种操作，包括添加、修改或删除HTTP头部。

let response = req.fileio.streamFile(at: "/path/to/file")
response.headers.add(name: "Custom-Header", value: "HeaderValue")
return response

实际应用场景

这种能力在多种场景下非常有用：

1. 内容类型指定：当需要明确设置文件MIME类型时
2. 下载控制：通过Content-Disposition头部控制浏览器行为
3. 缓存控制：设置Cache-Control头部优化性能
4. 安全策略：添加安全相关的头部如X-Content-Type-Options

高级用法示例

下面是一个更完整的示例，展示了如何为PDF文件下载设置多个常用头部：

func downloadPDF(_ req: Request) throws -> Response {
    let filePath = "/documents/report.pdf"
    var response = req.fileio.streamFile(at: filePath)
    
    response.headers.replaceOrAdd(name: .contentType, value: "application/pdf")
    response.headers.add(name: .contentDisposition, value: "attachment; filename=\"年度报告.pdf\"")
    response.headers.add(name: "X-Custom-Tracking", value: "user123")
    response.headers.add(name: .cacheControl, value: "no-store")
    
    return response
}

注意事项

1. 头部名称可以使用Vapor提供的HTTPHeaders.Name枚举中的标准值，也可以直接使用字符串
2. 修改头部应该在返回响应对象之前完成
3. 对于大文件传输，流式处理已经自动优化，添加头部不会影响性能

通过这种方式，开发者可以灵活控制文件传输过程中的各种HTTP行为，满足各种业务需求和安全规范。