Java利用PDFBox实现PDF文档基本操作

目录

• 一、PDFBox组件
• 1.1、什么是PDFBox
• 1.2、创建PDF文档
• 1.3、加载PDF文档
• 1.4、添加空白页面
• 1.5、删除某个页面
• 1.6、获取PDF总页数
• 1.7、添加文本内容
• 1.8、PDFBox中的坐标系

一、PDFBox组件

1.1、什么是PDFBox

PDFBox是Apache提供的一款专门用于操作PDF文档的工具组件，使用PDFBox可以很方便对PDF文档进行各种操作，例如：创建PDF文档、读取PDF文档内容、加载PDF文档内容、合并PDF文档、拆分PDF文档等等，使用PDFBox需要引入对应的依赖，这篇文章就基于下面的依赖，介绍一下PDFBox中一些常见的方法及其使用方式。

PDFBox所需依赖：

<dependencies> <!-- 引入 PDFBox 相关的依赖 开始 --> <dependency> <groupId>org.apache.pdfbox</groupId> <artifactId>pdfbox</artifactId> <version>2.0.29</version> </dependency> <dependency> <groupId>org.apache.pdfbox</groupId> <artifactId>fontbox</artifactId> <version>2.0.29</version> </dependency> <dependency> <groupId>org.apache.pdfbox</groupId> <artifactId>xmpbox</artifactId> <version>2.0.29</version> </dependency> <dependency> <groupId>org.apache.pdfbox</groupId> <artifactId>preflight</artifactId> <version>2.0.29</version> </dependency> <dependency> <groupId>org.apache.pdfbox</groupId> <artifactId>pdfbox-tools</artifactId> <version>2.0.29</version> </dependency> <dependency> <groupId>org.apache.pdfbox</groupId> <artifactId>jempbox</artifactId> <version>1.8.17</version> </dependency> <!-- 引入 PDFBox 相关的依赖 结束 --> </dependencies>

1.2、创建PDF文档

pdf，英文全称是：Portable Document File，便携式文档文件，又叫做pdf文档，一个文档里面包含了多个页面，每一个页面里面又包含了很多的文字、段落、图像等内容。

创建PDF文档只需要创建一个【PDDocument】对象即可，这个对象就表示PDF文档对象，使用这种方式创建的PDF文档是不包含任何页面的，所以打开这个PDF时候会提示错误。

