IText實現對PDF文檔屬性的基本設置

一、Itext簡介

iText是著名的開放源碼的站點sourceforge一個項目，是用於生成PDF文檔的一個java類庫。通過iText不僅可以生成PDF或rtf的文檔，而且可以將XML、Html文件轉化為PDF文件。

iText的安裝非常方便，在http://www.lowagie.com/iText/download.html網站上下載iText.jar文件后，只需要在系統的CLASSPATH中加入iText.jar的路徑，在程序中就可以使用iText類庫了。

二、生成PDF步驟

1、創建文檔對象實例

Document document = new Document();

2、建立書寫器（Writer）與文檔對象（document）關聯，通過書寫器將文檔寫入磁盤

PdfWriter writer = PdfWriter.getInstance(document, new FileOutputStream(DEST));

DEST：生成PDF文件

3、打開文檔

document.open();

4、向文檔中添加內容

document.add(new Paragraph("PDF demo")); 

5、關閉文檔

document.close();

三、具體分析

1、對象實例

public document();

public document(Rectangle pageSize);

public document(Rectangle pageSize, int marginLeft, int marginRight, int marginTop, int marginBottom);

pageSize是指文檔頁面大小，public document();頁面大小為A4，效果等同於Document(PageSize.A4);

marginLeft、marginRight、marginTop、marginBottom分別為左、右、上、下的頁邊距。

通過參數pageSize可以設定頁面大小、面背景色、以及頁面橫向/縱向等屬性。iText定義了A0-A10、AL、LETTER、HALFLETTER、_11x17、LEDGER、NOTE、B0-B5、ARCH_A-ARCH_E、FLSA和FLSE等紙張類型，也可以通過Rectangle pageSize = new Rectangle(144, 720);自定義紙張。通過Rectangle方法rotate()可以將頁面設置成橫向。

2、書寫器對象

一旦文檔(document)對象建立好之后，需要建立一個或多個書寫器(Writer)對象與之關聯。通過書寫器(Writer)對象可以將具體文檔存盤成需要的格式。

PDFWriter可以將文檔存成PDF文件；HtmlWriter可以將文檔存成html文件

3、文檔屬性

在文檔打開之前，可以設定文檔的標題、主題、作者、關鍵字、裝訂方式、創建者、生產者、創建日期等屬性，調用的方法分別是：

public boolean addTitle(String title) 
public boolean addSubject(String subject) 
public boolean addKeywords(String keywords) 
public boolean addAuthor(String author) 
public boolean addCreator(String creator) 
public boolean addProducer() 
public boolean addCreationDate() 
public boolean addHeader(String name, String content)

其中方法addHeader對於PDF文檔無效，addHeader僅對html文檔有效，用於添加文檔的頭信息。

當新的頁面產生之前，可以設定頁面的大小、書簽、腳注（HeaderFooter）等信息，調用的方法是：

public boolean setPageSize(Rectangle pageSize) 
public boolean add(Watermark watermark) 
public void removeWatermark() 
public void setHeader(HeaderFooter header) 
public void resetHeader() 
public void setFooter(HeaderFooter footer) 
public void resetFooter() 
public void resetPageCount() 
public void setPageCount(int pageN)

如果要設定第一面的頁面屬性，這些方法必須在文檔打開前調用。

對於PDF文檔，iText還提供了文檔的顯示屬性，通過調用書寫器的 setViewerPreferences方法可以控制文檔打開時Acrobat Reader的顯示屬性，如是否單頁顯示、是否全屏顯示、是否隱藏狀態條等屬性。

另外，iText也提供了對PDF文件的安全保護，通過書寫器（Writer）的setEncryption方法，可以設定文檔的用戶口令、只讀、可打印等屬性。

4、添加文檔內容

所有向文檔添加的內容都是以對象為單位的，如Phrase、Paragraph、Table、Graphic對象等。比較常用的是段落(Paragraph)對象，用於向文檔中添加一段文字。

