AI 助理
备案控制台
开发者社区 开发与运维 文章 正文

使用Freemarker模版导出xls文件使用excel打开提示文件损坏

2024-02-20 183
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 使用Freemarker模版导出xls文件使用excel打开提示文件损坏

本文是通过一步步的还原事件的发生并解决的一个过程记录，如果想知道如何解决的可以直接跳转文章末尾结论部分

提示一下，关注一下 Table 标签中的 ss:ExpandedRowCount 属性

解决的问题

在项目中使用freemarker的xml模板导出xls格式的Excel文件时，使用国产Office工具可以打开查看，使用Excel打开提示文件已损坏

关键词

国产office，Excel，freemarker

环境信息

  • Windows 11
  • office 2019
  • 永中office2022体验版
  • JDK8
  • springboot 2.6.13
  • freemarker 2.6.13

事件还原

1、首先使用Excel创建一个空白excel文件，输入我们要导出的表格模板，如下图所示，我们创建一个表格，表格中导出姓名、年龄、电话、住址等信息的这样一个表格，并且添加了一行示例数据

2、点击另存为，选中xml格式导出

3、打开xml文件，修改添加数据的地方，使用freemarker语法遍历输出数据

修改前如下图所示

修改后如下图所示

其中的#list为固定语法，resultList为获取输入模板数据的key，该值是一个List，as item是*List**中的每一个对象以item来遍历

item.name为获取姓名，item.age为获取年龄，item.phont为获取电话，item.address为获取住址

${item.name!''}的完整意思就是输出用户名，为空时输出为空

4、创建springboot程序，并在resources下创建freemarker目录，继续创建test.xml模板文件，test.xml文件内容就是上一步我们修改完成之后的xml文件，结构如下

文件内容如下（本内容为Excel打开异常的，如需正常的，需跳转文章末尾）

提示一下，关注一下 Table 标签中的 ss:ExpandedRowCount 属性

<?xml version="1.0"?>
<?mso-application progid="Excel.Sheet"?>
<Workbook xmlns="urn:schemas-microsoft-com:office:spreadsheet"
          xmlns:o="urn:schemas-microsoft-com:office:office"
          xmlns:x="urn:schemas-microsoft-com:office:excel"
          xmlns:ss="urn:schemas-microsoft-com:office:spreadsheet"
          xmlns:html="http://www.w3.org/TR/REC-html40">
    <DocumentProperties xmlns="urn:schemas-microsoft-com:office:office">
        <Author>zuiyu</Author>
        <LastAuthor>zuiyu</LastAuthor>
        <Created>2023-07-26T02:16:31Z</Created>
        <LastSaved>2023-07-26T02:18:00Z</LastSaved>
        <Version>16.00</Version>
    </DocumentProperties>
    <OfficeDocumentSettings xmlns="urn:schemas-microsoft-com:office:office">
        <AllowPNG/>
    </OfficeDocumentSettings>
    <ExcelWorkbook xmlns="urn:schemas-microsoft-com:office:excel">
        <WindowHeight>5880</WindowHeight>
        <WindowWidth>14400</WindowWidth>
        <WindowTopX>32767</WindowTopX>
        <WindowTopY>32767</WindowTopY>
        <ProtectStructure>False</ProtectStructure>
        <ProtectWindows>False</ProtectWindows>
    </ExcelWorkbook>
    <Styles>
        <Style ss:ID="Default" ss:Name="Normal">
            <Alignment ss:Vertical="Center"/>
            <Borders/>
            <Font ss:FontName="等线" x:CharSet="134" ss:Size="11" ss:Color="#000000"/>
            <Interior/>
            <NumberFormat/>
            <Protection/>
        </Style>
    </Styles>
    <Worksheet ss:Name="Sheet1">
        <Table ss:ExpandedColumnCount="4" ss:ExpandedRowCount="2" x:FullColumns="1"
               x:FullRows="1" ss:DefaultColumnWidth="51" ss:DefaultRowHeight="13.875">
            <Row>
                <Cell><Data ss:Type="String">姓名</Data></Cell>
                <Cell><Data ss:Type="String">年龄</Data></Cell>
                <Cell><Data ss:Type="String">电话</Data></Cell>
                <Cell><Data ss:Type="String">住址</Data></Cell>
            </Row>
            <#list resultList as item>
            <Row>
                <Cell><Data ss:Type="String">${item.name!''}</Data></Cell>
                <Cell><Data ss:Type="Number">${item.age!''}</Data></Cell>
                <Cell><Data ss:Type="Number">${item.phone!''}</Data></Cell>
                <Cell><Data ss:Type="String">${item.address!''}</Data></Cell>
            </Row>
        </#list>
    </Table>
    <WorksheetOptions xmlns="urn:schemas-microsoft-com:office:excel">
        <PageSetup>
            <Header x:Margin="0.3"/>
            <Footer x:Margin="0.3"/>
            <PageMargins x:Bottom="0.75" x:Left="0.7" x:Right="0.7" x:Top="0.75"/>
        </PageSetup>
        <Selected/>
        <Panes>
            <Pane>
                <Number>3</Number>
                <ActiveRow>4</ActiveRow>
                <ActiveCol>5</ActiveCol>
            </Pane>
        </Panes>
        <ProtectObjects>False</ProtectObjects>
        <ProtectScenarios>False</ProtectScenarios>
    </WorksheetOptions>
