Word 郵件合并：
  模板（.docx）+ 數(shù)據(jù)（Excel聯(lián)系人） → 批量生成信件

JasperReports：
  模板（.jrxml/.jasper）+ 數(shù)據(jù)（數(shù)據(jù)庫/Java對象） → 批量生成 PDF/Excel/HTML

┌─────────────────────────────────────────┐
│          Title Band（標題區(qū)）             │  ← 整個報表只出現(xiàn)一次
├─────────────────────────────────────────┤
│        Page Header（頁眉）               │  ← 每頁頂部
├─────────────────────────────────────────┤
│       Column Header（列標題）            │  ← 表格列名
├─────────────────────────────────────────┤
│         Detail Band（明細區(qū)）            │  ← 每條數(shù)據(jù)重復一次
│    ┌────┬──────┬────┬──────┬─────┐     │
│    │序號│ 商品名 │數(shù)量│  單價  │ 金額 │     │
│    ├────┼──────┼────┼──────┼─────┤     │
│    │ 1  │冰箱   │ 2  │3999  │7998 │     │
│    │ 2  │洗衣機 │ 1  │2999  │2999 │     │
│    │... │...   │... │...   │...  │     │
│    └────┴──────┴────┴──────┴─────┘     │
├─────────────────────────────────────────┤
│        Column Footer（列匯總）           │  ← 合計行
├─────────────────────────────────────────┤
│        Page Footer（頁腳）               │  ← 每頁底部（頁碼等）
├─────────────────────────────────────────┤
│         Summary（總匯總）                │  ← 整個報表最后
└─────────────────────────────────────────┘

設計階段（開發(fā)時）：
  Jaspersoft Studio 設計模板 → 保存為 .jrxml 文件
       │
       ▼
  編譯模板：JasperCompileManager.compileReport() → .jasper 文件
       │
       ▼（部署到項目 resources 目錄）

運行階段（運行時）：
  加載 .jasper 模板
       │
       ▼
  填充數(shù)據(jù)：JasperFillManager.fillReport(模板, 參數(shù), 數(shù)據(jù)源) → JasperPrint
       │
       ▼
  導出文檔：JasperExportManager.exportReportToPdf(jasperPrint) → PDF/Excel/HTML
       │
       ▼
  返回給前端下載/預覽/打印

Controller 接收請求（如：打印發(fā)貨單）
  │
  ├─→ Service 查詢數(shù)據(jù)庫獲取發(fā)貨單數(shù)據(jù)
  │     └── List<DeliveryOrderDto> 數(shù)據(jù)集
  │
  ├─→ 組裝參數(shù) Map（標題、公司名、打印日期等）
  │
  ├─→ 創(chuàng)建數(shù)據(jù)源 JRBeanCollectionDataSource(數(shù)據(jù)集)
  │
  ├─→ 加載模板 .jasper（從 classpath 或數(shù)據(jù)庫）
  │
  ├─→ JasperFillManager.fillReport(模板, 參數(shù), 數(shù)據(jù)源)
  │     └── → JasperPrint（內(nèi)存中的完整報表）
  │
  ├─→ 導出為目標格式
  │     ├── PDF：JasperExportManager.exportReportToPdfStream()
  │     ├── Excel：JRXlsxExporter
  │     ├── Word：JRDocxExporter
  │     └── HTML：HtmlExporter
  │
  └─→ 寫入 HttpServletResponse 輸出流
       └── 前端收到文件下載/預覽

<dependencies>
    <!-- JasperReports 核心 -->
    <dependency>
        <groupId>net.sf.jasperreports</groupId>
        <artifactId>jasperreports</artifactId>
        <version>6.20.0</version>
    </dependency>
    <!-- 中文字體支持 -->
    <dependency>
        <groupId>net.sf.jasperreports</groupId>
        <artifactId>jasperreports-fonts</artifactId>
        <version>6.20.0</version>
    </dependency>
    <!-- Excel 導出 -->
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi-ooxml</artifactId>
        <version>5.2.3</version>
    </dependency>
</dependencies>