IText中用文本塊(Chunk)、短語(Phrase)和段落(paragraph)處理文本。文本塊(Chunk)是處理文本的最小單位，有一串帶格式（包括字體、顏色、大小）的字符串組成。如以下代碼就是產生一個字體為HELVETICA、大小為10、帶下划線的字符串：

Chunk chunk1 = new Chunk("This text is underlined", 
               FontFactory.getFont(FontFactory.HELVETICA, 12, Font.UNDERLINE)); 

短語(Phrase)由一個或多個文本塊(Chunk)組成，短語(Phrase)也可以設定字體，但對於其中以設定過字體的文本塊(Chunk)無效。通過短語(Phrase)成員函數add可以將一個文本塊(Chunk)加到短語(Phrase)中，如：phrase6.add(chunk);

段落(paragraph)由一個或多個文本塊(Chunk)或短語(Phrase)組成，相當於WORD文檔中的段落概念，同樣可以設定段落的字體大小、顏色等屬性。另外也可以設定段落的首行縮進、對齊方式（左對齊、右對齊、居中對齊）。通過函數setAlignment可以設定段落的對齊方式，setAlignment的參數1為居中對齊、2為右對齊、3為左對齊，默認為左對齊。

Itext中處理表格在有PDFTable，Table。對於簡單在表格處理可以用Table，但如果要處理復雜的表格就需要PDFTable進行處理。

創建表格時，必須要指定列，行則不是必須的。

建立表格之后，可以設定表格的屬性，如：邊框寬度、邊框顏色、襯距（padding space 即單元格之間的間距）大小等屬性。

IText中處理圖像的類為Image，目前iText支持的圖像格式有：GIF, Jpeg, PNG, wmf等格式，對於不同的圖像格式，iText用同樣的構造函數自動識別圖像格式。通過下面的代碼分別獲得gif、jpg、png圖像的實例。

Image gif = Image.getInstance("vonnegut.gif"); 
Image jpeg = Image.getInstance("myKids.jpg"); 
Image png = Image.getInstance("hitchcock.png");

圖像的位置 
圖像的位置主要是指圖像在文檔中的對齊方式、圖像和文本的位置關系。IText中通過函數public void setAlignment(int alignment)進行處理，參數alignment為Image.RIGHT、Image.MIDDLE、Image.LEFT分別指右對齊、居中、左對齊；當參數alignment為Image.TEXTWRAP、Image.UNDERLYING分別指文字繞圖形顯示、圖形作為文字的背景顯示。這兩種參數可以結合以達到預期的效果，如setAlignment(Image.RIGHT|Image.TEXTWRAP)顯示的效果為圖像右對齊，文字圍繞圖像顯示。

圖像的尺寸和旋轉 
如果圖像在文檔中不按原尺寸顯示，可以通過下面的函數進行設定：

public void scaleAbsolute(int newWidth, int newHeight) 

public void scalePercent(int percent) 

public void scalePercent(int percentX, int percentY)

函數public void scaleAbsolute(int newWidth, int newHeight)直接設定顯示尺寸；

函數public voidscalePercent(int percent)設定顯示比例，如scalePercent(50)表示顯示的大小為原尺寸的50%；

而函數scalePercent(int percentX, int percentY)則圖像高寬的顯示比例。 

如果圖像需要旋轉一定角度之后在文檔中顯示，可以通過函數public void setRotation(double r)設定，參數r為弧度，如果旋轉角度為30度，則參數r= Math.PI/6。

 四、中文處理

默認的iText字體設置不支持中文字體，需要下載遠東字體包iTextAsian.jar，否則不能往PDF文檔中輸出中文字體。通過下面的代碼就可以在文檔中使用中文了：

BaseFont bfChinese = BaseFont.createFont("STSong-Light", "UniGB-UCS2-H", BaseFont.NOT_EMBEDDED);

或者

BaseFont bfChinese = BaseFont.createFont("C:/Windows/Fonts/simhei.ttf",BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);、

