JSP PDF生成实例教程从基础到进阶全面解析JSP页面动态生成PDF文件的技术实现方法与常见问题解决方案

威震华夏关云长 · 发表于 2025-9-26 17:30:00

马上注册，结交更多好友，享用更多功能，让你轻松玩转社区。

您需要登录才可以下载或查看，没有账号？立即注册

x

1. 引言

在当今的信息时代，PDF（Portable Document Format）作为一种跨平台的文件格式，被广泛应用于文档交换、报告生成、电子书出版等领域。在Java Web开发中，特别是在JSP（JavaServer Pages）环境中，动态生成PDF文件是一项常见且重要的需求。无论是生成报表、电子发票、合同文档还是其他类型的业务文档，JSP生成PDF技术都发挥着关键作用。

本教程将从基础到进阶，全面解析在JSP页面中动态生成PDF文件的技术实现方法，并提供详细的实例代码和常见问题的解决方案，帮助开发者快速掌握这一技能。

2. 基础知识

2.1 PDF生成的基本原理

在JSP中生成PDF文件，本质上是通过Java程序将数据按照特定的格式和布局输出为PDF格式。这个过程通常涉及以下几个步骤：

1. 数据准备：从数据库或其他数据源获取需要展示的数据
2. 模板设计：设计PDF的布局和样式
3. 内容生成：将数据填充到模板中
4. PDF转换：将内容转换为PDF格式
5. 输出响应：将生成的PDF文件发送给客户端

2.2 JSP环境配置

在开始之前，我们需要确保JSP环境已经正确配置。以下是基本的环境要求：

1. JDK 1.6或更高版本
2. Tomcat或其他Java EE容器
3. 相关的PDF生成库（将在下一节详细介绍）

为了演示，我们假设你已经有一个可以正常运行的JSP项目。如果还没有，可以按照以下步骤创建一个简单的JSP项目：

1. 在Eclipse或IntelliJ IDEA中创建一个新的Dynamic Web Project
2. 配置Tomcat服务器
3. 创建一个简单的JSP页面，例如index.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>JSP PDF Generation</title>
</head>
<body>
<h1>Welcome to JSP PDF Generation Tutorial</h1>
</body>
</html>

复制代码

3. 常用JSP PDF生成库介绍

在Java生态系统中，有多个优秀的库可以用于PDF生成。下面介绍几个常用的库及其特点：

3.1 iText

iText是最流行的Java PDF库之一，提供了丰富的功能来创建和操作PDF文件。它支持文本、表格、图片、水印等多种元素，并且可以处理复杂的布局需求。

特点：

• 功能全面，支持几乎所有的PDF操作
• 社区活跃，文档丰富
• 有免费版本和商业版本
• 对中文支持良好（需要额外配置）

Maven依赖：

<dependency>
<groupId>com.itextpdf</groupId>
<artifactId>itextpdf</artifactId>
<version>5.5.13.3</version>
</dependency>
<dependency>
<groupId>com.itextpdf</groupId>
<artifactId>itext-asian</artifactId>
<version>5.2.0</version>
</dependency>

复制代码

3.2 Apache FOP

Apache FOP（Formatting Objects Processor）是一个XSL-FO处理器，可以将XSL-FO转换为PDF。它适合于需要将XML数据转换为PDF的场景。

特点：

• 基于XSL-FO标准，适合复杂的文档布局
• 与XML技术栈集成良好
• 支持多种输出格式（PDF、PS、PCL等）
• 学习曲线较陡峭

Maven依赖：

<dependency>
<groupId>org.apache.xmlgraphics</groupId>
<artifactId>fop</artifactId>
<version>2.6</version>
</dependency>

复制代码

3.3 Flying Saucer

Flying Saucer是一个基于iText的HTML/CSS渲染器，可以将HTML和CSS直接渲染为PDF。这对于熟悉Web开发的开发者来说非常友好。

特点：

• 使用HTML和CSS定义PDF样式，学习成本低
• 支持大部分CSS2.1和一些CSS3特性
• 适合将现有网页转换为PDF
• 对复杂的CSS布局支持有限

Maven依赖：

<dependency>
<groupId>org.xhtmlrenderer</groupId>
<artifactId>flying-saucer-pdf</artifactId>
<version>9.1.22</version>
</dependency>

复制代码

3.4 JasperReports

JasperReports是一个强大的报表引擎，可以生成各种格式的报表，包括PDF。它提供了可视化的报表设计工具，适合复杂的报表需求。

特点：

• 提供可视化的报表设计工具
• 支持多种数据源
• 适合复杂的报表需求
• 学习曲线较陡峭

Maven依赖：

<dependency>
<groupId>net.sf.jasperreports</groupId>
<artifactId>jasperreports</artifactId>
<version>6.20.0</version>
</dependency>

复制代码

在本教程中，我们将主要使用iText和Flying Saucer这两个库来演示PDF生成的实例，因为它们相对简单易用，且能满足大部分需求。

4. 基础实例：简单的PDF生成

