怎么在Spring Boot 項(xiàng)目中實(shí)現(xiàn)一個(gè)文件下載功能？針對(duì)這個(gè)問(wèn)題，這篇文章詳細(xì)介紹了相對(duì)應(yīng)的分析和解答，希望可以幫助更多想解決這個(gè)問(wèn)題的小伙伴找到更簡(jiǎn)單易行的方法。

10年積累的網(wǎng)站建設(shè)、成都網(wǎng)站制作經(jīng)驗(yàn)，可以快速應(yīng)對(duì)客戶對(duì)網(wǎng)站的新想法和需求。提供各種問(wèn)題對(duì)應(yīng)的解決方案。讓選擇我們的客戶得到更好、更有力的網(wǎng)絡(luò)服務(wù)。我雖然不認(rèn)識(shí)你，你也不認(rèn)識(shí)我。但先網(wǎng)站制作后付款的網(wǎng)站建設(shè)流程，更有萍鄉(xiāng)免費(fèi)網(wǎng)站建設(shè)讓你可以放心的選擇與我們合作。

（一）需求

在您的 springboot 項(xiàng)目中，可能會(huì)存在讓用戶下載文檔的需求，比如讓用戶下載 readme 文檔來(lái)更好地了解該項(xiàng)目的概況或使用方法。

所以，您需要為用戶提供可以下載文件的 API ，將用戶希望獲取的文件作為下載資源返回給前端。

（二）代碼

maven 依賴

請(qǐng)您創(chuàng)建好一個(gè) springboot 項(xiàng)目，一定要引入 web 依賴：

  org.springframework.boot
  spring-boot-starter-web

建議引入 thymeleaf 作為前端模板：

  org.springframework.boot
  spring-boot-starter-thymeleaf

配置 application

在您的 application.yml 中，進(jìn)行如下屬性配置：

file:
 doc-dir: doc/

該路徑就是待下載文件存放在服務(wù)器上的目錄，為相對(duì)路徑，表示與當(dāng)前項(xiàng)目（jar包）的相對(duì)位置。

將屬性與 pojo 類自動(dòng)綁定

springboot 中的注解 @ConfigurationProperties 可以將 application 中定義的屬性與 pojo 類自動(dòng)綁定。所以，我們需要定義一個(gè) pojo 類來(lái)做 application 中 file.doc-dir=doc/ 的配置綁定：

@ConfigurationProperties(prefix = "file")
@Data
public class FileProperties {
  private String docDir;
}

注解 @ConfigurationProperties(prefix = "file") 在 springboot 應(yīng)用啟動(dòng)時(shí)將 file 為前綴的屬性與 pojo 類綁定，也就是將 application.yml 中的 file.doc-dir 與 FileProperties 中的字段 docDir 做了綁定。

激活配置屬性

在啟動(dòng)類或其他配置類（@Configuration注解標(biāo)記）上加入 @EnableConfigurationProperties 即可讓 ConfigurationProperties 特性生效。

@SpringBootApplication
@EnableConfigurationProperties({FileProperties.class})
public class AutoTestApplication {
  public static void main(String[] args) {
    SpringApplication.run(AutoTestApplication.class, args);
  }
}

控制層

在控制層我們將以 spring 框架的 ResponseEntity 類作為返回值傳給前端，其中泛型為 spring io 包的 Resource 類，這意味著返回內(nèi)容為 io 流資源；并在返回體頭部添加附件，以便于前端頁(yè)面下載文件。

@RestController
@RequestMapping("file")
public class FileController {
  private static final Logger logger = LoggerFactory.getLogger(FileController.class);
  @Autowired
  private FileService fileService;
  @GetMapping("download/{fileName}")
  public ResponseEntity downloadFile(@PathVariable String fileName,
                         HttpServletRequest request) {
    Resource resource = fileService.loadFileAsResource(fileName);
    String contentType = null;
    try {
      contentType = request.getServletContext().getMimeType(resource.getFile().getAbsolutePath());
    } catch (IOException e) {
      logger.error("無(wú)法獲取文件類型", e);
    }
    if (contentType == null) {
      contentType = "application/octet-stream";
    }
    return ResponseEntity.ok()
        .contentType(MediaType.parseMediaType(contentType))
        .header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + resource.getFilename() + "\"")
        .body(resource);
  }
}

服務(wù)層

服務(wù)層的主要工作是把文件作為 IO 資源加載。注意，在 Service 實(shí)現(xiàn)類的構(gòu)造方法中要使用 @Autowired 注入前面定義好的屬性綁定類 FileProperties.

@Service
public class FileServiceImpl implements FileService {
  private final Path filePath;
  @Autowired
  public FileServiceImpl(FileProperties fileProperties) {
    filePath = Paths.get(fileProperties.getDocDir()).toAbsolutePath().normalize();
  }
  @Override
  public Resource loadFileAsResource(String fileName) {
    Path path = filePath.resolve(fileName).normalize();
    try {
      UrlResource resource = new UrlResource(path.toUri());
      if (resource.exists()) {
        return resource;
      }
      throw new FileException("file " + fileName + " not found");
    } catch (MalformedURLException e) {
      throw new FileException("file " + fileName + " not found", e);
    }
  }
}

自定義異常

在服務(wù)層，我們拋出自定義的文件異常 FileException.

public class FileException extends RuntimeException {
  public FileException(String message) {
    super(message);
  }
  public FileException(String message, Throwable cause) {
    super(message, cause);
  }
}

前端

在前端 html 頁(yè)面，可以使用 a 標(biāo)簽來(lái)下載文件，注意在 a 標(biāo)簽中定義 download 屬性來(lái)規(guī)定這是一個(gè)下載文件。

下載使用手冊(cè)

關(guān)于怎么在Spring Boot 項(xiàng)目中實(shí)現(xiàn)一個(gè)文件下載功能問(wèn)題的解答就分享到這里了，希望以上內(nèi)容可以對(duì)大家有一定的幫助，如果你還有很多疑惑沒(méi)有解開(kāi)，可以關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道了解更多相關(guān)知識(shí)。