SpringBoot返回多种格式的数据的实现示例

目录

• 一、SpringBoot整合FastJson
• 1.1、引入FastJson依赖包
• 1.2、创建一个Web MVC的配置类，并放在springboot扫描包路径下。
• 1.3、测试fastjson是否引入成功。
• 二、SpringBoot返回XML数据
• 2.1、引入jackson组件依赖
• 2.2、新建vo类，引入jackson-xml注解
• 2.3、建立RestController测试返回数据
• 三、SpringBoot返回PDF数据
• 3.1、引入ITextPdf组件依赖
• 3.2、引入系统字体库
• 3.3、在pdf中存入图片
• 3.4、创建pdf生成控制器
• 四、SpringBoot返回Excel数据
• 4.1、引入easypoi-spring-boot-starter依赖库
• 4.2、新建Message类
• 4.3、新建ExcelAction负责生成Excel
• 五、SpringBoot返回资源流
• 5.1、返回图像流
• 5.2、返回视频流
• 六、SpringBoot文件下载

一、SpringBoot整合FastJson

1.1、引入FastJson依赖包

maven项目：

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>1.2.78</version>
</dependency>

gradle项目：

compile 'com.alibaba:fastjson:1.2.78'    // 引入fastjson

1.2、创建一个Web MVC的配置类，并放在springboot扫描包路径下。

package com.it.config;

import com.alibaba.fastjson.serializer.SerializerFeature;
import com.alibaba.fastjson.support.config.FastJsonConfig;
import com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.MediaType;
import org.springframework.http.converter.HttpMessageConverter;
import org.springframework.http.converter.json.MappingJackson2HttpMessageConverter;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

import java.util.ArrayList;
import java.util.List;

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        // 1.springboot默认使用Jaskson组件,需要先移除Jaskson组件
        for (HttpMessageConverter<?> converter : converters) { // 循环所有的转换器
            if (converter instanceof MappingJackson2HttpMessageConverter) {
                converters.remove(converter); // 删除Jaskson转换器
            }
        }
        // 2. 项目中添加fastJson转换器
        FastJsonHttpMessageConverter fastJsonHttpMessageConverter = new FastJsonHttpMessageConverter();
        // 3. 配置fastJson转换器
        FastJsonConfig fastJsonConfig = new FastJsonConfig();
        fastJsonConfig.setSerializerFeatures( // 配置序列化相关操作
                SerializerFeature.WriteMapNullValue,              // 允许Map内容为null
                SerializerFeature.WriteNullListAsEmpty,           // list集合为null使用[]代替
                SerializerFeature.WriteNullStringAsEmpty,         // String内容为null使用空文字代替
                SerializerFeature.WriteDateUseDateFormat,         // 日期格式化输出
                SerializerFeature.WriteNullNumberAsZero,          // 数字为空使用0代替
                SerializerFeature.DisableCircularReferenceDetect  // 禁用循环引用
        );
        fastJsonHttpMessageConverter.setFastJsonConfig(fastJsonConfig); // 配置fastjson转换处理
        // 4. 配置响应的头信息
        List<MediaType> fastJsonMediaTypes = new ArrayList<>(); // 所有的响应类型
        fastJsonMediaTypes.add(MediaType.APPLICATION_JSON); // 使用JSON类型进行相应
        fastJsonHttpMessageConverter.setSupportedMediaTypes(fastJsonMediaTypes);
        // 5. 转换器列表中添加配置好的fastjson组件
        converters.add(fastJsonHttpMessageConverter);
    }
}

1.3、测试fastjson是否引入成功。

创建Message类：

import com.fasterxml.jackson.annotation.JsonFormat;
import lombok.Data;

import java.util.Date;

@Data
public class Message {
    private String title;
    @JsonFormat(pattern = "yyyy年MM月dd日")
    private Date pubDate;
    private String content;
}

RestController中添加测试方法：