让我们从最简单的例子开始，使用iText库在JSP中生成一个包含简单文本的PDF文件。

4.1 使用iText生成简单PDF

首先，创建一个JSP页面，命名为simplePDF.jsp：

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ page import="com.itextpdf.text.Document" %>
<%@ page import="com.itextpdf.text.DocumentException" %>
<%@ page import="com.itextpdf.text.Paragraph" %>
<%@ page import="com.itextpdf.text.pdf.PdfWriter" %>
<%@ page import="java.io.ByteArrayOutputStream" %>
<%@ page import="java.io.IOException" %>
<%
// 设置响应内容类型为PDF
response.setContentType("application/pdf");
// 创建文档对象
Document document = new Document();
try {
// 创建字节输出流
ByteArrayOutputStream baos = new ByteArrayOutputStream();
// 获取PDF写入器
PdfWriter.getInstance(document, baos);
// 打开文档
document.open();
// 添加内容
document.add(new Paragraph("Hello, World!"));
document.add(new Paragraph("这是一个简单的PDF生成示例。"));
// 关闭文档
document.close();
// 设置响应头
response.setHeader("Content-Disposition", "inline; filename=simple.pdf");
response.setContentLength(baos.size());
// 将PDF写入响应输出流
baos.writeTo(response.getOutputStream());
// 刷新输出流
response.getOutputStream().flush();
} catch (DocumentException | IOException e) {
e.printStackTrace();
throw new ServletException("生成PDF时出错", e);
}
%>

复制代码

这个例子中，我们做了以下几件事：

1. 导入了必要的iText类
2. 设置响应内容类型为application/pdf，告诉浏览器这是一个PDF文件
3. 创建了一个Document对象，这是iText中表示PDF文档的主要类
4. 创建了一个ByteArrayOutputStream来存储生成的PDF内容
5. 使用PdfWriter将文档内容写入输出流
6. 打开文档并添加了一些简单的段落
7. 设置响应头，指定文件名和内容长度
8. 将PDF内容写入响应输出流，发送给客户端

当你访问这个JSP页面时，浏览器会显示一个包含”Hello, World!“和中文文本的PDF文件。

4.2 使用Flying Saucer生成简单PDF

现在，让我们使用Flying Saucer库来实现同样的功能。创建一个新的JSP页面，命名为simplePDFWithFlyingSaucer.jsp：

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ page import="org.xhtmlrenderer.pdf.ITextRenderer" %>
<%@ page import="java.io.ByteArrayOutputStream" %>
<%@ page import="java.io.IOException" %>
<%
// 设置响应内容类型为PDF
response.setContentType("application/pdf");
try {
// HTML内容
String html = "<html><head><style>body { font-family: Arial; }</style></head><body>" +
"<h1>Hello, World!</h1>" +
"<p>这是一个使用Flying Saucer生成的PDF示例。</p>" +
"</body></html>";
// 创建字节输出流
ByteArrayOutputStream baos = new ByteArrayOutputStream();
// 创建ITextRenderer
ITextRenderer renderer = new ITextRenderer();
// 设置HTML内容
renderer.setDocumentFromString(html);
// 布局
renderer.layout();
// 创建PDF
renderer.createPDF(baos);
// 关闭
renderer.finishPDF();
// 设置响应头
response.setHeader("Content-Disposition", "inline; filename=simple_flying_saucer.pdf");
response.setContentLength(baos.size());
// 将PDF写入响应输出流
baos.writeTo(response.getOutputStream());
// 刷新输出流
response.getOutputStream().flush();
} catch (Exception e) {
e.printStackTrace();
throw new ServletException("生成PDF时出错", e);
}
%>

复制代码

在这个例子中，我们：

1. 导入了Flying Saucer的ITextRenderer类
2. 创建了一个包含HTML内容的字符串
3. 使用ITextRenderer将HTML渲染为PDF
4. 将生成的PDF写入响应输出流

与iText相比，Flying Saucer允许我们使用HTML和CSS来定义PDF的内容和样式，这对于熟悉Web开发的开发者来说更加直观。

5. 进阶实例：复杂的PDF生成

现在我们已经了解了基本的PDF生成方法，让我们来看一些更复杂的例子，包括表格、图片、水印等元素。

5.1 使用iText生成包含表格和图片的PDF