</Worksheet>
        </Workbook>

5、编写导出excel文件的代码，都是测试数据，看看就好，只是举个例子

需要关注的点是，我们此处导出的用户数据为100，而上文中提示需要关注的参数ss:ExpandedRowCount参数值为2，这就是后文要探讨的关键所在

package com.example.exceldemo.demos.excel;
import freemarker.template.Configuration;
import freemarker.template.Template;
import freemarker.template.TemplateException;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.servlet.ServletOutputStream;
import javax.servlet.http.HttpServletResponse;
import java.io.BufferedWriter;
import java.io.IOException;
import java.io.OutputStreamWriter;
import java.net.URLEncoder;
import java.util.*;
/**
 * @Author zuiyu
 * @Date 2023/7/26 10:26
 */
@RestController
@RequestMapping("/excel")
public class ExcelController {
    @GetMapping("/export")
    public void export(HttpServletResponse response) throws IOException, TemplateException {
        Configuration configuration = new Configuration(Configuration.VERSION_2_3_26);
        configuration.setDefaultEncoding("utf-8");
        configuration.setClassForTemplateLoading(getClass(),"/freemarker");
        Template template = configuration.getTemplate("test.xml");
        List<Person> list = new ArrayList<>();
        for (int i = 0; i < 100; i++) {
            Person person1 = new Person();
            person1.setName("测试用户名:"+i);
            person1.setAge((i+1)*2);
            person1.setPhone(new Random().nextInt(100));
            person1.setAddress("地址:"+i);
            list.add(person1);
        }
        Map<String,Object> map = new HashMap<>();
        map.put("resultList",list);
        ServletOutputStream outputStream = response.getOutputStream();
        response.setContentType("application/octet-stream");
        response.setHeader("Content-Disposition", "attachment; filename=" + URLEncoder.encode("测试xml导出excel.xls", "UTF-8"));
        BufferedWriter bw = new BufferedWriter(new OutputStreamWriter(outputStream));
        template.process(map,bw);
        bw.flush();
        bw.close();
        System.out.println("导出成功");
    }
}

6、下面执行接口http://localhost:8080/excel/export导出xls文件进行查看文件内容，我们的预期就是国产Office可以打开观看，而Excel打开时提示文件已损坏。打开结果就不进行展示了，感兴趣的可以使用上面的代码进行一下测试

7、下面我们修改ss:ExpandedRowCount="2"为ss:ExpandedRowCount="9999"，这样就可以容纳我们的100条记录。此时重启程序进行导出我们就可以发现不管是使用Excel查看还是国产Office查看都可以进行正常的显示了

8、下面是修改之后的完整的xml文件内容

