异常教程
XSL-FO 与 XSLT（保姆级教程）
💡一则或许对你有用的小广告
欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论
- 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于
Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;- 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;
截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观
在现代软件开发中，XML（可扩展标记语言）因其结构清晰、跨平台兼容的特点，被广泛应用于数据存储与传输。然而，原始的XML文件往往需要进一步处理，才能转化为人类可读的文档或符合特定格式的需求。此时，XSL-FO 与 XSLT 这两个基于XML的转换技术便成为不可或缺的工具。
本文将从基础概念出发，结合实际案例，深入浅出地解析XSLT与XSL-FO的核心功能、技术差异及应用场景。无论你是刚接触XML的开发者，还是希望系统性掌握文档转换技术的中级工程师，都能从中获得实用的知识与灵感。
XSLT：XML的“翻译官”——转换数据的利器
基本概念与工作原理
XSLT（可扩展样式表语言转换）是一种用于将XML文档转换为其他格式的语言。它通过定义一系列规则（称为“模板”），将输入的XML数据映射到目标格式（如HTML、文本或另一个XML结构）。
形象比喻：
可以把XSLT想象成一位“翻译官”。原始XML是待翻译的“源语言文本”，而XSLT规则就像翻译词典和语法规则，最终生成的目标文档则是“目标语言的表达”。
核心语法与基础示例
1. 基础结构
一个XSLT样式表以<xsl:stylesheet>为根元素，并包含多个<xsl:template>标签定义转换规则。例如：
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:template match="/">
<html>
<body>
<h2>Books List</h2>
<table>
<tr>
<th>Title</th>
<th>Author</th>
</tr>
<xsl:apply-templates select="books/book"/>
</table>
</body>
</html>
</xsl:template>
<xsl:template match="book">
<tr>
<td><xsl:value-of select="title"/></td>
<td><xsl:value-of select="author"/></td>
</tr>
</xsl:template>
</xsl:stylesheet>
2. 关键指令解析
match属性：指定当前模板匹配的XML节点路径。例如match="book"表示对所有<book>标签应用该模板。apply-templates：递归调用子节点的模板规则，类似“分而治之”的策略。value-of：提取节点的文本值并插入到目标文档中。
实际应用：将XML转换为HTML
假设我们有以下XML数据：
<books>
<book>
<title>Introduction to Programming</title>
<author>John Doe</author>
</book>
<book>
<title>Advanced Algorithms</title>
<author>Jane Smith</author>
</book>
</books>
通过上述XSLT样式表，最终会生成一个包含书籍列表的HTML表格，如下所示：
<html>
<body>
<h2>Books List</h2>
<table>
<tr>
<th>Title</th>
<th>Author</th>
</tr>
<tr>
<td>Introduction to Programming</td>
<td>John Doe</td>
</tr>
<tr>
<td>Advanced Algorithms</td>
<td>Jane Smith</td>
</tr>
</table>
</body>
</html>
XSL-FO：XML的“设计师”——排版文档的专家
核心概念与工作流程
XSL-FO（可扩展样式表语言格式化对象）专注于将XML数据转换为格式化的文档，如PDF、PostScript或打印格式。它通过定义布局规则（如页边距、字体、表格、分页等），将数据转化为视觉上规范的文档。
形象比喻：
XSL-FO就像一位“平面设计师”。它接收原始XML数据作为“素材”，并使用预设的排版规则（如颜色、间距、边框）将这些素材组合成最终的“作品”，例如专业报告或书籍。
核心语法与基础示例
1. 基础结构
XSL-FO文档以<fo:root>为根元素，并通过嵌套的<fo:layout-master-set>和<fo:page-sequence>定义页面布局。以下是一个简化示例：
<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">
<fo:layout-master-set>
<fo:simple-page-master master-name="A4-portrait"
page-width="21cm" page-height="29.7cm">
<fo:region-body margin="2cm"/>
</fo:simple-page-master>
</fo:layout-master-set>
<fo:page-sequence master-reference="A4-portrait">
<fo:flow flow-name="xsl-region-body">
<fo:block font-size="18pt" font-weight="bold">
Company Annual Report
</fo:block>
<fo:block space-after="12pt">
Total Revenue: $5,000,000
</fo:block>
</fo:flow>
</fo:page-sequence>
</fo:root>
2. 关键元素解析
fo:root：所有格式化对象的容器。fo:layout-master-set：定义页面的布局模板（如页边距、页眉页脚）。fo:page-sequence：控制文档的分页规则，引用布局模板生成具体页面。fo:block：定义文本块，支持字体、颜色、间距等属性。
实际应用：生成PDF报告
假设需要将以下XML数据转换为带有公司Logo和分页的PDF：
<report>
<header>Company Annual Report 2023</header>
<sections>
<section>
<title>Revenue</title>
<data>$5,000,000</data>
</section>
<section>
<title>Expenses</title>
<data>$3,200,000</data>
</section>
</sections>
</report>
通过XSL-FO样式表，可以定义页面边距、标题样式、分节布局等规则，最终生成如下结构的PDF：
Company Annual Report 2023
[Logo Image]
Revenue: $5,000,000
Expenses: $3,200,000
XSLT与XSL-FO的核心区别与协作关系
技术差异对比
| 特性 | XSLT | XSL-FO |
|---|---|---|
| 核心功能 | 数据转换（XML到HTML、文本等） | 文档排版（XML到PDF、打印格式等） |
| 语法重点 | 模板匹配、XPath表达式 | 布局对象、格式属性（如字体、边距） |
| 输出类型 | 结构化文档（如HTML） | 可视化文档（如PDF） |
| 典型场景 | API响应数据格式化、数据迁移 | 生成报表、合同、书籍等专业文档 |
协作流程：从数据到文档的完整链路
在实际项目中，XSLT与XSL-FO常联合使用：
- XSLT先处理数据：将原始XML数据转换为符合排版要求的中间格式（如标准化字段名、过滤数据）。
- XSL-FO定义布局：基于处理后的数据，应用排版规则生成最终文档。
案例示例：
假设需要从数据库导出的XML数据生成带分页的PDF报告，流程如下：
原始XML → XSLT（标准化数据） → 中间XML → XSL-FO（排版） → PDF
实战案例：用XSLT与XSL-FO生成带图表的PDF
场景描述
假设我们有以下XML数据，包含销售数据与图表信息：
<sales>
<quarter>
<name>Q1</name>
<revenue>1,200,000</revenue>
<chart src="q1_chart.png"/>
</quarter>
<quarter>
<name>Q2</name>
<revenue>1,500,000</revenue>
<chart src="q2_chart.png"/>
</quarter>
</sales>
步骤1：使用XSLT提取并格式化数据
首先，通过XSLT将XML转换为适合排版的中间结构：
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:template match="/sales">
<report>
<xsl:apply-templates select="quarter"/>
</report>
</xsl:template>
<xsl:template match="quarter">
<section>
<title><xsl:value-of select="name"/></title>
<revenue>$<xsl:value-of select="revenue"/></revenue>
<chart src="{chart/@src}"/>
</section>
</xsl:template>
</xsl:stylesheet>
步骤2：使用XSL-FO定义排版规则
接下来，通过XSL-FO样式表将中间XML转换为PDF：
<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">
<fo:layout-master-set>
<fo:simple-page-master master-name="A4"
page-width="21cm" page-height="29.7cm">
<fo:region-body margin="2cm"/>
</fo:simple-page-master>
</fo:layout-master-set>
<fo:page-sequence master-reference="A4">
<fo:flow flow-name="xsl-region-body">
<fo:block font-size="24pt" font-weight="bold" space-after="24pt">
Sales Report 2023
</fo:block>
<xsl:apply-templates select="report/section"/>
</fo:flow>
</fo:page-sequence>
</fo:root>
<xsl:template match="section">
<fo:block space-after="12pt">
<fo:block font-weight="bold">Quarter: <xsl:value-of select="title"/></fo:block>
<fo:block>Revenue: <xsl:value-of select="revenue"/></fo:block>
<fo:external-graphic src="{chart/@src}" content-height="3cm"/>
</fo:block>
</xsl:template>
最终效果
生成的PDF将包含：
- 标题“Sales Report 2023”
- 每个季度的收入数据
- 对应的图表图片（如Q1的柱状图、Q2的折线图）
结论
XSLT与XSL-FO 是XML生态系统中不可或缺的工具：
- XSLT 专注于数据转换，帮助开发者将原始XML灵活地适配到不同需求；
- XSL-FO 则聚焦于文档的视觉呈现，确保输出的PDF、打印文件等格式专业美观。
对于开发者而言，掌握这两项技术能显著提升处理XML数据的效率，尤其在生成报表、合同、书籍等场景中优势明显。建议从简单的数据转换案例入手，逐步深入学习排版技巧，最终实现从数据到文档的全流程自动化。
无论是需要将API响应格式化为用户友好的HTML页面，还是将业务数据转化为正式的PDF报告，XSL-FO 与 XSLT 都能成为你技术工具箱中的强力搭档。