【揭秘XSL-FO】轻松实现高效PDF导出的秘密技巧

在电子商务和财务系统中，生成规范化的发票 PDF 文件是一个常见需求。XSL-FO（Extensible Stylesheet Language Formatting Objects）提供了一种强大的方法来设计和生成格式规范的发票 PDF。本文将深入探讨如何使用 XSL-FO 构建电子发票的 PDF 文件，并提供一些优化布局的建议。

为什么选择 XSL-FO？

XSL-FO 是 W3C 的标准，用于将 XML 文档格式化为 PDF、PostScript 等格式的高质量输出文档。它特别适合结构化数据的排版需求。结合 Apache FOP（Formatting Objects Processor）等工具，我们可以从 XML 模板生成发票 PDF。

1. 初始设置

首先，在根节点 <fo:root> 中设置页面布局：

<fo:root>
  <fo:layout-master-set>
    <fo:simple-page-master master-name="invoice">
      <fo:region-body margin="5mm"/>
    </fo:simple-page-master>
  </fo:layout-master-set>
</fo:root>

这里指定了页面的边距和布局，便于后续的内容排版。

2. 标题区块

发票的顶部通常包含公司标志和发票标题。以下是一个示例：

<fo:block font-size="16pt" font-weight="bold" margin-bottom="10mm">
  <fo:external-graphic src="company-logo.png" width="100mm"/>
  <fo:table>
    <fo:table-body>
      <fo:table-row>
        <fo:table-cell>
          <fo:block font-size="14pt">发票</fo:block>
        </fo:table-cell>
      </fo:table-row>
    </fo:table-body>
  </fo:table>
</fo:block>

3. 买卖方信息

接下来，添加买卖方的信息：

<fo:block margin-bottom="10mm">
  <fo:block font-weight="bold">买方信息：</fo:block>
  <fo:block>公司名称：XXX有限公司</fo:block>
  <fo:block>地址：XXX街道XXX号</fo:block>
  <!-- 更多买方信息 -->
</fo:block>

<fo:block margin-bottom="10mm">
  <fo:block font-weight="bold">卖方信息：</fo:block>
  <fo:block>公司名称：YYY有限公司</fo:block>
  <fo:block>地址：YYY街道YYY号</fo:block>
  <!-- 更多卖方信息 -->
</fo:block>

4. 商品明细表格

商品明细是发票的核心部分。以下是一个简单的表格示例：

<fo:table width="100%">
  <fo:table-body>
    <fo:table-row>
      <fo:table-cell>商品名称</fo:table-cell>
      <fo:table-cell>数量</fo:table-cell>
      <fo:table-cell>单价</fo:table-cell>
      <fo:table-cell>总价</fo:table-cell>
    </fo:table-row>
    <!-- 更多商品行 -->
  </fo:table-body>
</fo:table>

5. 合计信息

在商品明细之后，添加合计信息：

<fo:block margin-top="10mm" margin-bottom="10mm">
  <fo:block font-weight="bold">合计：</fo:block>
  <fo:block>总金额：XXX元</fo:block>
</fo:block>

6. 优化代码结构与布局

确保你的 XSL-FO 代码具有良好的结构和可读性。使用缩进和注释来提高代码的可维护性。

7. 生成 PDF 文件

使用 Apache FOP 等工具将 XSL-FO 转换为 PDF。以下是一个简单的命令行示例：

java -jar fop-2.x.x.jar -fo input.fo -pdf output.pdf

8. 示例

以下是一个完整的 XSL-FO 示例：

<fo:root>
  <fo:layout-master-set>
    <fo:simple-page-master master-name="invoice">
      <fo:region-body margin="5mm"/>
    </fo:simple-page-master>
  </fo:layout-master-set>
  <fo:page-sequence master-reference="invoice">
    <fo:flow flow-name="xsl-region-body">
      <fo:block font-size="16pt" font-weight="bold" margin-bottom="10mm">
        <fo:external-graphic src="company-logo.png" width="100mm"/>
        <fo:table>
          <fo:table-body>
            <fo:table-row>
              <fo:table-cell>
                <fo:block font-size="14pt">发票</fo:block>
              </fo:table-cell>
            </fo:table-row>
          </fo:table-body>
        </fo:table>
      </fo:block>
      <fo:block margin-bottom="10mm">
        <fo:block font-weight="bold">买方信息：</fo:block>
        <fo:block>公司名称：XXX有限公司</fo:block>
        <fo:block>地址：XXX街道XXX号</fo:block>
        <!-- 更多买方信息 -->
      </fo:block>
      <fo:block margin-bottom="10mm">
        <fo:block font-weight="bold">卖方信息：</fo:block>
        <fo:block>公司名称：YYY有限公司</fo:block>
        <fo:block>地址：YYY街道YYY号</fo:block>
        <!-- 更多卖方信息 -->
      </fo:block>
      <fo:table width="100%">
        <fo:table-body>
          <fo:table-row>
            <fo:table-cell>商品名称</fo:table-cell>
            <fo:table-cell>数量</fo:table-cell>
            <fo:table-cell>单价</fo:table-cell>
            <fo:table-cell>总价</fo:table-cell>
          </fo:table-row>
          <!-- 更多商品行 -->
        </fo:table-body>
      </fo:table>
      <fo:block margin-top="10mm" margin-bottom="10mm">
        <fo:block font-weight="bold">合计：</fo:block>
        <fo:block>总金额：XXX元</fo:block>
      </fo:block>
    </fo:flow>
  </fo:page-sequence>
</fo:root>

通过以上步骤，你可以轻松使用 XSL-FO 生成专业级的 PDF 发票。