<?xml version="1.0"?>
<?mso-application progid="Excel.Sheet"?>
<Workbook xmlns="urn:schemas-microsoft-com:office:spreadsheet"
          xmlns:o="urn:schemas-microsoft-com:office:office"
          xmlns:x="urn:schemas-microsoft-com:office:excel"
          xmlns:ss="urn:schemas-microsoft-com:office:spreadsheet"
          xmlns:html="http://www.w3.org/TR/REC-html40">
    <DocumentProperties xmlns="urn:schemas-microsoft-com:office:office">
        <Author>zuiyu</Author>
        <LastAuthor>zuiyu</LastAuthor>
        <Created>2023-07-26T02:16:31Z</Created>
        <LastSaved>2023-07-26T02:18:00Z</LastSaved>
        <Version>16.00</Version>
    </DocumentProperties>
    <OfficeDocumentSettings xmlns="urn:schemas-microsoft-com:office:office">
        <AllowPNG/>
    </OfficeDocumentSettings>
    <ExcelWorkbook xmlns="urn:schemas-microsoft-com:office:excel">
        <WindowHeight>5880</WindowHeight>
        <WindowWidth>14400</WindowWidth>
        <WindowTopX>32767</WindowTopX>
        <WindowTopY>32767</WindowTopY>
        <ProtectStructure>False</ProtectStructure>
        <ProtectWindows>False</ProtectWindows>
    </ExcelWorkbook>
    <Styles>
        <Style ss:ID="Default" ss:Name="Normal">
            <Alignment ss:Vertical="Center"/>
            <Borders/>
            <Font ss:FontName="等线" x:CharSet="134" ss:Size="11" ss:Color="#000000"/>
            <Interior/>
            <NumberFormat/>
            <Protection/>
        </Style>
    </Styles>
    <Worksheet ss:Name="Sheet1">
        <Table ss:ExpandedColumnCount="4" ss:ExpandedRowCount="9999" x:FullColumns="1"
               x:FullRows="1" ss:DefaultColumnWidth="51" ss:DefaultRowHeight="13.875">
            <Row>
                <Cell><Data ss:Type="String">姓名</Data></Cell>
                <Cell><Data ss:Type="String">年龄</Data></Cell>
                <Cell><Data ss:Type="String">电话</Data></Cell>
                <Cell><Data ss:Type="String">住址</Data></Cell>
            </Row>
            <#list resultList as item>
            <Row>
                <Cell><Data ss:Type="String">${item.name!''}</Data></Cell>
                <Cell><Data ss:Type="Number">${item.age!''}</Data></Cell>
                <Cell><Data ss:Type="Number">${item.phone!''}</Data></Cell>
                <Cell><Data ss:Type="String">${item.address!''}</Data></Cell>
            </Row>
        </#list>
    </Table>
    <WorksheetOptions xmlns="urn:schemas-microsoft-com:office:excel">
        <PageSetup>
            <Header x:Margin="0.3"/>
            <Footer x:Margin="0.3"/>
            <PageMargins x:Bottom="0.75" x:Left="0.7" x:Right="0.7" x:Top="0.75"/>
        </PageSetup>
        <Selected/>
        <Panes>
            <Pane>
                <Number>3</Number>
                <ActiveRow>4</ActiveRow>
                <ActiveCol>5</ActiveCol>
            </Pane>
        </Panes>
        <ProtectObjects>False</ProtectObjects>
        <ProtectScenarios>False</ProtectScenarios>
    </WorksheetOptions>
</Worksheet>
        </Workbook>

总结

通过这次实验可以得知，文件的打开失败的根本原因就是数据行超过了设置的ExpandedRowCount属性值。而我们要做的就是修改该值到能容纳我们要导出的数据即可。甚至是可以改为变量读取数据长度是否可行 。

如果感觉有用的话欢迎点赞、收藏、转发，关注公众号《醉鱼Java》获取一手面试资料，一起学编程