创建一个新的JSP页面，命名为advancedPDF.jsp：

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ page import="com.itextpdf.text.*" %>
<%@ page import="com.itextpdf.text.pdf.*" %>
<%@ page import="java.io.ByteArrayOutputStream" %>
<%@ page import="java.io.IOException" %>
<%@ page import="java.net.URL" %>
<%
// 设置响应内容类型为PDF
response.setContentType("application/pdf");
// 创建文档对象，设置页面大小和边距
Document document = new Document(PageSize.A4, 50, 50, 50, 50);
try {
// 创建字节输出流
ByteArrayOutputStream baos = new ByteArrayOutputStream();
// 获取PDF写入器
PdfWriter writer = PdfWriter.getInstance(document, baos);
// 打开文档
document.open();
// 添加标题
Font titleFont = new Font(Font.FontFamily.HELVETICA, 18, Font.BOLD);
Paragraph title = new Paragraph("高级PDF生成示例", titleFont);
title.setAlignment(Element.ALIGN_CENTER);
document.add(title);
// 添加空行
document.add(Chunk.NEWLINE);
// 添加段落
Font normalFont = new Font(Font.FontFamily.HELVETICA, 12);
Paragraph paragraph = new Paragraph("这个示例展示了如何在PDF中添加表格、图片和水印等元素。", normalFont);
document.add(paragraph);
// 添加空行
document.add(Chunk.NEWLINE);
// 创建表格
PdfPTable table = new PdfPTable(3); // 3列
table.setWidthPercentage(100); // 表格宽度为100%
// 添加表头
PdfPCell cell = new PdfPCell(new Phrase("ID", new Font(Font.FontFamily.HELVETICA, 12, Font.BOLD)));
cell.setBackgroundColor(BaseColor.LIGHT_GRAY);
table.addCell(cell);
cell = new PdfPCell(new Phrase("名称", new Font(Font.FontFamily.HELVETICA, 12, Font.BOLD)));
cell.setBackgroundColor(BaseColor.LIGHT_GRAY);
table.addCell(cell);
cell = new PdfPCell(new Phrase("价格", new Font(Font.FontFamily.HELVETICA, 12, Font.BOLD)));
cell.setBackgroundColor(BaseColor.LIGHT_GRAY);
table.addCell(cell);
// 添加表格数据
table.addCell("1");
table.addCell("产品A");
table.addCell("$100.00");
table.addCell("2");
table.addCell("产品B");
table.addCell("$200.00");
table.addCell("3");
table.addCell("产品C");
table.addCell("$300.00");
// 将表格添加到文档
document.add(table);
// 添加空行
document.add(Chunk.NEWLINE);
// 添加图片
try {
// 从URL加载图片
Image image = Image.getInstance(new URL("https://picsum.photos/seed/pdfexample/200/100.jpg"));
image.setAlignment(Element.ALIGN_CENTER);
document.add(image);
} catch (Exception e) {
document.add(new Paragraph("无法加载图片: " + e.getMessage()));
}
// 添加空行
document.add(Chunk.NEWLINE);
// 添加水印
PdfContentByte canvas = writer.getDirectContentUnder();
canvas.beginText();
canvas.setFontAndSize(BaseFont.createFont(BaseFont.HELVETICA, BaseFont.WINANSI, BaseFont.EMBEDDED), 48);
canvas.setColorFill(BaseColor.LIGHT_GRAY);
canvas.showTextAligned(Element.ALIGN_CENTER, "WATERMARK", document.getPageSize().getWidth() / 2, document.getPageSize().getHeight() / 2, 45);
canvas.endText();
// 添加页码
Phrase footer = new Phrase("Page ", new Font(Font.FontFamily.HELVETICA, 10));
HeaderFooter pageFooter = new HeaderFooter(footer, true);
pageFooter.setAlignment(Element.ALIGN_CENTER);
pageFooter.setBorder(Rectangle.NO_BORDER);
document.setFooter(pageFooter);
// 关闭文档
document.close();
// 设置响应头
response.setHeader("Content-Disposition", "inline; filename=advanced.pdf");
response.setContentLength(baos.size());
// 将PDF写入响应输出流
baos.writeTo(response.getOutputStream());
// 刷新输出流
response.getOutputStream().flush();
} catch (DocumentException | IOException e) {
e.printStackTrace();
throw new ServletException("生成PDF时出错", e);
}
%>

复制代码

这个例子展示了如何使用iText创建一个包含以下元素的PDF：

1. 标题：使用较大的粗体字居中显示
2. 段落：包含普通文本
3. 表格：包含表头和数据行，表头有背景色
4. 图片：从URL加载并居中显示
5. 水印：在页面中央以45度角显示的灰色文字
6. 页脚：包含页码

5.2 使用Flying Saucer生成包含复杂样式的PDF