注意：此處大小寫敏感！例如宋體的英文名稱是SimSun(注意不是simsun！，首字母都是大寫的)

      錯誤寫法：font-family:宋體 或者  font-family:simsun

      正確寫法：font-family:SimSun 或者 font-family:SimHei

　　確保上述所有字體均通過addFont加入，字體名稱錯誤或者字體不存在會拋出異常，很方便，但是沒導入的字體不會有任何提示。

五、例子

 1、IText添加水印，並且增加權限

@Test
    public void addWaterMark() throws Exception{
        String srcFile="D:\\work\\pdf\\win10.pdf";//要添加水印的文件  
        String text="系統集成公司";//要添加水印的內容
          int textWidth=200;
          int textHeight=440;
          PdfReader reader = new PdfReader(srcFile);// 待加水印的文件
          PdfStamper stamper = new PdfStamper(reader, new FileOutputStream(new File("D:\\work\\pdf\\addWaterMark.pdf")));// 加完水印的文件
//          byte[] userPassword = "123".getBytes();
          byte[] ownerPassword = "12345".getBytes();
//          int permissions = PdfWriter.ALLOW_COPY|PdfWriter.ALLOW_MODIFY_CONTENTS|PdfWriter.ALLOW_PRINTING;
//          stamper.setEncryption(null, ownerPassword, permissions,false);
          stamper.setEncryption(null, ownerPassword, PdfWriter.ALLOW_ASSEMBLY, false);
          stamper.setEncryption(null, ownerPassword, PdfWriter.ALLOW_COPY, false);
          stamper.setEncryption(null, ownerPassword, PdfWriter.ALLOW_DEGRADED_PRINTING, false);
          stamper.setEncryption(null, ownerPassword, PdfWriter.ALLOW_FILL_IN, false);
          stamper.setEncryption(null, ownerPassword, PdfWriter.ALLOW_MODIFY_ANNOTATIONS, false);
          stamper.setEncryption(null, ownerPassword, PdfWriter.ALLOW_MODIFY_CONTENTS, false);
          stamper.setEncryption(null, ownerPassword, PdfWriter.ALLOW_PRINTING, false);
          stamper.setEncryption(null, ownerPassword, PdfWriter.ALLOW_SCREENREADERS, false);
          stamper.setEncryption(null, ownerPassword, PdfWriter.DO_NOT_ENCRYPT_METADATA, false);
          stamper.  setViewerPreferences(PdfWriter.HideToolbar|PdfWriter.HideMenubar);
//          stamper.setViewerPreferences(PdfWriter.HideWindowUI);
          int total = reader.getNumberOfPages() + 1;
          PdfContentByte content;
          BaseFont font = BaseFont.createFont("font/SIMKAI.TTF", BaseFont.IDENTITY_H, BaseFont.EMBEDDED);
          for (int i = 1; i < total; i++)// 循環對每頁插入水印
          {
            content = stamper.getUnderContent(i);// 水印的起始
            content.beginText();// 開始
            content.setColorFill(BaseColor.GREEN);// 設置顏色 默認為藍色
            content.setFontAndSize(font, 38);// 設置字體及字號
            content.setTextMatrix(textWidth, textHeight);// 設置起始位置
            content.showTextAligned(Element.ALIGN_LEFT, text, textWidth, textHeight, 45);// 開始寫入水印
            content.endText();
            }
            stamper.close();
    }