文章标签：
数据格式
XML
Java
Windows
关键词：
excel文件
excel导出
导出excel
excel损坏
excel模版
醉鱼Java
目录
相关文章
蚝油菜花
|
6天前
|
人工智能 自然语言处理 Java
FastExcel：开源的 JAVA 解析 Excel 工具，集成 AI 通过自然语言处理 Excel 文件，完全兼容 EasyExcel
FastExcel 是一款基于 Java 的高性能 Excel 处理工具，专注于优化大规模数据处理，提供简洁易用的 API 和流式操作能力，支持从 EasyExcel 无缝迁移。
蚝油菜花
54 9
FastExcel：开源的 JAVA 解析 Excel 工具，集成 AI 通过自然语言处理 Excel 文件，完全兼容 EasyExcel
bruce_xiaowei
|
1月前
|
Python
按条件将Excel文件拆分到不同的工作表
使用Python的pandas库，可以轻松将Excel文件按条件拆分到不同的工作表中。本文通过一个示例代码展示了如何生成一个包含总成绩表和三个班级表的Excel文件。代码首先创建了一个包含学生姓名、班级和各科成绩的数据框，然后按班级分组，将每个班级的数据分别写入不同的工作表。最后，生成的Excel文件将包含四个工作表，分别为总成绩表和三个班级的成绩表。
bruce_xiaowei
32 6
按条件将Excel文件拆分到不同的工作表
bruce_xiaowei
|
1月前
|
Python
批量将不同的工作簿合并到同一个Excel文件
本文介绍如何使用Python的`pandas`库批量合并不同工作簿至同一Excel文件。通过模拟生成三个班级的成绩数据，分别保存为Excel文件，再将这些文件合并成一个包含所有班级成绩的总成绩单。步骤包括安装必要库、生成数据、保存与合并工作簿。
bruce_xiaowei
40 6
bruce_xiaowei
|
1月前
|
Python
按条件将Excel文件拆分到不同的工作表
使用Python的pandas库，可以轻松将Excel文件按条件拆分为多个工作表。本文通过一个具体示例，展示了如何根据学生班级将成绩数据拆分到不同的工作表中，并生成一个包含总成绩表和各班级成绩表的Excel文件。代码简洁明了，适合初学者学习和应用。
bruce_xiaowei
41 6
小宋1021
|
2月前
|
前端开发
实现Excel文件和其他文件导出为压缩包，并导入
实现Excel文件和其他文件导出为压缩包，并导入
小宋1021
37 1
小王老师呀
|
2月前
|
数据格式 UED
记录一次NPOI库导出Excel遇到的小问题解决方案
【11月更文挑战第16天】本文记录了使用 NPOI 库导出 Excel 过程中遇到的三个主要问题及其解决方案：单元格数据格式错误、日期格式不正确以及合并单元格边框缺失。通过自定义单元格样式、设置数据格式和手动添加边框，有效解决了这些问题，提升了导出文件的质量和用户体验。
小王老师呀
218 3
最好zzz
|
2月前
|
Java API Apache
Java中Excel导出的高效解决方案：探索JXLS库
【10月更文挑战第29天】
最好zzz
275 2
无糖可乐嘟嘟
|
1月前
|
数据采集 数据可视化 数据挖掘
利用Python自动化处理Excel数据：从基础到进阶####
本文旨在为读者提供一个全面的指南，通过Python编程语言实现Excel数据的自动化处理。无论你是初学者还是有经验的开发者，本文都将帮助你掌握Pandas和openpyxl这两个强大的库，从而提升数据处理的效率和准确性。我们将从环境设置开始，逐步深入到数据读取、清洗、分析和可视化等各个环节，最终实现一个实际的自动化项目案例。 ####
无糖可乐嘟嘟
106 10
奔跑的数据
|
3月前
|
数据采集 存储 JavaScript
自动化数据处理：使用Selenium与Excel打造的数据爬取管道
本文介绍了一种使用Selenium和Excel结合代理IP技术从WIPO品牌数据库（branddb.wipo.int）自动化爬取专利信息的方法。通过Selenium模拟用户操作，处理JavaScript动态加载页面，利用代理IP避免IP封禁，确保数据爬取稳定性和隐私性。爬取的数据将存储在Excel中，便于后续分析。此外，文章还详细介绍了Selenium的基本设置、代理IP配置及使用技巧，并探讨了未来可能采用的更多防反爬策略，以提升爬虫效率和稳定性。
奔跑的数据
177 4
技术自由圈/原疯狂创客圈
|
10天前
|
存储 Java easyexcel
招行面试：100万级别数据的Excel，如何秒级导入到数据库？
本文由40岁老架构师尼恩撰写，分享了应对招商银行Java后端面试绝命12题的经验。文章详细介绍了如何通过系统化准备，在面试中展示强大的技术实力。针对百万级数据的Excel导入难题，尼恩推荐使用阿里巴巴开源的EasyExcel框架，并结合高性能分片读取、Disruptor队列缓冲和高并发批量写入的架构方案，实现高效的数据处理。此外，文章还提供了完整的代码示例和配置说明，帮助读者快速掌握相关技能。建议读者参考《尼恩Java面试宝典PDF》进行系统化刷题，提升面试竞争力。关注公众号【技术自由圈】可获取更多技术资源和指导。
技术自由圈/原疯狂创客圈
40 3