现在，让我们使用Flying Saucer创建一个包含复杂样式的PDF。创建一个新的JSP页面，命名为advancedPDFWithFlyingSaucer.jsp：

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ page import="org.xhtmlrenderer.pdf.ITextRenderer" %>
<%@ page import="java.io.ByteArrayOutputStream" %>
<%@ page import="java.io.IOException" %>
<%
// 设置响应内容类型为PDF
response.setContentType("application/pdf");
try {
// HTML内容，包含复杂的CSS样式
String html = "<!DOCTYPE html>" +
"<html>" +
"<head>" +
"<meta charset="UTF-8">" +
"<title>高级PDF示例</title>" +
"<style>" +
"body {" +
" font-family: Arial, sans-serif;" +
" margin: 0;" +
" padding: 20px;" +
" color: #333;" +
"}" +
"h1 {" +
" color: #2c3e50;" +
" text-align: center;" +
" border-bottom: 2px solid #3498db;" +
" padding-bottom: 10px;" +
"}" +
"table {" +
" width: 100%;" +
" border-collapse: collapse;" +
" margin: 20px 0;" +
"}" +
"th, td {" +
" border: 1px solid #ddd;" +
" padding: 8px;" +
" text-align: left;" +
"}" +
"th {" +
" background-color: #f2f2f2;" +
" font-weight: bold;" +
"}" +
"tr:nth-child(even) {" +
" background-color: #f9f9f9;" +
"}" +
"img {" +
" display: block;" +
" margin: 20px auto;" +
" max-width: 100%;" +
"}" +
".watermark {" +
" position: fixed;" +
" top: 50%;" +
" left: 50%;" +
" transform: translate(-50%, -50%) rotate(-45deg);" +
" font-size: 48px;" +
" color: rgba(200, 200, 200, 0.5);" +
" z-index: -1;" +
" pointer-events: none;" +
"}" +
"@page {" +
" size: A4;" +
" margin: 1cm;" +
" @bottom-center {" +
" content: "Page " counter(page) " of " counter(pages);" +
" font-size: 10pt;" +
" }" +
"}" +
"</style>" +
"</head>" +
"<body>" +
"<div class="watermark">WATERMARK</div>" +
"<h1>高级PDF生成示例</h1>" +
"<p>这个示例展示了如何使用Flying Saucer生成包含复杂样式的PDF文档。</p>" +
"<table>" +
"<thead>" +
"<tr>" +
"<th>ID</th>" +
"<th>名称</th>" +
"<th>价格</th>" +
"</tr>" +
"</thead>" +
"<tbody>" +
"<tr>" +
"<td>1</td>" +
"<td>产品A</td>" +
"<td>$100.00</td>" +
"</tr>" +
"<tr>" +
"<td>2</td>" +
"<td>产品B</td>" +
"<td>$200.00</td>" +
"</tr>" +
"<tr>" +
"<td>3</td>" +
"<td>产品C</td>" +
"<td>$300.00</td>" +
"</tr>" +
"</tbody>" +
"</table>" +
"<img src="https://picsum.photos/seed/pdfexample/400/200.jpg" alt="示例图片">" +
"<p>Flying Saucer允许我们使用HTML和CSS来定义PDF的样式，这使得我们可以利用Web开发的知识来创建精美的PDF文档。</p>" +
"</body>" +
"</html>";
// 创建字节输出流
ByteArrayOutputStream baos = new ByteArrayOutputStream();
// 创建ITextRenderer
ITextRenderer renderer = new ITextRenderer();
// 设置HTML内容
renderer.setDocumentFromString(html);
// 布局
renderer.layout();
// 创建PDF
renderer.createPDF(baos);
// 关闭
renderer.finishPDF();
// 设置响应头
response.setHeader("Content-Disposition", "inline; filename=advanced_flying_saucer.pdf");
response.setContentLength(baos.size());
// 将PDF写入响应输出流
baos.writeTo(response.getOutputStream());
// 刷新输出流
response.getOutputStream().flush();
} catch (Exception e) {
e.printStackTrace();
throw new ServletException("生成PDF时出错", e);
}
%>

复制代码

这个例子展示了如何使用Flying Saucer创建一个包含复杂样式的PDF：

1. 使用CSS定义了整个文档的样式，包括字体、颜色、边距等
2. 创建了一个带有边框和斑马纹的表格
3. 添加了一个居中显示的图片
4. 使用CSS的position: fixed和transform属性创建了一个水印效果
5. 使用CSS的@page规则定义了页面大小和页脚

与iText相比，Flying Saucer允许我们使用更直观的HTML和CSS来定义PDF的样式，这对于熟悉Web开发的开发者来说更加友好。

5.3 从数据库生成PDF

在实际应用中，我们经常需要从数据库获取数据并生成PDF。下面是一个从数据库获取数据并生成PDF的示例。

首先，假设我们有一个简单的产品表，包含id、name和price字段。我们使用JDBC来获取数据并生成PDF。