<?xml version="1.0" encoding="UTF-8"?>
<jasperReport xmlns="http://jasperreports.sourceforge.net/jasperreports"
              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
              xsi:schemaLocation="http://jasperreports.sourceforge.net/jasperreports
              http://jasperreports.sourceforge.net/xsd/jasperreport.xsd"
              name="delivery_order" pageWidth="595" pageHeight="842"
              columnWidth="555" leftMargin="20" rightMargin="20"
              topMargin="20" bottomMargin="20">
    <!-- 參數(shù)定義 -->
    <parameter name="companyName" class="java.lang.String"/>
    <parameter name="deliveryCode" class="java.lang.String"/>
    <parameter name="printDate" class="java.lang.String"/>
    <parameter name="customerName" class="java.lang.String"/>
    <parameter name="address" class="java.lang.String"/>
    <!-- 字段定義（對應 Java Bean 屬性） -->
    <field name="productCode" class="java.lang.String"/>
    <field name="productName" class="java.lang.String"/>
    <field name="quantity" class="java.lang.Integer"/>
    <field name="price" class="java.math.BigDecimal"/>
    <!-- 變量定義（自動計算） -->
    <variable name="totalAmount" class="java.math.BigDecimal" calculation="Sum">
        <variableExpression>
            <![CDATA[$F{price}.multiply(new java.math.BigDecimal($F{quantity}))]]>
        </variableExpression>
    </variable>
    <!-- 標題區(qū) -->
    <title>
        <band height="80">
            <staticText>
                <reportElement x="0" y="0" width="555" height="30"/>
                <textElement textAlignment="Center">
                    <font size="18" isBold="true" fontName="華文宋體"/>
                </textElement>
                <text><![CDATA[發(fā) 貨 單]]></text>
            </staticText>
            <textField>
                <reportElement x="0" y="40" width="200" height="20"/>
                <textFieldExpression><![CDATA["單號：" + $P{deliveryCode}]]></textFieldExpression>
            </textField>
            <textField>
                <reportElement x="355" y="40" width="200" height="20"/>
                <textFieldExpression><![CDATA["日期：" + $P{printDate}]]></textFieldExpression>
            </textField>
        </band>
    </title>
    <!-- 列標題 -->
    <columnHeader>
        <band height="25">
            <staticText>
                <reportElement x="0" y="0" width="100" height="25" mode="Opaque" backcolor="#CCCCCC"/>
                <text><![CDATA[商品編碼]]></text>
            </staticText>
            <staticText>
                <reportElement x="100" y="0" width="200" height="25" mode="Opaque" backcolor="#CCCCCC"/>
                <text><![CDATA[商品名稱]]></text>
            </staticText>
            <staticText>
                <reportElement x="300" y="0" width="80" height="25" mode="Opaque" backcolor="#CCCCCC"/>
                <text><![CDATA[數(shù)量]]></text>
            </staticText>
            <staticText>
                <reportElement x="380" y="0" width="80" height="25" mode="Opaque" backcolor="#CCCCCC"/>
                <text><![CDATA[單價]]></text>
            </staticText>
        </band>
    </columnHeader>
    <!-- 明細區(qū)（每條數(shù)據(jù)重復） -->
    <detail>
        <band height="20">
            <textField>
                <reportElement x="0" y="0" width="100" height="20"/>
                <textFieldExpression><![CDATA[$F{productCode}]]></textFieldExpression>
            </textField>
            <textField>
                <reportElement x="100" y="0" width="200" height="20"/>
                <textFieldExpression><![CDATA[$F{productName}]]></textFieldExpression>
            </textField>
            <textField>
                <reportElement x="300" y="0" width="80" height="20"/>
                <textFieldExpression><![CDATA[$F{quantity}]]></textFieldExpression>
            </textField>
            <textField>
                <reportElement x="380" y="0" width="80" height="20"/>
                <textFieldExpression><![CDATA[$F{price}]]></textFieldExpression>
            </textField>
        </band>
    </detail>
    <!-- 匯總區(qū) -->
    <summary>
        <band height="30">
            <textField>
                <reportElement x="300" y="5" width="180" height="20"/>
                <textElement textAlignment="Right">
                    <font isBold="true"/>
                </textElement>
                <textFieldExpression><![CDATA["合計金額：" + $V{totalAmount}]]></textFieldExpression>
            </textField>
        </band>
    </summary>
</jasperReport>

package com.example.utils;

import java.io.ByteArrayOutputStream;
import java.io.InputStream;
import java.util.List;
import java.util.Map;
import javax.servlet.http.HttpServletResponse;
import net.sf.jasperreports.engine.*;
import net.sf.jasperreports.engine.data.JRBeanCollectionDataSource;
import net.sf.jasperreports.engine.export.ooxml.JRDocxExporter;
import net.sf.jasperreports.engine.export.ooxml.JRXlsxExporter;
import net.sf.jasperreports.export.*;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

