前言
本文将介绍通过Java编程来处理PDF文档的一些方法,因为一篇文档的处理可能包括很多内容,比如文档安全性设置(水印、加密/解密)、文本/图片/图形操作、注释、附件、域、文档转换(其他文件格式转为PDF或PDF转为其他文件格式)、表格、书签、文本/图片读取、文档合并拆分等等,针对不同的程序设计需求,这里对PDF操作的需求也就不同。在接下来的文章中,也将分次介绍Java代码示例的具体操作方法。
本次Java操作PDF文档要点概括

  • 添加页眉/页脚
  • 添加PDF文本水印、图片水印
  • 设置PDF文档背景色:纯色、图片背景色
  • 添加附件到PDF(2种方式)
    关于使用工具:Spire.PDF for Java
    这款PDF控件是E-iceblue公司发布的Java系列产品之一,目前为止该系列下有Spire.PDF、Spire.Barcode(二维码、条码控件)、 Spire.Presentation(PPT控件)等三个控件,都有免费版Free Spire系列,这点比较好,对于不熟悉该控件时,测试和使用都比较方便。当然,程序上对文档的操作有更高的要求时,建议还是使用商业版,毕竟更强大的功能对你的程序设计是百利而无一害的。要下载Spire.PDF for Java可通过以下途径:
    1.E-iceblue官网(推荐):https://www.e-iceblue.cn/Introduce/Spire-PDF-JAVA.html (商业版)https://www.e-iceblue.cn/Introduce/Free-Spire-PDF-JAVA.html (免费版)
    2.CSDN: https://download.csdn.net/download/miaonly/10867030 (免费版)
    3.51CTO: http://down.51cto.com/data/2457197 (免费版)
    Jar文件导入:
    步骤1:在Java程序中新建一个文件夹可命名为Lib。下载安装包后,解压,将解压后的文件夹下的子文件夹lib中的Spire.Pdf.jar和Spire.Common.jar两个文件复制到程序中新建的文件夹下,如下图:
    Java 处理PDF文档(一):页眉页脚、水印、背景、附件_第1张图片
    步骤2:建好文件夹后,引用两个文件:选中这两个jar文件,点击鼠标右键,选择“Build Path” – “Add to Build Path”。如下图:
    Java 处理PDF文档(一):页眉页脚、水印、背景、附件_第2张图片
    代码示例(供参考),这里示例代码仅供列出实现功能需求效果,具体实现效果,请结合实际程序项目进行测试,如遇问题不好解决的话可联系Q: 2181348176。

    【示例1】页眉页脚

import java.awt.*;
import java.awt.geom.Dimension2D;
import com.spire.pdf.*;
import com.spire.pdf.automaticfields.PdfAutomaticField;
import com.spire.pdf.automaticfields.PdfCompositeField;
import com.spire.pdf.automaticfields.PdfPageCountField;
import com.spire.pdf.automaticfields.PdfPageNumberField;
import com.spire.pdf.graphics.*;

public class HeaderFooter {
    public static void main(String[] args) throws Exception {

        //创建 PdfDocument 对象
        PdfDocument doc = new PdfDocument();

        //创建PdfMargins对象, 并设置的页边距
        PdfMargins margin = new PdfMargins(60,60,40,40);

        //调用 addHeaderAndFooter()方法添加页眉页脚
        addHeaderAndFooter(doc, PdfPageSize.A4, margin);       
        //保存文档
        doc.saveToFile("output/headerFooter.pdf");
        doc.close();

    }
    static void addHeaderAndFooter(PdfDocument doc, Dimension2D pageSize, PdfMargins margin) {

        PdfPageTemplateElement header = new PdfPageTemplateElement(margin.getLeft(), pageSize.getHeight());
        doc.getTemplate().setLeft(header);

        PdfPageTemplateElement topSpace = new PdfPageTemplateElement(pageSize.getWidth(), margin.getTop());
        topSpace.setForeground(true);
        doc.getTemplate().setTop(topSpace);

        //添加页眉
        PdfTrueTypeFont font= new PdfTrueTypeFont(new Font("Arial Unicode MS",Font.PLAIN,10),true);

        PdfStringFormat format = new PdfStringFormat(PdfTextAlignment.Left);
        String label = "2018年 年度会议报告";
        Dimension2D dimension2D = new Dimension();
        dimension2D.setSize(font.measureString(label, format));
        float y = topSpace.getHeight() - font.getHeight() - 1;
        PdfPen pen = new PdfPen(new PdfRGBColor(Color.black), 0.75f);
        topSpace.getGraphics().setTransparency(0.5f);
        topSpace.getGraphics().drawLine(pen, margin.getLeft(), y, pageSize.getWidth() - margin.getRight(), y);
        y = y - 1 - (float) dimension2D.getHeight();
        topSpace.getGraphics().drawString(label, font, PdfBrushes.getBlack(), margin.getLeft(), y, format);

        PdfPageTemplateElement rightSpace = new PdfPageTemplateElement(margin.getRight(), pageSize.getHeight());
        doc.getTemplate().setRight(rightSpace);

        //添加显示当前页及总页数的域作为页脚
        PdfPageTemplateElement footer = new PdfPageTemplateElement(pageSize.getWidth(), margin.getBottom());
        footer.setForeground(true);
        doc.getTemplate().setBottom(footer);

        y = font.getHeight() + 1;
        footer.getGraphics().setTransparency(0.5f);
        footer.getGraphics().drawLine(pen, margin.getLeft(), y, pageSize.getWidth() - margin.getRight(), y);
        y = y + 1;
        PdfPageNumberField pageNumber = new PdfPageNumberField();
        PdfPageCountField pageCount = new PdfPageCountField();
        PdfCompositeField pageNumberLabel = new PdfCompositeField();
        pageNumberLabel.setAutomaticFields(new PdfAutomaticField[]{pageNumber, pageCount});
        pageNumberLabel.setBrush(PdfBrushes.getBlack());
        pageNumberLabel.setFont(font);
        format = new PdfStringFormat(PdfTextAlignment.Right);
        pageNumberLabel.setStringFormat(format);
        pageNumberLabel.setText("第{0}页 共{1}页");
        pageNumberLabel.setBounds(footer.getBounds());
        pageNumberLabel.draw(footer.getGraphics(), pageSize.getWidth() - margin.getLeft(), y);
    }
}