@RequestMapping("/echo")
public Object echo(Message message) {
    message.setTitle("【echo】" + message.getTitle());
    message.setContent("【echo】" + message.getContent());
    return message;
}

访问echo发现fastjson引入成功：

二、SpringBoot返回XML数据

2.1、引入jackson组件依赖

jackson组件既支持json操作，也支持xml操作。

<dependency>
    <groupId>com.fasterxml.jackson.dataformat</groupId>
    <artifactId>jackson-dataformat-xml</artifactId>
    <version>2.12.2</version>
</dependency>

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.12.2</version>
</dependency>

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-annotations</artifactId>
    <version>2.12.2</version>
</dependency>

如果使用的是gradle构建项目：

compile 'com.fasterxml.jackson.dataformat:jackson-dataformat-xml:2.12.2'
compile 'com.fasterxml.jackson.core:jackson-databind:2.12.2'
compile 'com.fasterxml.jackson.core:jackson-annotations:2.12.2'

2.2、新建vo类，引入jackson-xml注解

package com.it.vo;

import lombok.Data;

import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;
import java.util.Date;

@Data
@XmlRootElement  // 定义XML根元素
public class Message {
    @XmlElement  // xml元素
    private String title;
    @XmlElement
    private Date pubDate;
    @XmlElement
    private String content;
}

2.3、建立RestController测试返回数据

@RequestMapping("/echo")
public Object echo(Message message) {
    message.setTitle("【echo】" + message.getTitle());
    message.setContent("【echo】" + message.getContent());
    return message;
}

三、SpringBoot返回PDF数据

PDF是Portable Document Format的简称，意为“可携带文档格式”，是由Adobe Systems用于与应用程序、操作系统、硬件无关的方式进行文件交换所发展出的文件格式。PDF文件以PostScript语言图象模型为基础，无论在哪种打印机上都可保证精确的颜色和准确的打印效果，即PDF会忠实地再现原稿的每一个字符、颜色以及图象。

在java项目中，itextpdf组件是比较常见的pdf创建工具、如果想要让SpringBoot程序以PDF的形式进行相应，那么需要引入ITextPdf创建组件依赖。

3.1、引入ITextPdf组件依赖

<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>itextpdf</artifactId>
    <version>5.5.13.2</version>
</dependency>

如果使用的是gradle构建的项目：

compile 'com.itextpdf:itextpdf:5.5.13.2'

3.2、引入系统字体库

将pdf打印需要用到的字体放到项目资源路径：src/main/resources/fonts下（windows系统字体库路径：C:\Windows\Fonts）

3.3、在pdf中存入图片

在src/main/resources/images下存放一张图片pic.jpg。

3.4、创建pdf生成控制器

package com.it.action;

import com.itextpdf.text.*;
import com.itextpdf.text.pdf.BaseFont;
import com.itextpdf.text.pdf.PdfPCell;
import com.itextpdf.text.pdf.PdfPTable;
import com.itextpdf.text.pdf.PdfWriter;
import org.springframework.core.io.ClassPathResource;
import org.springframework.core.io.Resource;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;

import javax.servlet.http.HttpServletResponse;

@Controller
@RequestMapping("/pdf")
public class PDFAction {

