詳解如何使用SpringBoot實(shí)現(xiàn)下載JSON文件

更新時(shí)間：2025年02月12日 10:38:00 作者：小信丶

在?Spring?Boot?中實(shí)現(xiàn)文件下載功能,可以通過(guò)將?JSON?字符串作為文件內(nèi)容返回給客戶(hù)端從而實(shí)現(xiàn)JSON文件下載效果,下面我們就來(lái)看看具體操作吧

概述

在 Spring Boot 中實(shí)現(xiàn)文件下載功能，可以通過(guò)將 JSON 字符串作為文件內(nèi)容返回給客戶(hù)端。以下是實(shí)現(xiàn)步驟和代碼示例：

實(shí)現(xiàn)步驟

定義接口：創(chuàng)建一個(gè) REST 控制器，用于處理文件下載請(qǐng)求。

設(shè)置響應(yīng)頭：通過(guò) HttpServletResponse 設(shè)置響應(yīng)頭，指定文件類(lèi)型和下載文件名。

返回文件內(nèi)容：將 JSON 字符串寫(xiě)入響應(yīng)輸出流。

代碼實(shí)現(xiàn)

1. 創(chuàng)建 Spring Boot 控制器

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
 
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.nio.charset.StandardCharsets;
 
@RestController
@RequestMapping("/api")
public class FileDownloadController {
 
    @GetMapping("/download-json")
    public void downloadJsonFile(HttpServletResponse response) throws IOException {
        // 1. 準(zhǔn)備 JSON 字符串
        String jsonContent = "{\"name\":\"John\", \"age\":30, \"city\":\"New York\"}";
 
        // 2. 設(shè)置響應(yīng)頭
        response.setContentType("application/json"); // 文件類(lèi)型為 JSON
        response.setHeader("Content-Disposition", "attachment; filename=\"data.json\""); // 設(shè)置下載文件名
 
        // 3. 將 JSON 字符串寫(xiě)入響應(yīng)輸出流
        response.getOutputStream().write(jsonContent.getBytes(StandardCharsets.UTF_8));
        response.getOutputStream().flush();
    }
}

2. 運(yùn)行并測(cè)試

啟動(dòng) Spring Boot 應(yīng)用。

在瀏覽器中訪(fǎng)問(wèn)接口地址，例如：http://localhost:8080/api/download-json。

瀏覽器會(huì)自動(dòng)下載一個(gè)名為 data.json 的文件，文件內(nèi)容為：

{"name":"John", "age":30, "city":"New York"}

關(guān)鍵點(diǎn)說(shuō)明

1.HttpServletResponse：

用于設(shè)置響應(yīng)頭和輸出流。
setContentType("application/json")：指定文件類(lèi)型為 JSON。
setHeader("Content-Disposition", "attachment; filename=\"data.json\"")：指定文件名為 data.json，并告訴瀏覽器以附件形式下載。

2.文件內(nèi)容寫(xiě)入：

使用 response.getOutputStream().write() 將 JSON 字符串寫(xiě)入響應(yīng)輸出流。
確保使用 StandardCharsets.UTF_8 指定字符編碼，避免亂碼問(wèn)題。

3.文件名：

可以根據(jù)需要?jiǎng)討B(tài)生成文件名，例如：

String fileName = "data_" + System.currentTimeMillis() + ".json";
response.setHeader("Content-Disposition", "attachment; filename=\"" + fileName + "\"");

擴(kuò)展功能

動(dòng)態(tài)生成 JSON 內(nèi)容：可以從數(shù)據(jù)庫(kù)或其他服務(wù)中獲取數(shù)據(jù)，動(dòng)態(tài)生成 JSON 字符串。

壓縮文件下載：如果需要下載壓縮文件（如 .zip），可以使用 ZipOutputStream 將多個(gè)文件打包后返回。

大文件下載：對(duì)于大文件，可以使用分塊傳輸（Transfer-Encoding: chunked）來(lái)優(yōu)化性能。

示例：動(dòng)態(tài)生成 JSON 內(nèi)容

@GetMapping("/download-dynamic-json")
public void downloadDynamicJsonFile(HttpServletResponse response) throws IOException {
    // 動(dòng)態(tài)生成 JSON 數(shù)據(jù)
    Map<String, Object> data = new HashMap<>();
    data.put("timestamp", System.currentTimeMillis());
    data.put("message", "Hello, this is a dynamic JSON file!");
 
    // 將 Map 轉(zhuǎn)換為 JSON 字符串
    String jsonContent = new ObjectMapper().writeValueAsString(data);
 
    // 設(shè)置響應(yīng)頭
    response.setContentType("application/json");
    response.setHeader("Content-Disposition", "attachment; filename=\"dynamic_data.json\"");
 
    // 寫(xiě)入響應(yīng)輸出流
    response.getOutputStream().write(jsonContent.getBytes(StandardCharsets.UTF_8));
    response.getOutputStream().flush();
}

訪(fǎng)問(wèn) http://localhost:8080/api/download-dynamic-json，會(huì)下載一個(gè)包含動(dòng)態(tài)生成內(nèi)容的 JSON 文件。

到此這篇關(guān)于詳解如何使用SpringBoot實(shí)現(xiàn)下載JSON文件的文章就介紹到這了,更多相關(guān)SpringBoot下載JSON內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: