springboot集成easypoi导出word换行处理过程

 更新时间:2025年08月16日 08:39:06   作者:涛哥是个大帅比  
Spring Boot集成Easypoi导出Word时,换行符\n失效显示为空格,解决方法包括生成段落或替换模板中\n为回车,同时需确保变量{{temp}}在Map中设为"  "(带空格空字符串),避免空指针或残留变量

项目场景

springboot集成easypoi导出word

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

问题描述

spring boot集成easypoi导出word时,内容包含换行符\n,导出word时换行符失效,会将换行符\n识别为空格。

解决方案

第一种:生成段落的方式

示例代码:

import com.xinghuo.common.base.ActionResult;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import lombok.Cleanup;
import org.apache.poi.xwpf.usermodel.XWPFDocument;
import org.apache.poi.xwpf.usermodel.XWPFParagraph;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.io.File;
import java.io.FileOutputStream;

@RestController
@Api(tags = "测试")
@RequestMapping("/test")
public class TestController {

    @ApiOperation("导出Word")
    @GetMapping("/export")
    public ActionResult export() {
        exportWord();
        return ActionResult.success();
    }

    /**
     * 导出Word,支持换行
     */
    public void exportWord(){
        try{
            String content = "第一行\n第二行中文\n"+"第三行";

            @Cleanup XWPFDocument doc = new XWPFDocument();

            if(content != null && content.contains("\n")) {
                //设置换行
                String[] text = content.split("\n");
                for (int i = 0; i < text.length; i++) {
                    XWPFParagraph p = doc.createParagraph();
                    p.createRun().setText(text[i]);
                }
            }else{
                XWPFParagraph p = doc.createParagraph();
                p.createRun().setText(content);
            }

            String name = "测试换行内容.docx";
            String filePath = "F:"+ File.separator + name;
            @Cleanup FileOutputStream output = new FileOutputStream(filePath);
            doc.write(output);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

导出的word内容

第二种:替换模板的情况,换行符替换成回车

示例代码:

import cn.afterturn.easypoi.word.WordExportUtil;
import com.xinghuo.common.base.ActionResult;
import com.xinghuo.common.util.XSSEscape;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import lombok.Cleanup;
import org.apache.poi.xwpf.usermodel.XWPFDocument;
import org.apache.poi.xwpf.usermodel.XWPFParagraph;
import org.apache.poi.xwpf.usermodel.XWPFRun;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.io.File;
import java.io.FileOutputStream;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

@RestController
@Api(tags = "测试")
@RequestMapping("/test")
public class Test1Controller {

    @ApiOperation("导出Word")
    @GetMapping("/export")
    public ActionResult export() {
        exportWordTemplate();
        return ActionResult.success();
    }

    /**
     * 导出Word替换模板,支持换行
     */
    public void exportWordTemplate(){
        try{
            String content = "第一行\n第二行中文\n"+"第三行";
            Map<String, Object> map = new HashMap<>();
            map.put("content",content);

            @Cleanup XWPFDocument doc = WordExportUtil.exportWord07("F:/export_template.docx", map);
            //文本换行
            addBreakInCell(doc.getParagraphs());

            String name = "测试换行内容-替换模板.docx";
            String filePath = "F:"+ File.separator + name;
            @Cleanup FileOutputStream output = new FileOutputStream(XSSEscape.escapePath(filePath));
            doc.write(output);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    /**
     * 文本换行
     */
    public static void addBreakInCell(List<XWPFParagraph> paragraphs) {
        for (XWPFParagraph p : paragraphs) {
            for (XWPFRun run : p.getRuns()) {//XWPFRun对象定义具有一组公共属性的文本区域
                if(run.getText(0)!= null && run.getText(0).contains("\n")) {
                    String[] lines = run.getText(0).split("\n");
                    if(lines.length > 0) {
                        run.setText(lines[0], 0); // set first line into XWPFRun
                        for(int i=1;i<lines.length;i++){
                            // add break and insert new text
                            run.addBreak();//中断
//                              run.addCarriageReturn();//回车符,但是不起作用
                            run.setText(lines[i]);
                        }
                    }
                }
            }
        }
    }
}

 其中export_template.docx文件是word模板,内容为:

导出的内容

导出的本地文件截图

总结

 注意:模板中有变量值{{temp}},参数Map里面对应的temp值是null或者"",导出的word就会变成抛空指针异常或者{{temp}}、其他带{{ 的形式,直接在Map中设置temp的值为" ",就可以导出空白到模板,注意是加了空格的字符串" "

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • java compiler没有1.8怎么解决

    java compiler没有1.8怎么解决

    这篇文章主要介绍了java compiler没有1.8的解决方法,非常不错,具有一定的参考借鉴价值,需要的朋友可以参考下
    2018-08-08
  • MyBatis中<collection>标签的多种用法

    MyBatis中<collection>标签的多种用法

    collection标签是处理一对多关系的关键工具,它能够将查询结果巧妙地映射到Java对象的集合属性中,本文主要介绍了MyBatis中<collection>标签的多种用法,感兴趣的可以了解一下
    2025-04-04
  • 一文详解如何在Java中自定义异常类

    一文详解如何在Java中自定义异常类

    这篇文章主要介绍了如何在Java中自定义异常类的相关资料,在Java编程中开发者可以通过继承Exception类或其子类创建自定义异常,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2024-10-10
  • 深入理解SpringBoot的配置环境属性

    深入理解SpringBoot的配置环境属性

    SpringBoot的配置环境属性是一种强大的工具,可以帮助我们配置和管理我们的应用程序,这篇文章主要介绍了SpringBoot的配置环境属性,需要的朋友可以参考下
    2023-07-07
  • Java向上转型与向下转型超详细图解

    Java向上转型与向下转型超详细图解

    我们在Java编程中经常碰到类型转换,对象类型转换主要包括向上转型和向下转型,这篇文章主要介绍了Java向上转型与向下转型的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2025-04-04
  • Java实现简单树结构

    Java实现简单树结构

    这篇文章主要为大家详细介绍了Java实现简单树结构的相关资料,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-01-01
  • 剑指Offer之Java算法习题精讲N叉树的遍历及数组与字符串

    剑指Offer之Java算法习题精讲N叉树的遍历及数组与字符串

    跟着思路走,之后从简单题入手,反复去看,做过之后可能会忘记,之后再做一次,记不住就反复做,反复寻求思路和规律,慢慢积累就会发现质的变化
    2022-03-03
  • 基于openeuler的DataGear部署文档

    基于openeuler的DataGear部署文档

    本文详细介绍了如何在openEuler操作系统上安装和配置JDK以及DataGear,本文给大家介绍的非常详细,感兴趣的朋友跟随小编一起看看吧
    2025-03-03
  • Java文件处理之使用itextpdf实现excel转pdf

    Java文件处理之使用itextpdf实现excel转pdf

    在文件处理中,经常有文件类型转换的使用场景,本文主要介绍了如何使用poi以及itextpdf完成excel转pdf的操作,需要的小伙伴可以参考一下
    2024-02-02
  • 浅谈Thread.sleep()为什么要抛出中断异常

    浅谈Thread.sleep()为什么要抛出中断异常

    本文主要介绍了浅谈Thread.sleep()为什么要抛出中断异常,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-04-04

最新评论