2、IText添加書簽

        Document document = new Document(PageSize.A4);

        BaseFont bfCN =
                BaseFont.createFont("C:/Windows/Fonts/simhei.ttf",BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);
        // 章的字體
        Font chFont = new Font(bfCN, 12, Font.NORMAL, BaseColor.BLUE);
        // 節的字體
        Font secFont = new Font(bfCN, 12, Font.NORMAL, new BaseColor(0, 204,
                255));
        // 正文的字體
        Font textFont = new Font(bfCN, 12, Font.NORMAL, BaseColor.BLACK);

        PdfWriter.getInstance(document, new FileOutputStream(DEST));
        document.open();

        int chNum = 1;
        Chapter chapter = new Chapter(new Paragraph("Michael介紹", chFont),
                chNum++);

        Section section = chapter.addSection(new Paragraph("基本信息", secFont));
        section.setIndentation(10);
        section.setIndentationLeft(10);
        section.setBookmarkOpen(true);
        section.setNumberStyle(Section.NUMBERSTYLE_DOTTED_WITHOUT_FINAL_DOT);
        section.add(new Paragraph("苦逼的碼農一枚。。。", textFont));

        Section section2 = chapter.addSection(new Paragraph("SNS", secFont));
        section2.setIndentation(10);
        section2.setIndentationLeft(10);
        section2.setBookmarkOpen(false);
        section2.setNumberStyle(Section.NUMBERSTYLE_DOTTED_WITHOUT_FINAL_DOT);
        section2.add(new Paragraph("SNS地址分類：", textFont));

        section = section2.addSection(new Paragraph(new Chunk("我的博客", secFont)
                .setUnderline(0.2f, -2f).setAnchor("http://www.cnblogs.com/xiaoSY-learning")));
        section.setBookmarkOpen(false);
        section.setIndentation(10);
        section.setIndentationLeft(10);
        section.setNumberStyle(Section.NUMBERSTYLE_DOTTED_WITHOUT_FINAL_DOT);
        section.add(new Paragraph(new Chunk("我的blog地址：http://www.cnblogs.com/xiaoSY-learning/",
                textFont).setUnderline(0.2f, -2f).setAnchor(
                "http://www.cnblogs.com/xiaoSY-learning/")));
        section.add(new Paragraph("分享自己的技術心得。", textFont));

        section = section2.addSection(new Paragraph(new Chunk("我的weibo",
                secFont).setUnderline(0.2f, -2f).setAnchor(
                "http://weibo.com/u/2772113512")));
        section.setIndentation(10);
        section.setIndentationLeft(10);
        section.setBookmarkOpen(false);
        section.setNumberStyle(Section.NUMBERSTYLE_DOTTED_WITHOUT_FINAL_DOT);
        section.add(new Paragraph(new Chunk("我的weibo：http://weibo.com/u/2772113512",
                textFont).setUnderline(0.2f, -2f).setAnchor(
                "http://weibo.com/u/2772113512")));
        section.add(new Paragraph("發表下心情，分享下技術，轉轉亂七八糟的新聞。", textFont));

        section = section2.addSection(new Paragraph(new Chunk("twitter",
                secFont)));
        section.setIndentation(10);
        section.setIndentationLeft(10);
        section.setBookmarkOpen(false);
        section.setNumberStyle(Section.NUMBERSTYLE_DOTTED_WITHOUT_FINAL_DOT);
        section.add(new Paragraph(new Chunk("twitter：@suncto", textFont)
                .setUnderline(0.2f, -2f).setAnchor("twitter：twitter：twitter：")));
        section.add(new Paragraph("一個常常被牆的地方", textFont));

        LineSeparator line = new LineSeparator(1, 100, new BaseColor(204, 204,
                204), Element.ALIGN_CENTER, -2);

        Paragraph p_line = new Paragraph("分割線");
        p_line.add(line);
        chapter.add(p_line);
        document.add(chapter);

        chapter = new Chapter(new Paragraph("Miu的介紹", chFont), chNum++);
        section = chapter.addSection(new Paragraph("基本信息", secFont));
        section.setIndentation(10);
        section.setIndentationLeft(10);
        section.setBookmarkOpen(false);
        section.setNumberStyle(Section.NUMBERSTYLE_DOTTED_WITHOUT_FINAL_DOT);
        section.add(new Paragraph("90后一枚，喜歡美食和旅游。。。", textFont));

        document.add(chapter);

        document.close();

3、IText創建PDF

import java.io.File;
import java.io.FileOutputStream;
import java.io.OutputStream;
import java.util.Date;