    @GetMapping("/create")
    public void createPDF(HttpServletResponse response) throws Exception { // 使用response处理响应
        response.setHeader("Content-Type", "application/pdf"); // 设置相应类型
        // 强制开启下载，并配置下载名称
        response.setHeader("Content-Disposition", "attachment;filename=a.pdf");
        // 使用iTextPdf在内存生成pdf
        Document document = new Document(PageSize.A4, 10, 10, 50, 20); // 设置页面大小、边距
        // 获取pdf的输出流配置
        PdfWriter.getInstance(document, response.getOutputStream());
        // 开始构建pdf文档内容
        document.open();
        Resource imageResource = new ClassPathResource("/images/pic.jpg"); // Spring提供的资源访问
        Image image = Image.getInstance(imageResource.getFile().getAbsolutePath()); // 通过指定路径加载图片
        // PDF在生成文件的时候是基于坐标的方式进行绘制
        image.scaleToFit(PageSize.A4.getWidth() / 2, PageSize.A4.getHeight());
        float printX = (PageSize.A4.getWidth() - image.getScaledWidth()) / 2;
        float printY = PageSize.A4.getHeight() - image.getHeight() - 100;
        image.setAbsolutePosition(printX, printY); // 设置图片绘制坐标
        document.add(image);
        document.add(new Paragraph("\n\n\n")); //图片之后换三行输出文字
        // 加载字库
        Resource fontResource = new ClassPathResource("/fonts/FZSTK.TTF");
        BaseFont baseFont = BaseFont.createFont(fontResource.getFile().getAbsolutePath(),
                BaseFont.IDENTITY_H, BaseFont.EMBEDDED);
        Font font = new Font(baseFont, 20, Font.NORMAL); // 引用字库
        // pdf上绘制文本信息
        String[] titles = new String[]{"springboot test"};
        for (String title : titles) { // 循环输出
            PdfPTable table = new PdfPTable(2); // 定义表格
            PdfPCell cell = new PdfPCell(); //创建单元格
            cell.setPhrase(new Paragraph(title, font)); // 单元格内容
            table.addCell(cell); // 追加单元格
            document.add(table); // 追加文档
        }
        document.close();
    }
}

四、SpringBoot返回Excel数据

springboot为了便于用户生成Excel文件，提供了easypoi-spring-boot-starter依赖库。

4.1、引入easypoi-spring-boot-starter依赖库

<dependency>
    <groupId>cn.afterturn</groupId>
    <artifactId>easypoi-spring-boot-starter</artifactId>
    <version>4.4.0</version>
</dependency>

如果是gradle项目：

compile 'cn.afterturn:easypoi-spring-boot-starter:4.4.0'

4.2、新建Message类

excel表格可以通过java bean转换生成。

package com.it.vo;

import cn.afterturn.easypoi.excel.annotation.Excel;
import lombok.Data;

import java.util.Date;

@Data
public class Message {
    @Excel(name = "信息标题", orderNum = "0", width = 30)
    private String title;
    @Excel(name = "信息日期", orderNum = "1", width = 50)
    private Date pubDate;
    @Excel(name = "信息内容", orderNum = "2", width = 100)
    private String content;
}

4.3、新建ExcelAction负责生成Excel

package com.it.action;

import cn.afterturn.easypoi.excel.entity.ExportParams;
import cn.afterturn.easypoi.excel.entity.enmus.ExcelType;
import cn.afterturn.easypoi.excel.export.ExcelExportService;
import com.it.vo.Message;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;

import javax.servlet.http.HttpServletResponse;
import java.util.ArrayList;
import java.util.Date;
import java.util.List;

@Controller
@RequestMapping("/excel")
public class ExcelAction {

    @GetMapping("/create")
    public void createExcel(HttpServletResponse response) throws Exception { // 使用response处理响应
        response.setHeader("Content-Type",
                "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"); // 设置响应类型
        // 强制开启下载，并配置下载名称
        response.setHeader("Content-Disposition", "attachment;filename=test.xls");
        List<Message> messageList = new ArrayList<>();
        messageList.add(new Message("重大消息", new Date(), "xxx厂喜迎重大改革"));
        messageList.add(new Message("首届稀土开发者大会全日程公布", new Date(), "27-28日直播两天精彩不停！"));
        ExportParams exportParams = new ExportParams("消息管理", "最新消息", ExcelType.XSSF);
        XSSFWorkbook workbook = new XSSFWorkbook();
        new ExcelExportService().createSheet(workbook, exportParams, Message.class, messageList);
        workbook.write(response.getOutputStream());
    }
}