创建一个新的JSP页面，命名为databasePDF.jsp：

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ page import="com.itextpdf.text.*" %>
<%@ page import="com.itextpdf.text.pdf.*" %>
<%@ page import="java.io.ByteArrayOutputStream" %>
<%@ page import="java.io.IOException" %>
<%@ page import="java.sql.*" %>
<%
// 设置响应内容类型为PDF
response.setContentType("application/pdf");
// 创建文档对象
Document document = new Document(PageSize.A4, 50, 50, 50, 50);
Connection conn = null;
PreparedStatement stmt = null;
ResultSet rs = null;
try {
// 创建字节输出流
ByteArrayOutputStream baos = new ByteArrayOutputStream();
// 获取PDF写入器
PdfWriter writer = PdfWriter.getInstance(document, baos);
// 打开文档
document.open();
// 添加标题
Font titleFont = new Font(Font.FontFamily.HELVETICA, 18, Font.BOLD);
Paragraph title = new Paragraph("产品列表", titleFont);
title.setAlignment(Element.ALIGN_CENTER);
document.add(title);
// 添加空行
document.add(Chunk.NEWLINE);
// 创建表格
PdfPTable table = new PdfPTable(3); // 3列
table.setWidthPercentage(100); // 表格宽度为100%
// 添加表头
PdfPCell cell = new PdfPCell(new Phrase("ID", new Font(Font.FontFamily.HELVETICA, 12, Font.BOLD)));
cell.setBackgroundColor(BaseColor.LIGHT_GRAY);
table.addCell(cell);
cell = new PdfPCell(new Phrase("名称", new Font(Font.FontFamily.HELVETICA, 12, Font.BOLD)));
cell.setBackgroundColor(BaseColor.LIGHT_GRAY);
table.addCell(cell);
cell = new PdfPCell(new Phrase("价格", new Font(Font.FontFamily.HELVETICA, 12, Font.BOLD)));
cell.setBackgroundColor(BaseColor.LIGHT_GRAY);
table.addCell(cell);
// 数据库连接信息
String dbUrl = "jdbc:mysql://localhost:3306/your_database";
String dbUser = "username";
String dbPassword = "password";
// 加载驱动
Class.forName("com.mysql.jdbc.Driver");
// 建立连接
conn = DriverManager.getConnection(dbUrl, dbUser, dbPassword);
// 创建查询
String sql = "SELECT id, name, price FROM products";
stmt = conn.prepareStatement(sql);
// 执行查询
rs = stmt.executeQuery();
// 遍历结果集并添加到表格
while (rs.next()) {
int id = rs.getInt("id");
String name = rs.getString("name");
double price = rs.getDouble("price");
table.addCell(String.valueOf(id));
table.addCell(name);
table.addCell("$" + String.format("%.2f", price));
}
// 将表格添加到文档
document.add(table);
// 添加空行
document.add(Chunk.NEWLINE);
// 添加生成时间
Font normalFont = new Font(Font.FontFamily.HELVETICA, 10);
Paragraph generatedTime = new Paragraph("生成时间: " + new java.util.Date(), normalFont);
generatedTime.setAlignment(Element.ALIGN_RIGHT);
document.add(generatedTime);
// 关闭文档
document.close();
// 设置响应头
response.setHeader("Content-Disposition", "inline; filename=products.pdf");
response.setContentLength(baos.size());
// 将PDF写入响应输出流
baos.writeTo(response.getOutputStream());
// 刷新输出流
response.getOutputStream().flush();
} catch (DocumentException | IOException | ClassNotFoundException | SQLException e) {
e.printStackTrace();
throw new ServletException("生成PDF时出错", e);
} finally {
// 关闭数据库资源
try {
if (rs != null) rs.close();
if (stmt != null) stmt.close();
if (conn != null) conn.close();
} catch (SQLException e) {
e.printStackTrace();
}
}
%>

复制代码

这个例子展示了如何：

1. 使用JDBC连接数据库并查询数据
2. 将查询结果添加到PDF表格中
3. 在PDF中添加生成时间等动态信息
4. 正确处理数据库资源的关闭

注意：在实际应用中，你应该将数据库连接信息存储在配置文件中，而不是直接写在JSP中。此外，为了提高性能和可维护性，你应该考虑使用连接池和DAO模式。

6. 常见问题及解决方案

在使用JSP生成PDF的过程中，开发者可能会遇到各种问题。下面是一些常见问题及其解决方案。

6.1 中文乱码问题

在生成包含中文的PDF时，最常见的问题就是中文显示为乱码或方框。这是因为默认情况下，iText等库不支持中文字体。

解决方案：

1. 使用支持中文的字体文件：

<%@ page import="com.itextpdf.text.pdf.BaseFont" %>
<%
// 创建支持中文的字体
BaseFont bfChinese = BaseFont.createFont("STSong-Light", "UniGB-UCS2-H", BaseFont.EMBEDDED);
Font fontChinese = new Font(bfChinese, 12, Font.NORMAL);
// 使用中文字体
Paragraph paragraph = new Paragraph("这是一个中文段落", fontChinese);
document.add(paragraph);
%>

复制代码

1. 使用iText的亚洲字体包：

<dependency>
<groupId>com.itextpdf</groupId>
<artifactId>itext-asian</artifactId>
<version>5.2.0</version>
</dependency>

复制代码

然后使用BaseFont.createFont()方法加载中文字体：

BaseFont bfChinese = BaseFont.createFont("STSongStd-Light", "UniGB-UCS2-H", false);
Font fontChinese = new Font(bfChinese, 12, Font.NORMAL);

复制代码

1. 对于Flying Saucer，确保HTML中指定了正确的字符集和字体：

<meta charset="UTF-8">
<style>
body {
font-family: "SimSun", "宋体", serif;
}
</style>

复制代码

6.2 样式问题