import com.itextpdf.text.Document;
import com.itextpdf.text.Paragraph;
import com.itextpdf.text.pdf.PdfWriter;

public class PDFJiemi {

    private static String USER_PASS = "Hello123";

    private static String OWNER_PASS = "Owner123";

    public static void main(String[] args) {

        try {

            OutputStream file = new FileOutputStream(new File("E:\\pdfile\\NeedToDo\\Jiemi\\Test2.pdf"));

            Document document = new Document();
            PdfWriter writer = PdfWriter.getInstance(document, file);

            writer.setEncryption(USER_PASS.getBytes(), OWNER_PASS.getBytes(),
                  PdfWriter.ALLOW_PRINTING, PdfWriter.ENCRYPTION_AES_128);

            document.open();
            document.add(new Paragraph("Hello World, iText"));
            document.add(new Paragraph(new Date().toString()));

            document.close();
            file.close();

        } catch (Exception e) {

            e.printStackTrace();
        }
        System.out.println("OK.");
    }
}

4、附上PDFBox判斷PDF文檔是否加密

import java.io.File;
import java.io.IOException;

import org.apache.pdfbox.pdmodel.PDDocument;

public class PDFIsEncrypted {

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

        PDDocument pdf = PDDocument.load(new File("E:\\pdfile\\NeedToDo\\Jiemi\\addWaterTest.pdf")); 

        System.out.println("isEncrypted : " + pdf.isEncrypted());
    }

}

 5、IText破解加密PDF文檔

import java.io.File;
import java.io.FileOutputStream;
import java.io.OutputStream;

import com.itextpdf.text.Document;
import com.itextpdf.text.Rectangle;
import com.itextpdf.text.pdf.PdfContentByte;
import com.itextpdf.text.pdf.PdfImportedPage;
import com.itextpdf.text.pdf.PdfReader;
import com.itextpdf.text.pdf.PdfWriter;

public class DeEncrypt {

    public static void main(String[] args) throws Exception {
        String srcFile = "E:\\pdfile\\NeedToDo\\Jiemi\\addWaterTest.pdf";
        String dstFile = "E:\\pdfile\\NeedToDo\\Jiemi\\DeEncryption.pdf";
        deletePDFEncrypt(srcFile, dstFile);
        System.out.println("OK.");
    }
    
    private static void deletePDFEncrypt(String sourceFullName, String newFullName) throws Exception
    {
        if (sourceFullName == null || sourceFullName.isEmpty() || sourceFullName.length() == 0)
        {
            throw new Exception("源文件路徑為空或null.");
        }
        try
        {
            // 創建一個PdfReader對象
            PdfReader reader = new PdfReader(sourceFullName);
            PdfReader.unethicalreading = true;
            // 獲得第一頁的大小
            Rectangle pagesize = reader.getPageSize(1);
            float width = pagesize.getWidth();
            float height = pagesize.getHeight();
            // 創建一個文檔變量
            OutputStream file = new FileOutputStream(new File(newFullName));
            Document document = new Document(pagesize, 50, 50, 50, 50);
            // 創建該文檔
            PdfWriter writer = PdfWriter.getInstance(document, file);
            // 打開文檔
            document.open();
            // 添加內容
            PdfContentByte cb = writer.getDirectContent();
            PdfImportedPage page;
            int currentPageNumber = 0;
            int pageOfCurrentReaderPDF  = 0;
            // Create a new page in the target for each source page.
            while (pageOfCurrentReaderPDF < reader.getNumberOfPages())
            {
                pageOfCurrentReaderPDF++;
                currentPageNumber++;
                page = writer.getImportedPage(reader, pageOfCurrentReaderPDF);
                document.setPageSize(new Rectangle(page.getWidth(), page.getHeight()));
                document.newPage();
                cb.addTemplate(page, 0, 0);
            }
            // 關閉文檔
            document.close();
        }
        catch (Exception ex)
        {
            ex.printStackTrace();
        }
    }

}