五、SpringBoot返回资源流

在进行前后端分离设计的时候，需要进行一些资源的加载，一般会有两种做法：

• 直接通过远程文件服务器进行资源的加载。
• 通过程序进行加载。

5.1、返回图像流

程序在进行图像流返回的时候只需要将返回类型设置为图片即可。

5.1.1、创建ImageAction负责返回图像流

package com.it.action;

import org.springframework.core.io.ClassPathResource;
import org.springframework.core.io.Resource;
import org.springframework.http.MediaType;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.io.IOException;
import java.io.InputStream;

@RestController
@RequestMapping("/image")
public class ImageAction {

    @GetMapping(value = "/download", produces =
            {MediaType.IMAGE_JPEG_VALUE, MediaType.IMAGE_GIF_VALUE, MediaType.IMAGE_PNG_VALUE}) // 设置返回类型
    public byte[] createImage() throws IOException {
        Resource imageResource = new ClassPathResource("/images/dog.jpg");
        InputStream inputStream = imageResource.getInputStream();
        byte[] bytes = new byte[inputStream.available()];
        inputStream.read(bytes, 0, imageResource.getInputStream().available());// 实现文件加载
        return bytes;
    }
}

5.1.2、输入访问路径

http://localhost:8080/image/download

5.2、返回视频流

SpringBoot可以实现对视频流的控制。

5.2.1、提供视频资源的请求处理器

package com.it.handler;

import org.springframework.core.io.ClassPathResource;
import org.springframework.core.io.Resource;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.resource.ResourceHttpRequestHandler;

import javax.servlet.http.HttpServletRequest;
import java.io.IOException;

/**
 * 请求处理器
 */
@Component
public class VideoResourceHttpRequestHandler extends ResourceHttpRequestHandler {
    @Override
    public Resource getResource(HttpServletRequest request) throws IOException {
        return new ClassPathResource("/videos/study.mp4");
    }
}

5.2.2、定义视频响应Action类

package com.it.action;

import com.it.handler.VideoResourceHttpRequestHandler;
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.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@RestController
@RequestMapping("/video")
public class VideoAction {

    private final VideoResourceHttpRequestHandler videoResourceHttpRequestHandler;

    public VideoAction(VideoResourceHttpRequestHandler videoResourceHttpRequestHandler) {
        this.videoResourceHttpRequestHandler = videoResourceHttpRequestHandler;
    }

    @GetMapping("/download")
    public void createVideo(HttpServletRequest request, HttpServletResponse response) throws Exception {
        this.videoResourceHttpRequestHandler.handleRequest(request, response);
    }
}

5.2.3、输入访问路径

http://localhost:8080/video/download

六、SpringBoot文件下载

SpringBoot可以直接通过输出流的方式实现文件下载，例如下载resources/files/banner.rar文件：

package com.it.action;

import org.springframework.core.io.ClassPathResource;
import org.springframework.core.io.Resource;
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.io.InputStream;

@RestController
@RequestMapping("/file")
public class DownloadAction {

    @GetMapping("/download")
    public void fileDownload(HttpServletResponse response) throws IOException {
        response.setContentType("application/force-download");// 强制性下载
        response.setHeader("Content-Disposition", "attachment;filename=banner.rar");
        Resource fileResource = new ClassPathResource("/files/banner.rar"); // 要下载的文件
        // 通过IO流读取文件内容
        InputStream input = fileResource.getInputStream();
        byte[] data = new byte[1024]; // 每次最多读取1024字节
        int len = 0; // 每次读取的字节数
        while ((len = input.read(data)) != -1) {
            response.getOutputStream().write(data, 0, len);
        }
    }
}

访问：http://localhost:8080/file/download:

到此这篇关于SpringBoot返回多种格式的数据的实现示例的文章就介绍到这了,更多相关SpringBoot返回多种格式内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们！