在使用Flying Saucer时，可能会发现某些CSS样式不被支持或渲染效果与预期不符。

解决方案：

1. 检查Flying Saucer的CSS支持情况，它主要支持CSS2.1和部分CSS3特性。
2. 避免使用不支持的CSS属性，如float、position: absolute等。
3. 使用表格布局代替复杂的CSS布局。
4. 如果必须使用不支持的CSS特性，考虑使用iText或其他库。

6.3 图片问题

在PDF中添加图片时，可能会遇到图片不显示、图片过大或图片质量下降等问题。

解决方案：

1. 确保图片路径正确，可以使用绝对路径或URL。
2. 调整图片大小：

Image image = Image.getInstance("path/to/image.jpg");
image.scaleToFit(400, 300); // 调整图片大小，最大宽度400，最大高度300
document.add(image);

复制代码

1. 控制图片质量：

Image image = Image.getInstance("path/to/image.jpg");
image.setCompressionLevel(9); // 设置压缩级别，0-9，9为最高压缩率
document.add(image);

复制代码

1. 对于Flying Saucer，确保图片路径是相对于HTML文件的，或者使用绝对路径。

6.4 性能问题

生成大型PDF文件或在高并发环境下生成PDF时，可能会遇到性能问题。

解决方案：

1. 使用缓存：对于不常变化的内容，可以生成PDF后缓存起来，避免重复生成。
2. 优化内存使用：及时关闭Document和PdfWriter对象，释放内存。
3. 分页处理：对于大型报表，考虑分页生成或分批处理数据。
4. 使用异步生成：对于耗时较长的PDF生成任务，可以使用异步处理，避免阻塞用户请求。

6.5 安全问题

PDF生成可能涉及敏感数据，需要考虑安全性问题。

解决方案：

1. 添加密码保护：

PdfWriter writer = PdfWriter.getInstance(document, baos);
writer.setEncryption("userpassword".getBytes(), "ownerpassword".getBytes(),
PdfWriter.ALLOW_PRINTING, PdfWriter.ENCRYPTION_AES_128);

复制代码

1. 防止PDF注入：确保用户输入的数据经过适当的验证和转义，防止恶意内容被注入到PDF中。
2. 控制访问权限：确保只有授权用户才能访问PDF生成功能。
3. 记录日志：记录PDF生成操作，便于审计和追踪。

6.6 兼容性问题

不同的PDF阅读器可能对某些特性支持不同，导致PDF在某些阅读器中显示异常。

解决方案：

1. 遵守PDF标准：使用广泛支持的PDF特性，避免使用专有或实验性功能。
2. 测试多种阅读器：在Adobe Reader、Foxit Reader等多种PDF阅读器中测试生成的PDF。
3. 提供替代方案：对于复杂的PDF，考虑提供HTML版本作为替代。

7. 最佳实践

在JSP中生成PDF时，遵循一些最佳实践可以提高代码质量、性能和可维护性。

7.1 代码组织

1. 将PDF生成逻辑封装到单独的类中，而不是直接写在JSP中：

public class PDFGenerator {
public static byte[] generateProductReport(List<Product> products) throws DocumentException, IOException {
Document document = new Document(PageSize.A4, 50, 50, 50, 50);
ByteArrayOutputStream baos = new ByteArrayOutputStream();
PdfWriter.getInstance(document, baos);
document.open();
// 添加内容
document.add(new Paragraph("产品报告"));
PdfPTable table = new PdfPTable(3);
// 添加表头
table.addCell("ID");
table.addCell("名称");
table.addCell("价格");
// 添加数据
for (Product product : products) {
table.addCell(String.valueOf(product.getId()));
table.addCell(product.getName());
table.addCell("$" + product.getPrice());
}
document.add(table);
document.close();
return baos.toByteArray();
}
}

复制代码

1. 在Servlet中处理PDF生成请求，而不是直接在JSP中：

@WebServlet("/productReport")
public class ProductReportServlet extends HttpServlet {
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
try {
// 获取产品数据
List<Product> products = ProductDAO.getAllProducts();
// 生成PDF
byte[] pdfData = PDFGenerator.generateProductReport(products);
// 设置响应
response.setContentType("application/pdf");
response.setHeader("Content-Disposition", "inline; filename=product_report.pdf");
response.setContentLength(pdfData.length);
// 写入响应
response.getOutputStream().write(pdfData);
response.getOutputStream().flush();
} catch (DocumentException e) {
throw new ServletException("生成PDF时出错", e);
}
}
}

复制代码

1. 使用MVC模式，将数据获取、业务逻辑和视图生成分离。

7.2 异常处理

1. 使用try-catch块捕获可能的异常，并提供有意义的错误信息：

try {
// PDF生成代码
} catch (DocumentException e) {
logger.error("生成PDF时出错", e);
throw new ServletException("无法生成PDF文档", e);
} catch (IOException e) {
logger.error("写入PDF时出错", e);
throw new ServletException("无法写入PDF文档", e);
}

复制代码