页眉页脚实现效果:
Java 处理PDF文档(一):页眉页脚、水印、背景、附件_第3张图片
Java 处理PDF文档(一):页眉页脚、水印、背景、附件

【示例2】添加水印

这里将分别使用insertTextWatermark(PdfPageBase page, String watermark)方法以及page.SetBackgroundImage(String arg0)方法来设置文本水印和图片水印。
1.文本水印

import com.spire.pdf.*;
import com.spire.pdf.graphics.*;
import java.awt.*;
import java.awt.geom.*;

public class Textwatermark {
    public static void main(String[] args) {
        //创建PdfDocument类的对象
        PdfDocument pdf = new PdfDocument();
        //加载测试文档
        pdf.loadFromFile("test.pdf");

        //获取测试文档中的第一页
        PdfPageBase page = pdf.getPages().get(0);

        //调用insertWatermark()方法添加文本水印
        insertWatermark(page, "TOP SECRET");
        //保存文档
        pdf.saveToFile("out/textWaterMark.pdf");
    }

    static void insertWatermark(PdfPageBase page, String watermark) {
        Dimension2D dimension2D = new Dimension();
        dimension2D.setSize(page.getCanvas().getClientSize().getWidth() / 5, page.getCanvas().getClientSize().getHeight() / 5);
        PdfTilingBrush brush = new PdfTilingBrush(dimension2D);
        brush.getGraphics().setTransparency(0.4F);
        brush.getGraphics().save();
        brush.getGraphics().translateTransform((float) brush.getSize().getWidth() / 5, (float) brush.getSize().getHeight() / 5);    
        brush.getGraphics().rotateTransform(-45);
        brush.getGraphics().drawString(watermark, new PdfFont(PdfFontFamily.Helvetica, 15), PdfBrushes.getViolet(), 0 , 0 , new PdfStringFormat(PdfTextAlignment.Center));
        brush.getGraphics().restore();
        brush.getGraphics().setTransparency(1);
        Rectangle2D loRect = new Rectangle2D.Float();
        loRect.setFrame(new Point2D.Float(0, 0), page.getCanvas().getClientSize());
        page.getCanvas().drawRectangle(brush, loRect);
    }
}

文本水印效果:
Java 处理PDF文档(一):页眉页脚、水印、背景、附件_第4张图片
2.图片水印

import com.spire.pdf.*;
import java.awt.geom.Rectangle2D;

public class Imgwatermark {

    public static void main(String[] args) {

        //实例化PdfDocument类的对象,并加载测试文档
        PdfDocument doc = new PdfDocument();
        doc.loadFromFile("test.pdf");

        //获取文档第1页
        PdfPageBase page = doc.getPages().get(0);  

        //加载图片,设置为背景水印
        page.setBackgroundImage("logo.png");

        //指定水印在文档中的位置及图片大小
        Rectangle2D.Float rect = new Rectangle2D.Float();
        rect.setRect(150, 150, 300, 150);
        page.setBackgroundRegion(rect);

        //保存文档 
        doc.saveToFile("output/imageWaterMark.pdf");
        doc.close();
    }
}