package com.pdfbox.demo; import org.apache.pdfbox.pdmodel.PDDocument; import java.io.IOException; public class PDFBoxExample { public static void main(String[] args) throws IOException { // 1、创建文档对象 PDDocument doc = new PDDocument(); // 2、生成pdf文件，保存pdf文件 // 这里会在D盘下生成一个 demo.pdf 空白的pdf文档 doc.save("D:\\demo.pdf"); // 3、关闭文档流 doc.close(); } }

1.3、加载PDF文档

有时候，我们需要加载一个已经创建好的PDF文档，这个时候就可以使用PDDocument类中的【load()】方法，加载指定的pdf文件，代码如下：

（1）加载本地PDF文档

// 1、加载文档对象 File file = new File("D:\\demo.pdf"); PDDocument doc = PDDocument.load(file); // TODO 做一些操作 // .... // 关闭文档 doc.close(); 

（2）加载网络PDF文档

PDFBox也可以通过流的方式加载网络上的PDF文档，如下所示：

package pdfbox.demo; import org.apache.pdfbox.pdmodel.PDDocument; import java.io.IOException; import java.net.URL; public class PDFDemo { public static void main(String[] args) throws IOException { // 1、加载网络PDF文档 PDDocument doc = PDDocument.load(new URL("https://ip:port/demo.pdf").openStream()); // ..... // 关闭文档 doc.close(); } }

1.4、添加空白页面

当我们创建好了一个PDF文档对象，就可以继续向这个文档里面添加空白的Page页面，Page页面就是可以看得见的内容区域啦，页面有大小可以设置，例如：A4、A5、A6等尺寸，一般情况下，都是使用A4大小尺寸就可以满足需求了。创建Page页面，只需要创建一个【PDPage】对象即可，在构造方法中可以传递一个【PDRectangle.A4】参数，用于设置页面大小。

package com.pdfbox.demo; import org.apache.pdfbox.pdmodel.PDDocument; import org.apache.pdfbox.pdmodel.PDPage; import org.apache.pdfbox.pdmodel.common.PDRectangle; import java.io.IOException; public class PDFBoxExample { public static void main(String[] args) throws IOException { // 1、创建文档对象 PDDocument doc = new PDDocument(); // 2、添加空白页面，大小是 A4 纸那么大 PDPage page = new PDPage(PDRectangle.A4); doc.addPage(page); // 3、生成pdf文件，保存pdf文件 // 这里会在D盘下生成一个 demo.pdf 空白的pdf文档 doc.save("D:\\demo.pdf"); // 4、关闭文档流 doc.close(); } }

1.5、删除某个页面

PDDocument文档对象提供了一个【removePage()】方法，可以用于删除指定下标的页面（从0开始）、删除指定Page页面对象。

// 1、创建文档对象 PDDocument doc = new PDDocument(); // TODO 删除第1个页面 doc.removePage(0); // 或者删除指定的Page对象页面 // PDPage page = new PDPage(PDRectangle.A4); // doc.removePage(page); 

1.6、获取PDF总页数

PDDocument文档对象提供了一个【getNumberOfPages()】方法，这个方法可以获取当前PDF中总共有多少个Page页面，返回int类型。

// 1、创建文档对象 PDDocument doc = new PDDocument(); // TODO 获取文档总页数 int pages = doc.getNumberOfPages(); System.out.println("总页数: " + pages); 

1.7、添加文本内容

前面已经介绍了创建PDF文档、添加PDF空白页面、获取PDF页数等内容，但是还没有介绍如何向PDF页面中写入内容，我们可以向PDF文档中写入文本内容、图像内容、表单内容等，这里先介绍一下如何写入纯文本内容。

PDFBox将一个Page页面中的内容抽象成内容流的形式，所以我们在对Page页面内容进行操作的时候，也需要通过内容流来完成，内容流是采用PDPageContentStream对象表示的。

（1）写入单行内容

写入单行内容，也就是说，无论我们写入的文本内容有多长，这个内容只会显示在一行上面，超出PDF页面范围之外的内容会被遮挡，案例代码如下：

package pdfbox.demo; import org.apache.pdfbox.pdmodel.PDDocument; import org.apache.pdfbox.pdmodel.PDPage; import org.apache.pdfbox.pdmodel.PDPageContentStream; import org.apache.pdfbox.pdmodel.common.PDRectangle; import org.apache.pdfbox.pdmodel.font.PDType1Font; import java.io.IOException; public class PDFBoxDemo01 { public static void main(String[] args) throws IOException { // 1、创建文档对象 PDDocument doc = new PDDocument(); // 2、添加空白页面，大小是 A4 纸那么大 PDPage page = new PDPage(PDRectangle.A4); doc.addPage(page); // TODO 添加文本内容【单行】，指定文档对象、页面对象 PDPageContentStream stream = new PDPageContentStream(doc, page); stream.beginText(); // 文本开始 stream.setFont(PDType1Font.TIMES_ROMAN, 14); // 设置文本的字体、字体大小 stream.newLineAtOffset(10, 200); // 设置文本显示的起始坐标位置 String content = "hello world.hello world.hello world.hello world.hello world." + "hello world.hello world.hello world.hello world."; stream.showText(content); // 设置需要添加的文本内容，注意：中文内容写入时候，需要保证字体支持中文 stream.endText(); // 文本结束 stream.close(); // 关闭内容流 // 3、生成pdf文件，保存pdf文件 // 这里会在D盘下生成一个 demo.pdf 空白的pdf文档 doc.save("D:\\demo.pdf"); // 4、关闭文档流 doc.close(); } }

运行效果：

（2）写入多行内容

PDFBox显示多行文本内容，需要使用【setLeading()】方法和【newLine()】方法，【setLeading()】方法用于设置文本的行距，【newLine()】方法用于换行显示，需要注意的是，虽然这里是写入多行内容，但是同一行中的内容如果超过了Page页面的宽度，也是会被遮挡的，不会自动换行显示。

package pdfbox.demo; import org.apache.pdfbox.pdmodel.PDDocument; import org.apache.pdfbox.pdmodel.PDPage; import org.apache.pdfbox.pdmodel.PDPageContentStream; import org.apache.pdfbox.pdmodel.common.PDRectangle; import org.apache.pdfbox.pdmodel.font.PDFont; import org.apache.pdfbox.pdmodel.font.PDType0Font; import org.apache.pdfbox.pdmodel.font.PDType1Font; import java.io.IOException; public class PDFBoxExample { public static void main(String[] args) throws IOException { // 1、创建文档对象 PDDocument doc = new PDDocument(); // 2、添加空白页面，大小是 A4 纸那么大 PDPage page = new PDPage(PDRectangle.A4); doc.addPage(page); // TODO 添加文本内容，指定文档对象、页面对象 PDPageContentStream stream = new PDPageContentStream(doc, page); stream.beginText(); // 文本开始 stream.setFont(PDType1Font.TIMES_ROMAN, 14); // 设置内容流文本的字体、字体大小 stream.newLineAtOffset(10, 350); // 设置内容流文本显示的起始坐标位置 for (int i = 0; i < 10; i++) { stream.setLeading(20 + i*2); // 设置文本的前导，也就是文本行距，不设置这个行距，文本会重叠在一起 String content = "hello world.hello world.hello world.hello world.hello world." + "hello world.hello world.hello world.hello world."; stream.showText(content); // 设置需要添加的文本内容，注意：中文内容写入时候，需要保证字体支持中文 stream.newLine(); // 新增一个新行显示 } stream.endText(); // 文本结束 stream.close(); // 关闭内容流 // 3、生成pdf文件，保存pdf文件 // 这里会在D盘下生成一个 demo.pdf 空白的pdf文档 doc.save("D:\\demo.pdf"); // 4、关闭文档流 doc.close(); } }

运行效果：

1.8、PDFBox中的坐标系

PDFBox中的坐标位置：PDFBox中是以页面左下脚为坐标圆点，水平方向是x轴，垂直方向是y轴，如下图所示：

另外，PDFBox中一般是使用【pt】作为单位，有时候我们可能会遇到【px】像素单位，所以就需要将pt和px单位进行换算，pt和px单位转换关系是：【1pt= 1px * 3 / 4】。

以上就是Java利用PDFBox实现PDF文档基本操作的详细内容，更多关于Java PDFBox操作pdf的资料请关注本网站其它相关文章！

您可能感兴趣的文章:

• java使用pdfbox操作pdf文件示例
• Java基于PDFbox实现读取处理PDF文件
• java利用pdfbox+poi往pdf插入数据
• Java使用pdfbox实现给pdf文件加图片水印
• Java使用PDFBox实现操作PDF文档