1. 对于用户输入的数据，进行验证和清理：

String title = request.getParameter("title");
if (title == null || title.trim().isEmpty()) {
title = "默认标题";
}
// 清理HTML标签，防止XSS攻击
title = title.replaceAll("<[^>]*>", "");

复制代码

7.3 性能优化

1. 使用对象池重用PDF生成对象：

public class PDFWriterPool {
private static final int MAX_POOL_SIZE = 10;
private static final List<PdfWriter> pool = new ArrayList<>(MAX_POOL_SIZE);
public static PdfWriter getPdfWriter(Document document, OutputStream os) throws DocumentException {
synchronized (pool) {
if (!pool.isEmpty()) {
PdfWriter writer = pool.remove(pool.size() - 1);
writer.setPdfWriter(document, os);
return writer;
}
}
return PdfWriter.getInstance(document, os);
}
public static void returnPdfWriter(PdfWriter writer) {
synchronized (pool) {
if (pool.size() < MAX_POOL_SIZE) {
writer.close();
pool.add(writer);
}
}
}
}

复制代码

1. 使用缓存减少重复生成：

public class PDFCache {
private static final Map<String, byte[]> cache = new ConcurrentHashMap<>();
private static final long CACHE_EXPIRY_TIME = 60 * 60 * 1000; // 1小时
public static byte[] getCachedPDF(String key) {
CacheEntry entry = (CacheEntry) cache.get(key);
if (entry != null && !entry.isExpired()) {
return entry.getData();
}
return null;
}
public static void cachePDF(String key, byte[] data) {
cache.put(key, new CacheEntry(data));
}
private static class CacheEntry {
private final byte[] data;
private final long timestamp;
public CacheEntry(byte[] data) {
this.data = data;
this.timestamp = System.currentTimeMillis();
}
public boolean isExpired() {
return System.currentTimeMillis() - timestamp > CACHE_EXPIRY_TIME;
}
public byte[] getData() {
return data;
}
}
}

复制代码

1. 使用异步处理提高响应速度：

@WebServlet("/asyncPDFReport")
public class AsyncPDFReportServlet extends HttpServlet {
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
// 启动异步处理
AsyncContext asyncContext = request.startAsync();
// 在新线程中生成PDF
ExecutorService executor = (ExecutorService) request.getServletContext()
.getAttribute("executorService");
executor.submit(() -> {
try {
// 获取产品数据
List<Product> products = ProductDAO.getAllProducts();
// 生成PDF
byte[] pdfData = PDFGenerator.generateProductReport(products);
// 设置响应
HttpServletResponse asyncResponse = (HttpServletResponse) asyncContext.getResponse();
asyncResponse.setContentType("application/pdf");
asyncResponse.setHeader("Content-Disposition", "inline; filename=product_report.pdf");
asyncResponse.setContentLength(pdfData.length);
// 写入响应
asyncResponse.getOutputStream().write(pdfData);
asyncResponse.getOutputStream().flush();
} catch (Exception e) {
try {
HttpServletResponse asyncResponse = (HttpServletResponse) asyncContext.getResponse();
asyncResponse.sendError(HttpServletResponse.SC_INTERNAL_SERVER_ERROR, "生成PDF时出错");
} catch (IOException ioException) {
// 记录错误
}
} finally {
asyncContext.complete();
}
});
}
}

复制代码

7.4 安全性考虑

1. 添加PDF密码保护：

public class SecurePDFGenerator {
public static byte[] generateSecurePDF(List<Product> products, String userPassword, String ownerPassword)
throws DocumentException, IOException {
Document document = new Document(PageSize.A4, 50, 50, 50, 50);
ByteArrayOutputStream baos = new ByteArrayOutputStream();
PdfWriter writer = PdfWriter.getInstance(document, baos);
// 设置用户密码和所有者密码
writer.setEncryption(
userPassword.getBytes(),
ownerPassword.getBytes(),
PdfWriter.ALLOW_PRINTING,
PdfWriter.ENCRYPTION_AES_128
);
document.open();
// 添加内容
document.add(new Paragraph("安全产品报告"));
PdfPTable table = new PdfPTable(3);
// 添加表头和数据...
document.add(table);
document.close();
return baos.toByteArray();
}
}

复制代码

1. 添加数字签名：

public class SignedPDFGenerator {
public static byte[] generateSignedPDF(List<Product> products, PrivateKey pk, Certificate[] chain)
throws DocumentException, IOException, GeneralSecurityException {
Document document = new Document(PageSize.A4, 50, 50, 50, 50);
ByteArrayOutputStream baos = new ByteArrayOutputStream();
PdfWriter writer = PdfWriter.getInstance(document, baos);
document.open();
// 添加内容
document.add(new Paragraph("签名产品报告"));
PdfPTable table = new PdfPTable(3);
// 添加表头和数据...
document.add(table);
// 添加签名
PdfSignatureAppearance appearance = writer.getSignatureAppearance();
appearance.setReason("文档认证");
appearance.setLocation("服务器");
appearance.setVisibleSignature(new Rectangle(36, 748, 144, 780), 1, "signature");
ExternalSignature signature = new PrivateKeySignature(pk, DigestAlgorithms.SHA256, "BC");
MakeSignature.signDetached(appearance, signature, chain, null, null, null, 0, CryptoStandard.CMS);
document.close();
return baos.toByteArray();
}
}