/**
 * JasperReports 報表工具類.
 * 封裝編譯、填充、導出的完整流程.
 */
public class JasperUtil {

    private static final Logger log = LoggerFactory.getLogger(JasperUtil.class);

    /**
     * 導出類型枚舉.
     */
    public enum DocType {
        PDF, EXCEL, WORD, HTML
    }

    /**
     * 生成報表并寫入 HTTP 響應（文件下載）.
     *
     * @param templatePath 模板路徑（classpath 下的 .jasper 文件）
     * @param params       報表參數(shù)
     * @param dataList     數(shù)據(jù)集合（對應模板中的 Field）
     * @param fileName     下載文件名
     * @param docType      導出格式
     * @param response     HTTP 響應
     */
    public static <T> void exportToResponse(
            String templatePath,
            Map<String, Object> params,
            List<T> dataList,
            String fileName,
            DocType docType,
            HttpServletResponse response) {

        try {
            byte[] bytes = generateReport(templatePath, params, dataList, docType);

            // 設置響應頭
            String contentType;
            String extension;
            switch (docType) {
                case PDF:
                    contentType = "application/pdf";
                    extension = ".pdf";
                    break;
                case EXCEL:
                    contentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
                    extension = ".xlsx";
                    break;
                case WORD:
                    contentType = "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
                    extension = ".docx";
                    break;
                default:
                    contentType = "text/html";
                    extension = ".html";
            }

            response.setContentType(contentType);
            response.setHeader("Content-Disposition",
                "attachment; filename=" + java.net.URLEncoder.encode(fileName + extension, "UTF-8"));
            response.setContentLength(bytes.length);
            response.getOutputStream().write(bytes);
            response.getOutputStream().flush();

        } catch (Exception e) {
            log.error("報表導出失敗", e);
            throw new RuntimeException("報表導出失敗", e);
        }
    }

    /**
     * 生成報表字節(jié)數(shù)組.
     */
    public static <T> byte[] generateReport(
            String templatePath,
            Map<String, Object> params,
            List<T> dataList,
            DocType docType) throws Exception {

        // 1. 加載編譯好的模板
        InputStream templateStream = JasperUtil.class.getClassLoader()
            .getResourceAsStream(templatePath);
        JasperReport jasperReport = (JasperReport) JRLoader.loadObject(templateStream);

        // 2. 創(chuàng)建數(shù)據(jù)源
        JRDataSource dataSource;
        if (dataList != null && !dataList.isEmpty()) {
            dataSource = new JRBeanCollectionDataSource(dataList);
        } else {
            dataSource = new JREmptyDataSource();
        }

        // 3. 填充數(shù)據(jù) → 生成 JasperPrint
        JasperPrint jasperPrint = JasperFillManager.fillReport(jasperReport, params, dataSource);

        // 4. 導出為目標格式
        ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
        switch (docType) {
            case PDF:
                JasperExportManager.exportReportToPdfStream(jasperPrint, outputStream);
                break;
            case EXCEL:
                exportToExcel(jasperPrint, outputStream);
                break;
            case WORD:
                exportToWord(jasperPrint, outputStream);
                break;
            default:
                JasperExportManager.exportReportToHtmlFile(jasperPrint, outputStream.toString());
        }
        return outputStream.toByteArray();
    }

    private static void exportToExcel(JasperPrint jasperPrint, ByteArrayOutputStream out) throws Exception {
        JRXlsxExporter exporter = new JRXlsxExporter();
        exporter.setExporterInput(new SimpleExporterInput(jasperPrint));
        exporter.setExporterOutput(new SimpleOutputStreamExporterOutput(out));
        SimpleXlsxReportConfiguration config = new SimpleXlsxReportConfiguration();
        config.setOnePagePerSheet(false);
        config.setDetectCellType(true);
        exporter.setConfiguration(config);
        exporter.exportReport();
    }

    private static void exportToWord(JasperPrint jasperPrint, ByteArrayOutputStream out) throws Exception {
        JRDocxExporter exporter = new JRDocxExporter();
        exporter.setExporterInput(new SimpleExporterInput(jasperPrint));
        exporter.setExporterOutput(new SimpleOutputStreamExporterOutput(out));
        exporter.exportReport();
    }
}