图片水印添加效果:
Java 处理PDF文档(一):页眉页脚、水印、背景、附件_第5张图片

【示例3】添加背景色

1.添加纯色背景色

import com.spire.pdf.PdfDocument;
import com.spire.pdf.PdfPageBase;

import java.awt.*;

public class SetBackgroundColor1 {
    public static void main(String[] args) {
        //加载PDF文档
        PdfDocument doc = new PdfDocument();
        doc.loadFromFile("test.pdf");

        PdfPageBase page;
        //获取文档的总页数
        int pageCount = doc.getPages().getCount();

        //遍历页面,设置背景颜色
        for(int i = 0; i < pageCount; i ++) {
            page = doc.getPages().get(i);
            page.setBackgroundColor(Color.yellow);
        }

        //保存文档
        doc.saveToFile("BackgroundColor.pdf");
    }
}

纯色背景色效果:
Java 处理PDF文档(一):页眉页脚、水印、背景、附件_第6张图片
2.添加图片背景

import com.spire.pdf.PdfDocument;
import com.spire.pdf.PdfPageBase;

public class SetBackgroundColor2 {
    public static void main(String[] args) {
        //加载PDF文档
        PdfDocument doc = new PdfDocument();
        doc.loadFromFile("test.pdf");

        PdfPageBase page;
        //获取文档的总页数
        int pageCount = doc.getPages().getCount();

        //遍历页面,设置背景图片
        for(int i = 0; i < pageCount; i ++) {
            page = doc.getPages().get(i);
            page.setBackgroundImage("tp.png");
        }

        //保存文档
        doc.saveToFile("BackgroundImage2.pdf");
    }
}

图片背景色效果:
Java 处理PDF文档(一):页眉页脚、水印、背景、附件_第7张图片

【示例4】添加附件

import com.spire.pdf.PdfDocument;
import com.spire.pdf.annotations.*;
import com.spire.pdf.attachments.PdfAttachment;
import com.spire.pdf.graphics.*;

import java.awt.*;
import java.awt.geom.Dimension2D;
import java.awt.geom.Rectangle2D;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;

public class AttachFiles {

    public static void main(String[] args) throws IOException {

        //实例化PdfDocument类的对象
        PdfDocument doc = new PdfDocument();

        //加载需要添加附件的PDF文档
        doc.loadFromFile("test.pdf");

        //加载附件文档(Excel)并作为附件添加到PDF
        PdfAttachment attachment = new PdfAttachment("Sample.xlsx");
        doc.getAttachments().add(attachment);

        //在PDF页面指定位置绘制标签
        String label = "TestReport.docx";
        PdfTrueTypeFont font = new PdfTrueTypeFont(new Font("Arial", Font.BOLD, 14));
        double x = 40;
        double y = doc.getPages().get(0).getActualSize().getHeight() -800;
        doc.getPages().get(0).getCanvas().drawString(label, font, PdfBrushes.getOrange(), x, y);

        //以注释的形式添加附件到PDF
        String filePath = "测试文档.docx";
        byte[] data = toByteArray(filePath);
        Dimension2D size = font.measureString(label);
        Rectangle2D bound = new Rectangle2D.Float((float) (x + size.getWidth() + 3), (float) y, 10, 15);
        PdfAttachmentAnnotation annotation = new PdfAttachmentAnnotation(bound, filePath, data);
        annotation.setColor(new PdfRGBColor(new Color(0, 128, 128)));
        annotation.setFlags(PdfAnnotationFlags.Default);
        annotation.setIcon(PdfAttachmentIcon.Graph);
        annotation.setText("点击打开测试报告文档.docx");
        doc.getPages().get(0).getAnnotationsWidget().add(annotation);

        //保存文档
        doc.saveToFile("Attachments.pdf");
    }

    //读取文件到byte数组
    public static byte[] toByteArray(String filePath) throws IOException {

        File file = new File(filePath);
        long fileSize = file.length();
        if (fileSize > Integer.MAX_VALUE) {
            System.out.println("file too big...");
            return null;
        }
        FileInputStream fi = new FileInputStream(file);
        byte[] buffer = new byte[(int) fileSize];
        int offset = 0;
        int numRead = 0;
        while (offset < buffer.length
                && (numRead = fi.read(buffer, offset, buffer.length - offset)) >= 0) {
            offset += numRead;
        }

        if (offset != buffer.length) {
            throw new IOException("Could not completely read file "
                    + file.getName());
        }
        fi.close();
        return buffer;
    }
}

附件添加效果:
Java 处理PDF文档(一):页眉页脚、水印、背景、附件_第8张图片

以上是本次关于Java操作PDF文档代码示例。

关于Java 加密、解密PDF文档,请参阅这篇文章;
关于Java 合并、拆分PDF文档,请参阅这篇文章。