swagger显示下载文件注解

Swagger 是一个用于设计、构建、记录和使用 RESTful Web 服务的开源软件框架。Swagger 允许开发人员设计和描述 API 的结构，以便机器可以读取它们。这意味着通过 Swagger，开发人员可以自动生成文档、客户端库等。

在使用 Swagger 注解来描述一个 API 方法，使其在响应中返回文件下载时，可以使用 `@ApiResponses` 和 `@ApiResponse` 注解来定义响应的状态码和内容类型。同时，为了处理文件流的传输，通常需要在控制器的方法中使用 `HttpServletResponse` 或者类似的方式来进行文件的写入和传输。

例如，在 Spring Boot 应用中，一个控制器方法可能看起来像这样：

import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import io.swagger.annotations.ApiResponse;
import io.swagger.annotations.ApiResponses;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;

@RestController
@Api(value = "文件下载API", description = "提供文件下载服务")
public class FileDownloadController {

    @GetMapping("/download")
    @ApiOperation(value = "下载文件", notes = "返回一个文件给用户下载")
    @ApiResponses({
            @ApiResponse(code = 200, message = "请求成功，返回文件内容"),
            @ApiResponse(code = 500, message = "服务器内部错误")
    })
    public void downloadFile(HttpServletResponse response) throws IOException {
        // 设置响应头，告诉浏览器这是一个附件，需要下载
        response.setContentType("application/octet-stream");
        response.setHeader("Content-Disposition", "attachment; filename=\"example.txt\"");

        PrintWriter writer = response.getWriter();
        writer.write("这是要下载的文件内容");
        writer.flush();
        writer.close();
    }
}

上面的代码示例中，`@Api` 用于描述整个控制器，`@ApiOperation` 描述具体的操作，`@ApiResponses` 和 `@ApiResponse` 定义了该操作可能返回的 HTTP 状态码和相应的消息。