@RestController
public class DeliveryPrintController {

    @Resource
    private DeliveryService deliveryService;

    /**
     * 打印發(fā)貨單（導出PDF）.
     */
    @GetMapping("/api/delivery/print")
    public void printDeliveryOrder(
            @RequestParam Integer deliveryId,
            HttpServletResponse response) {

        // 1. 查詢發(fā)貨單數(shù)據(jù)
        DeliveryOrderDto order = deliveryService.getDeliveryOrder(deliveryId);
        List<DeliveryItemDto> items = deliveryService.getDeliveryItems(deliveryId);

        // 2. 組裝報表參數(shù)
        Map<String, Object> params = new HashMap<>();
        params.put("companyName", "xxx科技");
        params.put("deliveryCode", order.getDeliveryCode());
        params.put("printDate", DateUtil.formatStandardDate(new Date()));
        params.put("customerName", order.getCustomerName());
        params.put("address", order.getShipToAddress());

        // 3. 導出 PDF
        JasperUtil.exportToResponse(
            "print/delivery_order.jasper",  // classpath 下的模板
            params,
            items,                           // 明細數(shù)據(jù)
            "發(fā)貨單_" + order.getDeliveryCode(),
            JasperUtil.DocType.PDF,
            response);
    }

    /**
     * 批量打?。ǘ鄠€發(fā)貨單合并為一個PDF）.
     */
    @PostMapping("/api/delivery/batch-print")
    public void batchPrint(
            @RequestBody List<Integer> deliveryIds,
            HttpServletResponse response) {

        List<JasperPrint> prints = new ArrayList<>();
        for (Integer id : deliveryIds) {
            DeliveryOrderDto order = deliveryService.getDeliveryOrder(id);
            List<DeliveryItemDto> items = deliveryService.getDeliveryItems(id);

            Map<String, Object> params = new HashMap<>();
            params.put("deliveryCode", order.getDeliveryCode());
            // ... 其他參數(shù)

            // 生成每個發(fā)貨單的 JasperPrint
            InputStream template = getClass().getClassLoader()
                .getResourceAsStream("print/delivery_order.jasper");
            JasperReport report = (JasperReport) JRLoader.loadObject(template);
            JasperPrint print = JasperFillManager.fillReport(report, params,
                new JRBeanCollectionDataSource(items));
            prints.add(print);
        }

        // 合并導出為一個 PDF
        response.setContentType("application/pdf");
        response.setHeader("Content-Disposition", "attachment; filename=batch_delivery.pdf");
        JRPdfExporter exporter = new JRPdfExporter();
        exporter.setExporterInput(SimpleExporterInput.getInstance(prints));
        exporter.setExporterOutput(new SimpleOutputStreamExporterOutput(response.getOutputStream()));
        exporter.exportReport();
    }
}

/**
 * 發(fā)貨單明細DTO（字段名需與JRXML中的Field名稱一致）.
 */
@Data
public class DeliveryItemDto {
    private String productCode;    // 對應 $F{productCode}
    private String productName;    // 對應 $F{productName}
    private Integer quantity;      // 對應 $F{quantity}
    private BigDecimal price;      // 對應 $F{price}
}

1. 下載安裝 Jaspersoft Studio（免費，基于 Eclipse）
2. 新建 Jasper Report → 選擇模板尺寸（A4/自定義）
3. 拖拽組件到 Band 中：
   - Static Text：固定文本
   - Text Field：動態(tài)字段 $F{xxx}
   - Image：圖片/Logo
   - Barcode：條碼
   - Line/Rectangle：線條/邊框
4. 定義 Parameters（外部傳入的參數(shù)）
5. 定義 Fields（對應數(shù)據(jù)源的字段）
6. 預覽效果 → 保存為 .jrxml
7. 編譯為 .jasper → 放到項目 resources/print/ 目錄

src/main/resources/
├── print/
│   ├── delivery_order.jrxml      ← 模板源文件（用于修改）
│   ├── delivery_order.jasper     ← 編譯后模板（運行時加載）
│   ├── outbound_order.jasper     ← 出庫單模板
│   └── stock_report.jasper       ← 庫存報表模板
├── font/
│   └── simsun.ttf                ← 中文字體文件
└── jasperreports.properties       ← JasperReports 配置