复制代码

1. 防止PDF注入攻击：

public class SafePDFGenerator {
public static byte[] generateSafePDF(String userInput) throws DocumentException, IOException {
// 清理用户输入，防止PDF注入
String safeInput = sanitizeUserInput(userInput);
Document document = new Document();
ByteArrayOutputStream baos = new ByteArrayOutputStream();
PdfWriter.getInstance(document, baos);
document.open();
// 使用清理后的输入
document.add(new Paragraph(safeInput));
document.close();
return baos.toByteArray();
}
private static String sanitizeUserInput(String input) {
// 移除可能有害的字符
return input.replaceAll("[\\p{Cntrl}]", "");
}
}

复制代码

8. 总结与展望

本教程从基础到进阶，全面解析了在JSP页面中动态生成PDF文件的技术实现方法。我们介绍了常用的PDF生成库，包括iText、Flying Saucer、Apache FOP和JasperReports，并通过详细的实例展示了如何使用这些库生成简单的和复杂的PDF文档。我们还讨论了常见的问题及其解决方案，以及一些最佳实践。

随着技术的发展，PDF生成技术也在不断进步。未来，我们可以期待以下发展趋势：

1. 更好的CSS支持：随着CSS标准的不断发展，PDF生成库对CSS的支持将更加完善，使得Web开发者可以更轻松地创建复杂的PDF布局。
2. 更高的性能：随着多核处理器的普及，PDF生成库将更好地利用多线程和并行处理，提高生成速度。
3. 更丰富的交互功能：未来的PDF生成技术可能会支持更多的交互功能，如表单、动画、视频等，使PDF文档更加生动。
4. 更好的移动设备支持：随着移动设备的普及，PDF生成技术将更好地适应移动设备的屏幕尺寸和交互方式。
5. 云服务集成：将PDF生成功能作为云服务提供，使开发者可以更轻松地集成PDF生成功能，而无需担心服务器配置和维护。

更好的CSS支持：随着CSS标准的不断发展，PDF生成库对CSS的支持将更加完善，使得Web开发者可以更轻松地创建复杂的PDF布局。

更高的性能：随着多核处理器的普及，PDF生成库将更好地利用多线程和并行处理，提高生成速度。

更丰富的交互功能：未来的PDF生成技术可能会支持更多的交互功能，如表单、动画、视频等，使PDF文档更加生动。

更好的移动设备支持：随着移动设备的普及，PDF生成技术将更好地适应移动设备的屏幕尺寸和交互方式。

云服务集成：将PDF生成功能作为云服务提供，使开发者可以更轻松地集成PDF生成功能，而无需担心服务器配置和维护。

无论技术如何发展，掌握PDF生成的基本原理和常用技术对于Java Web开发者来说都是一项重要的技能。希望本教程能够帮助你快速掌握JSP PDF生成技术，并在实际项目中应用这些知识。

最后，记住学习是一个持续的过程。不断探索新的技术和方法，参与社区讨论，分享你的经验和知识，这将使你成为一名更优秀的开发者。祝你学习愉快！

版权声明

1、转载或引用本网站内容(JSP PDF生成实例教程从基础到进阶全面解析JSP页面动态生成PDF文件的技术实现方法与常见问题解决方案)须注明原网址及作者(威震华夏关云长)，并标明本网站网址(https://pixtech.cc/)。

2、对于不当转载或引用本网站内容而引起的民事纷争、行政处理或其他损失，本网站不承担责任。

3、对不遵守本声明或其他违法、恶意使用本网站内容者，本网站保留追究其法律责任的权利。

本文地址: https://pixtech.cc/thread-39057-1-1.html

	通知：是的！我们正在计划一个大动作！	11-02 12:46
	通知：Telegram 推送频道https://t.me/+2tB3a7aKXlw2YjA1 及时接收第一手论坛帖子信息～	10-23 09:32
	通知：本站资源由网友上传分享，如有违规等问题请到版务模块进行投诉，将及时处理！	10-23 09:31
	通知：加入QQ社群吧 https://qm.qq.com/q/QZibQd1hiq	10-23 09:28
	通知：签到时间调整为每日4:00（东八区）	10-23 09:26

活动公告

JSP PDF生成实例教程从基础到进阶全面解析JSP页面动态生成PDF文件的技术实现方法与常见问题解决方案

马上注册，结交更多好友，享用更多功能，让你轻松玩转社区。

版权声明

浏览过的版块

三倍冰淇淋

无人之境【一阶】

财Doro

小樱（小丑装）

立华奏

以外的星空【二阶】

⑨的冰沙

友情链接

频道订阅

加入社群