在Java中实现格式转换为PDF，通常需要借助第三方开源库。目前业界最常用且功能强大的两个库是 iText 和 Apache PDFBox。
以下我将为您提供基于这两种主流方案的完整逻辑与代码示例，涵盖最常见的三种转换场景：纯文本转PDF、图片转PDF 以及 HTML网页转PDF。
方案一：使用 iText 库（推荐，API更高级）
iText 提供了丰富的文档排版能力，非常适合生成复杂的报表或文档。
1. 引入 Maven 依赖1. 引入 Maven 依赖
<dependency>
<groupId>com.itextpdf</groupId>
<artifactId>itext7-core</artifactId>
<version>7.2.5</version>
<type>pom</type>
</dependency>
<!-- 如果需要HTML转PDF，还需要引入 pdfHTML -->
<dependency>
<groupId>com.itextpdf</groupId>
<artifactId>html2pdf</artifactId>
<version>4.0.3</version>
</dependency>2. 完整转换工具类代码
import com.itextpdf.html2pdf.HtmlConverter;
import com.itextpdf.kernel.geom.PageSize;
import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.kernel.pdf.PdfWriter;
import com.itextpdf.layout.Document;
import com.itextpdf.layout.element.Image;
import com.itextpdf.layout.element.Paragraph;
import com.itextpdf.io.image.ImageDataFactory;
import java.io.*;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Paths;
public class PdfConverter {
/**
* 1. 纯文本 (TXT) 转换为 PDF
*/
public static void textToPdf(String txtPath, String pdfPath) throws IOException {
// 读取文本内容
String content = new String(Files.readAllBytes(Paths.get(txtPath)), StandardCharsets.UTF_8);
try (PdfWriter writer = new PdfWriter(pdfPath);
PdfDocument pdfDoc = new PdfDocument(writer);
Document document = new Document(pdfDoc, PageSize.A4)) {
// 将文本按行分割并添加到PDF中
for (String line : content.split("\n")) {
document.add(new Paragraph(line));
}
}
}
/**
* 2. 图片转换为 PDF
*/
public static void imageToPdf(String imagePath, String pdfPath) throws Exception {
try (PdfWriter writer = new PdfWriter(pdfPath);
PdfDocument pdfDoc = new PdfDocument(writer);
Document document = new Document(pdfDoc, PageSize.A4)) {
Image image = new Image(ImageDataFactory.create(imagePath));
// 缩放图片以适应A4纸张宽度
image.scaleToFit(PageSize.A4.getWidth(), PageSize.A4.getHeight());
document.add(image);
}
}
/**
* 3. HTML 字符串/文件转换为 PDF
*/
public static void htmlToPdf(String htmlContent, String pdfPath) throws IOException {
try (OutputStream os = new FileOutputStream(pdfPath)) {
// 核心方法：直接将HTML流转换为PDF流
HtmlConverter.convertToPdf(htmlContent, os);
}
}
// 测试入口
public static void main(String[] args) throws Exception {
// 示例：HTML转PDF
String html = "<h1>Hello PDF</h1><p>这是一段由Java生成的PDF内容。</p>";
htmlToPdf(html, "output_from_html.pdf");
}
}方案二：使用 Apache PDFBox 库（轻量级，完全免费开源）
PDFBox 在处理基础的文本写入和图片嵌入时非常稳定，适合不需要复杂排版的场景。
1. 引入 Maven 依赖
<dependency>
<groupId>org.apache.pdfbox</groupId>
<artifactId>pdfbox</artifactId>
<version>2.0.24</version>
</dependency>2. 基础文本写入示例
import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDPage;
import org.apache.pdfbox.pdmodel.PDPageContentStream;
import org.apache.pdfbox.pdmodel.font.PDType1Font;
import java.io.IOException;
public class PdfBoxConverter {
public static void createSimplePdf(String pdfPath, String text) throws IOException {
try (PDDocument document = new PDDocument()) {
PDPage page = new PDPage();
document.addPage(page);
try (PDPageContentStream contentStream = new PDPageContentStream(document, page)) {
contentStream.beginText();
contentStream.setFont(PDType1Font.HELVETICA_BOLD, 12);
contentStream.newLineAtOffset(100, 700); // 设置文本起始坐标
contentStream.showText(text);
contentStream.endText();
}
document.save(pdfPath);
}
}
}核心开发建议与注意事项：
- 中文乱码问题：上述 iText 和 PDFBox 的基础示例使用的是默认英文字体。如果您的业务涉及中文转换，必须在代码中显式加载中文字体文件（如
msyh.ttf微软雅黑），否则生成的PDF会出现乱码或方块。 - 资源释放：无论使用哪种库，务必确保
Document、PdfWriter或ContentStream等对象在使用后被正确关闭（推荐使用 Java 的try-with-resources语法），以防止内存泄漏和文件被占用无法删除。 - HTML转PDF的局限性：在使用 iText 的
html2pdf模块时，它不支持所有的 CSS3 特性（如部分伪类:hover或@import规则）。对于复杂的网页，建议在转换前先将外部CSS内联化。
