Grails 2.5.2：点击按钮将GSP页面数据库数据导出为PDF并保存至目录的最佳方案

嘿，针对Grails 2.5.2导出数据到指定目录PDF的需求，我给你梳理下两种最佳实现方案，你可以根据自己的场景选择：

这个方案适合你已经有现成的GSP表格，想快速生成和页面样式一致的PDF，不用重复编写布局代码，开发效率拉满。

1. 配置插件依赖 #

在grails-app/conf/BuildConfig.groovy的plugins块中添加适配Grails 2.5.x的插件版本：

plugins {
    // 保留你已有的其他插件...
    compile ":rendering:2.0.3"
}

2. 抽取表格为可复用模板 #

把现有GSP里的表格部分单独抽成模板文件，比如grails-app/views/data/tableTemplate.gsp，内容就是你原来的表格代码：

<table border="1" cellpadding="8" cellspacing="0">
    <thead>
        <tr>
            <th>ID</th>
            <th>名称</th>
            <th>数值</th>
        </tr>
    </thead>
    <tbody>
        <g:each in="${data}" var="item">
            <tr>
                <td>${item.id}</td>
                <td>${item.name}</td>
                <td>${item.value}</td>
            </tr>
        </g:each>
    </tbody>
</table>

3. 创建PDF导出服务 #

新建服务类grails-app/services/PdfExportService.groovy，封装导出逻辑，让代码更规整：

class PdfExportService {
    // 注入rendering插件提供的服务
    def renderingService

    /**
     * 将数据导出到指定路径的PDF文件
     * @param data 待导出的数据列表
     * @param outputPath PDF文件的完整保存路径（含文件名）
     */
    void exportToFile(List data, String outputPath) {
        // 用模板生成PDF字节数组
        byte[] pdfContent = renderingService.render(
            template: "/data/tableTemplate",
            model: [data: data],
            format: 'pdf'
        )

        // 将字节数组写入目标文件
        File pdfFile = new File(outputPath)
        // 确保父目录存在，避免IO异常
        pdfFile.parentFile.mkdirs()
        pdfFile.withOutputStream { stream ->
            stream.write(pdfContent)
        }
    }
}

4. 控制器添加导出接口 #

在你的数据控制器（比如DataController）中添加处理导出请求的方法：

class DataController {
    def pdfExportService
    def dataService // 假设你已有这个服务用来从数据库获取数据

    def exportPdfToServer() {
        // 1. 获取数据库中的全部数据
        List dataList = dataService.getAllData()
        
        // 2. 指定保存路径，用时间戳避免文件名重复
        String exportDir = "/opt/grails-data-exports" // 替换成你的目标目录
        String fileName = "data_export_${new Date().format('yyyyMMddHHmmss')}.pdf"
        String fullPath = "${exportDir}/${fileName}"

        try {
            // 3. 调用服务生成并保存PDF
            pdfExportService.exportToFile(dataList, fullPath)
            render "PDF已成功保存到服务器：${fullPath}"
        } catch (Exception e) {
            log.error("导出PDF失败", e)
            render "导出失败：${e.message}"
        }
    }
}

5. GSP页面添加触发按钮 #

在数据展示页面添加按钮，触发导出请求：

<div style="margin: 10px 0;">
    <button onclick="startExport()">导出PDF到服务器目录</button>
</div>

<script>
function startExport() {
    // 用GET请求触发导出，也可以换成AJAX实现无刷新提示
    window.location.href = "${createLink(controller: 'data', action: 'exportPdfToServer')}";
    
    // 无刷新版本示例：
    /*
    fetch("${createLink(controller: 'data', action: 'exportPdfToServer')}")
        .then(res => res.text())
        .then(msg => alert(msg))
        .catch(err => alert('请求出错：' + err));
    */
}
</script>

如果你需要精细控制PDF样式（比如自定义字体、页眉页脚、复杂报表布局），直接使用iText库会更灵活。

1. 添加iText依赖 #

在BuildConfig.groovy的dependencies块中添加兼容Grails 2.x的稳定版本：

dependencies {
    // 保留你已有的其他依赖...
    compile 'com.lowagie:itext:2.1.7'
}

2. 修改PDF服务的导出方法 #

在PdfExportService中新增一个用iText实现的导出方法：

void exportWithItext(List data, String outputPath) {
    Document document = new Document(PageSize.A4)
    PdfWriter.getInstance(document, new FileOutputStream(outputPath))
    
    document.open()
    // 添加标题和导出时间
    document.add(new Paragraph("数据导出报表", new Font(Font.HELVETICA, 16, Font.BOLD)))
    document.add(new Paragraph("导出时间：${new Date().format('yyyy-MM-dd HH:mm:ss')}", new Font(Font.HELVETICA, 10)))
    document.add(new Paragraph(" ")) // 空行分隔
    
    // 创建表格，假设数据有3列
    PdfPTable table = new PdfPTable(3)
    table.setWidthPercentage(90) // 表格宽度占页面90%
    Font headerFont = new Font(Font.HELVETICA, 12, Font.BOLD)
    
    // 添加表头
    table.addCell(new PdfPCell(new Phrase("ID", headerFont)))
    table.addCell(new PdfPCell(new Phrase("名称", headerFont)))
    table.addCell(new PdfPCell(new Phrase("数值", headerFont)))
    
    // 填充数据行
    data.each { item ->
        table.addCell(item.id.toString())
        table.addCell(item.name)
        table.addCell(item.value.toString())
    }
    
    document.add(table)
    document.close()
}

之后在控制器中调用这个方法即可，逻辑和方案一一致。

• 目录权限：务必确保Grails应用进程有目标目录的写入权限，否则会抛出IOException，可以通过chmod命令或调整目录所属用户解决。
• 大数据量处理：如果数据量很大，建议用Grails异步任务插件实现后台导出，避免请求超时。
• 文件名唯一性：用时间戳或UUID命名文件，防止覆盖已有文件。

内容的提问来源于stack exchange，提问作者J.Srivastava