PDF轉(zhuǎn)換常識(shí)：PDF/X、PDF/E和PDF/A三者區(qū)別

https://github.com/itext/i7js-examples
https://github.com/itext/i7js-jumpstart
iText是著名的開(kāi)放源碼的站點(diǎn)sourceforge一個(gè)項(xiàng)目，是用于生成PDF文檔的一個(gè)java類庫(kù)。通過(guò)iText不僅可以生成PDF或rtf的文檔，而且可以將XML、Html文件轉(zhuǎn)化為PDF文件。 iText的安裝非常方便，下載iText.jar文件后，只需要在系統(tǒng)的CLASSPATH中加入iText.jar的路徑，在程序中就可以使用iText類庫(kù)了。

iText 的需求分析

一般情況下，iText使用在有以下一個(gè)要求的項(xiàng)目中：

內(nèi)容無(wú)法提前利用：取決于用戶的輸入或?qū)崟r(shí)的數(shù)據(jù)庫(kù)信息。

由于內(nèi)容，頁(yè)面過(guò)多，PDF文檔不能手動(dòng)生成。

文檔需在無(wú)人參與，批處理模式下自動(dòng)創(chuàng)建。

內(nèi)容被定制或個(gè)性化；例如，終端客戶的名字需要標(biāo)記在大量的頁(yè)面上。

依賴：

<properties><maven.compiler.source>8</maven.compiler.source><maven.compiler.target>8</maven.compiler.target><itext.version>7.1.11</itext.version></properties><dependencies><!-- itext7 --><dependency><groupId>com.itextpdf</groupId><artifactId>kernel</artifactId><version>${itext.version}</version></dependency><dependency><groupId>com.itextpdf</groupId><artifactId>io</artifactId><version>${itext.version}</version></dependency><dependency><groupId>com.itextpdf</groupId><artifactId>layout</artifactId><version>${itext.version}</version></dependency><dependency><groupId>com.itextpdf</groupId><artifactId>forms</artifactId><version>${itext.version}</version></dependency><dependency><groupId>com.itextpdf</groupId><artifactId>pdfa</artifactId><version>${itext.version}</version></dependency><dependency><groupId>com.itextpdf</groupId><artifactId>pdftest</artifactId><version>${itext.version}</version></dependency><dependency><groupId>com.itextpdf</groupId><artifactId>font-asian</artifactId><version>${itext.version}</version></dependency><dependency><groupId>org.slf4j</groupId><artifactId>slf4j-log4j12</artifactId><version>1.7.18</version></dependency><!--itext7 html轉(zhuǎn)pdf用到的包--><dependency><groupId>com.itextpdf</groupId><artifactId>html2pdf</artifactId><version>3.0.0</version></dependency></dependencies>

解決中文不顯示的問(wèn)題

PdfFont font = PdfFontFactory.createFont("STSongStd-Light", "UniGB-UCS2-H", false);

PdfWriter

PdfWriter 構(gòu)造方法

//創(chuàng)建一個(gè)pdfrwriter寫(xiě)入傳遞的文件名 使用默認(rèn)的屬性。 public PdfWriter(String filename) throws FileNotFoundException//使用傳遞的屬性 public PdfWriter(String filename, WriterProperties properties) throws FileNotFoundException

PdfWriter常用方法

WriterProperties

PdfDocument

PDF文檔的主要輸入點(diǎn)

在 PDF 中，所有測(cè)量均以用戶單位完成。默認(rèn)情況下，一個(gè)用戶單位對(duì)應(yīng)一個(gè)點(diǎn)。這意味著一英寸中有 72 個(gè)用戶單位。

如果使用PageSize對(duì)象創(chuàng)建頁(yè)面大小，則坐標(biāo)系的原點(diǎn)位于頁(yè)面的左下角。

PdfDocument 構(gòu)造方法

//以寫(xiě)入模式打開(kāi)PDF文檔。文檔初始化時(shí)沒(méi)有頁(yè)面。 public PdfDocument(PdfWriter writer)public PdfDocument(PdfWriter writer, DocumentProperties properties)

PdfDocument 常用方法

// 按頁(yè)獲取頁(yè)號(hào) public int getPageNumber(PdfPage page)//創(chuàng)建并添加具有指定頁(yè)面大小的新頁(yè)面 public PdfPage addNewPage(PageSize pageSize)

PdfPage

// 獲取由媒體框?qū)ο蠖x的頁(yè)面大小。這個(gè)方法沒(méi)有考慮頁(yè)面旋轉(zhuǎn) public Rectangle getPageSize()//獲取此頁(yè)面資源的PdfResources包裝器對(duì)象。如果頁(yè)面沒(méi)有資源對(duì)象，那么它將從 //頁(yè)面的父節(jié)點(diǎn)繼承。如果父類和頁(yè)面都沒(méi)有資源對(duì)象，則創(chuàng)建新的資源對(duì)象并將其添加到頁(yè)面字典中 public PdfResources getResources()// 獲取由頁(yè)面的媒體框指定的Rectangle對(duì)象，該對(duì)象定義顯示或打印頁(yè)面的物理媒體的邊界 public Rectangle getMediaBox()

PdfDictionary

PDF規(guī)范中描述的Dictionary的表示。Dictionary是鍵和值之間的映射。鍵是 PdfNames，值是 PdfObjects。每個(gè)鍵只能與一個(gè)值關(guān)聯(lián)，向現(xiàn)有鍵添加新值將覆蓋之前的值。當(dāng)PdfDocument關(guān)閉時(shí)，null值應(yīng)該被忽略。

PdfResources

表示資源字典的包裝器類——定義內(nèi)容流操作符使用的命名資源。(ISO 32000-1, 7.8.3資源字典)

Document

在創(chuàng)建自給自足的PDF時(shí)，Document是默認(rèn)的根元素。它主要操作高級(jí)的操作，如設(shè)置頁(yè)面大小和旋轉(zhuǎn)，添加元素，在特定的坐標(biāo)寫(xiě)文本。它不了解實(shí)際的PDF概念和語(yǔ)法。

文檔的渲染行為可以通過(guò)擴(kuò)展 DocumentRenderer 和使用setRenderer(DocumentRenderer)設(shè)置一個(gè)新創(chuàng)建的實(shí)例來(lái)修改。

Document 構(gòu)造方法

//從PdfDocument創(chuàng)建文檔。使用PdfDocument的當(dāng)前默認(rèn)PageSize初始化第一頁(yè)。 //默認(rèn)頁(yè)面大小為 A4，默認(rèn)情況下該頁(yè)面用于縱向 public Document(PdfDocument pdfDoc)public Document(PdfDocument pdfDoc, PageSize pageSize)

Document 常用方法

// 在運(yùn)行時(shí)更改DocumentRenderer。使用它來(lái)定制文檔的IRenderer行為。 public void setRenderer(DocumentRenderer documentRenderer)

PdfFont 類

PdfFontFactory 類

提供了一些有用的方法來(lái)創(chuàng)建準(zhǔn)備在PdfDocument中使用的字體
注意，剛創(chuàng)建的PdfFont在刷新之前幾乎是空的，因?yàn)樵谒⑿轮安豢赡軐?shí)現(xiàn)字體數(shù)據(jù)。

PdfFontFactory 常用方法

//根據(jù)字體程序文件的路徑創(chuàng)建一個(gè)PdfFont實(shí)例 //fontProgram 字體程序文件 //encoding 要?jiǎng)?chuàng)建的字體的編碼 //embedded 指示是否將字體嵌入到目標(biāo)文檔中 public static PdfFont createFont(String fontProgram, String encoding, boolean embedded)public static PdfFont createFont(String fontProgram)

StandardFonts 類

BlockElement

BlockElement會(huì)盡量在畫(huà)布或頁(yè)面上占用盡可能多的水平空間。這個(gè)概念類似于HTML中的塊元素。與HTML一樣，對(duì)象的可視表示也可以通過(guò)填充、邊框和/或邊距來(lái)分隔(padding, a border, and/or a margin)

Table

public class Table extends BlockElement<Table> implements ILargeElement
Table是一個(gè)布局元素，它表示二維網(wǎng)格中的數(shù)據(jù)。它充滿了按行和列排序的單元格。
它是ILargeElement的一個(gè)實(shí)現(xiàn)，這意味著它可以被刷新到畫(huà)布上，以便回收被鎖定的內(nèi)存。

Table 構(gòu)造函數(shù)

//構(gòu)造一個(gè)具有最佳列寬的表 //從7.0.2開(kāi)始，介紹了表布局算法。自動(dòng)布局是默認(rèn)設(shè)置。 //注意，最終的列寬度取決于所選布局、表寬度、單元格寬度、單元格最小寬度和單元 //格最大寬度。表布局算法具有與CSS表布局屬性相同的行為，其中columnwidth是 //<colgroup>' width。更多信息請(qǐng)參見(jiàn)setAutoLayout()和setFixedLayout()。 public Table(float[] pointColumnWidths)

Table 常用方法

//設(shè)置自動(dòng)布局。類似于CSS屬性 autotable-layout:auto 。注意，大表不支持自動(dòng)布局。 //算法的原則。 //1. 列寬度不能小于列中任何單元格的最小寬度(按布局計(jì)算)。 //2. 指定的表寬度優(yōu)先級(jí)高于列和單元格寬度的和。 //3. 單元格和列寬的百分比值優(yōu)先級(jí)高于點(diǎn)值。 //4. 單元格寬度比列寬度具有更高的優(yōu)先級(jí)。 //5. 如果列沒(méi)有寬度，它將嘗試達(dá)到max-value(根據(jù)布局計(jì)算)。 public Table setAutoLayout()//設(shè)置固定布局。類似的CSS屬性 table-layout:fixed 。注意，表格必須有寬度屬性，否則將使用自動(dòng)布局。 public Table setFixedLayout()//向表的標(biāo)題中添加一個(gè)新單元格。標(biāo)題將顯示在該表的每個(gè)區(qū)域的頂部。參見(jiàn) //setSkipFirstHeader(boolean) public Table addHeaderCell(Cell headerCell)//跳過(guò)第一個(gè)標(biāo)題的打印。當(dāng)連續(xù)打印屬于同一打印表方面的表時(shí)使用 public Table setSkipFirstHeader(boolean skipFirstHeader)

UnitValue

保存值和度量值的單位的專門(mén)化類。

UnitValue 常用方法

// 創(chuàng)建一個(gè)指定值的UnitValue PERCENT對(duì)象。 public static UnitValue createPercentValue(float value)

Cell

單元格是一個(gè)封閉網(wǎng)格(Table)中的一段數(shù)據(jù)。這個(gè)對(duì)象是一個(gè)BlockElement，賦予它許多視覺(jué)布局屬性。一個(gè)單元格可以作為許多布局元素的容器;它只能包含其他BlockElement對(duì)象或圖像。其他類型的布局元素必須包裝在一個(gè)BlockElement。

Cell 常用方法

// 將任何塊元素添加到單元格的內(nèi)容 public Cell add(IBlockElement element)

Paragraph

表示文本和圖形信息的自包含塊的布局元素。它是一個(gè)BlockElement，本質(zhì)上是一個(gè)葉子元素的容器。

Paragraph 構(gòu)造方法

//創(chuàng)建一個(gè)段落，初始化為一段文本 public Paragraph(String text)public Paragraph(Text text)

Paragraph 常用方法

IElement

這個(gè)類代表了一個(gè)布局元素，即在畫(huà)布或文檔中占據(jù)“物理”空間的內(nèi)容塊。它的存在和定位可能會(huì)影響其他ielement在布局表面上的位置。

IElement 常用方法

// 覆蓋下一次調(diào)用getRenderer()將返回的IRenderer實(shí)例。 void setNextRenderer(IRenderer renderer)//獲取此元素的渲染器。注意，這個(gè)方法可以被多次調(diào)用。默認(rèn)情況下，每個(gè)元素都應(yīng) //該定義自己的渲染器，但是這個(gè)渲染器可以被setNextRenderer(IRenderer)方法調(diào)用覆蓋。 IRenderer getRenderer();//在當(dāng)前元素中創(chuàng)建一個(gè)帶有根的渲染器子樹(shù)。 //與getRenderer()相比，此方法返回的渲染器應(yīng)該包含當(dāng)前元素的子元素的所有子渲染器。 IRenderer createRendererSubTree()

ILeafElement

public interface ILeafElement extends IElement
IElement的標(biāo)記子接口，它指定布局對(duì)象定義在對(duì)象層次結(jié)構(gòu)的最低層上。葉子元素不能作為其他元素的容器。

RootElement

PDF布局對(duì)象層次結(jié)構(gòu)的通用抽象根元素。

RootElement 常用方法

//方便的方法來(lái)編寫(xiě)圍繞指定點(diǎn)對(duì)齊的文本 public T showTextAligned(Paragraph p, float x, float y, int pageNumber, TextAlignment textAlign, VerticalAlignment vertAlign, float radAngle)

Text

文本是一段任意長(zhǎng)度的文本。作為一個(gè)葉子元素，它是包含特定布局屬性的最小內(nèi)容塊

Text 構(gòu)造方法

Text 常用方法

IAccessibleElement

布局元素具有可訪問(wèn)性屬性。它們定義元素的角色(AccessibilityProperties.getRole())——如果元素被添加到Tagged PDF文檔中，將使用這個(gè)名稱來(lái)標(biāo)記元素。它們還可以為標(biāo)記定義其他元數(shù)據(jù)。

Image

一個(gè)布局元素，它表示要包含在文檔模型中的圖像。

Image 構(gòu)造方法

//使用iText I/O模塊從一個(gè)文件中讀取圖像資源，創(chuàng)建一個(gè)圖像。 public Image(ImageData img)

Image 常用方法

ImageDataFactory

ImageDataFactory 常用方法

//創(chuàng)建一個(gè)代表指定文件中的圖像的ImageData實(shí)例。 public static ImageData create(String filename)

List

com.itextpdf.layout.element
List是一個(gè)布局元素，它表示一系列具有相同或非常相似布局屬性的垂直輪廓對(duì)象，使其具有一種統(tǒng)一性。它包含ListItem對(duì)象，可以選擇使用符號(hào)和/或編號(hào)作為前綴。

List 構(gòu)造方法

// 創(chuàng)建一個(gè)以DEFAULT_LIST_SYMBOL為前綴的List。 public List()

List 常用方法

// 將一個(gè)新的列表項(xiàng)添加到列表的底部 public List add(ListItem listItem)// 設(shè)置ListItem符號(hào)的縮進(jìn)偏移量 默認(rèn)為39 public List setSymbolIndent(float symbolIndent)//設(shè)置要使用的列表符號(hào)。這將創(chuàng)建一個(gè)無(wú)序列表，即所有列表項(xiàng)目將顯示相同的前綴。 public List setListSymbol(String symbol)

https://www.htmlsymbols.xyz/unicode/U+2022

ListItem

列表項(xiàng)是一個(gè)布局元素，它是list中的一個(gè)條目。list對(duì)象控制列表項(xiàng)的前綴、后綴和編號(hào)。

Property

屬性名的枚舉，用于布局元素的圖形屬性。IPropertyContainer執(zhí)行與 java.util.Map,相同的功能。，使用Property的值作為它的潛在鍵。

IPropertyContainer 接口

一個(gè)類似map的通用接口，它定義了通過(guò)Property類型的enum鍵來(lái)存儲(chǔ)和檢索對(duì)象的方法。

IPropertyContainer 常用方法

// 設(shè)置此實(shí)體的屬性 void setProperty(int property, Object value)

ElementPropertyContainer

是一個(gè)抽象類，適用于PDF布局對(duì)象層次結(jié)構(gòu)的通用抽象元素。所有布局對(duì)象實(shí)現(xiàn)的超類。

ElementPropertyContainer 常用方法

//設(shè)置該元素的字體 //此屬性將覆蓋setFontFamily設(shè)置的值。字體可以通過(guò)精確的PdfFont實(shí)例設(shè)置， //也可以通過(guò)與FontProvider中的字體相對(duì)應(yīng)的字體家族名稱設(shè)置，但不能同時(shí)設(shè)置。 public T setFont(PdfFont font)//設(shè)置該元素的文本對(duì)齊方式。 public T setTextAlignment(TextAlignment alignment)//設(shè)置此元素的水平對(duì)齊方式。 public T setHorizontalAlignment(HorizontalAlignment horizontalAlignment)// 設(shè)置該元素的字體大小，以點(diǎn)為單位 public T setFontSize(float fontSize) //為該元素的所有四條邊設(shè)置邊框，可自定義顏色、寬度和模式類型。 public T setBorder(Border border)

FontProvider

字體選擇器邏輯的主要入口點(diǎn)。包含可重用的FontSet和PdfFonts集合。由于PdfFont, FontProvider依賴于PdfDocument，所以它不能用于不同的文檔，除非使用reset()重置或使用getFontSet()重新創(chuàng)建。在前一種情況下，FontSelectorCache被重用，而在后者中，它被重新初始化。FontProvider是創(chuàng)建PdfFont的唯一終點(diǎn)。
每個(gè)文檔只允許使用一個(gè)FontProvider。如果每個(gè)元素需要額外的字體，則可以使用FontSet的另一個(gè)實(shí)例。. For more details see com.itextpdf.layout.property.Property.FONT_SET, getPdfFont(FontInfo, FontSet), getStrategy(String, List, FontCharacteristics, FontSet).

//重置PdfFont緩存。調(diào)用該方法后，FontProvider可以被另一個(gè)PdfDocument重用 public void reset()

AbstractElement

定義大多數(shù)IElement實(shí)現(xiàn)共享的最常見(jiàn)的屬性。

Canvas

Canvas 構(gòu)造方法

// 創(chuàng)建一個(gè)新的畫(huà)布來(lái)操作一個(gè)特定的內(nèi)容流，例如一個(gè)頁(yè)面或PdfFormXObject流 public Canvas(PdfCanvas pdfCanvas, Rectangle rootArea)

Canvas 常用方法

public PdfCanvas concatMatrix(double a, double b, double c, double d, double e, double f)

PdfCanvas

PdfCanvas類表示將數(shù)據(jù)寫(xiě)入內(nèi)容流的算法。要寫(xiě)入頁(yè)面內(nèi)容，請(qǐng)從頁(yè)面實(shí)例創(chuàng)建PdfCanvas。要寫(xiě)入表單XObject，從表單XObject實(shí)例創(chuàng)建PdfCanvas。確保在完成對(duì)畫(huà)布的寫(xiě)入后調(diào)用PdfCanvas.release()。這樣會(huì)節(jié)省一些內(nèi)存

當(dāng)前變換矩陣是頁(yè)面圖形狀態(tài)的一部分。在圖形狀態(tài)中定義的其他值是線寬、描邊顏色（對(duì)于線條）、填充顏色（對(duì)于形狀）等

默認(rèn)線寬是 1 個(gè)用戶單位并且默認(rèn)筆觸顏色是黑色

PdfCanvas 構(gòu)造方法

// 快速創(chuàng)建PdfCanvas特定的頁(yè)面 public PdfCanvas(PdfPage page)// 從內(nèi)容流的頁(yè)面，表單XObject，模式等 創(chuàng)建PdfCanvas // resources 資源，一個(gè)可由內(nèi)容流中的PDF指令使用的專用字典 public PdfCanvas(PdfStream contentStream, PdfResources resources, PdfDocument document)

PdfCanvas 常用方法

// 移動(dòng)當(dāng)前點(diǎn)到(x, y)，忽略任何連接線段。 1、public PdfCanvas moveTo(double x, double y)//將從當(dāng)前點(diǎn)開(kāi)始的Bêzier曲線追加到路徑 2、public PdfCanvas curveTo(double x1, double y1, double x2, double y2, double x3, double y3)// 保存圖形狀態(tài) 3、public PdfCanvas saveState()// 更改填充路徑的當(dāng)前顏色。 4、public PdfCanvas setFillColor(Color color)//Draws a rectangle. 5、public PdfCanvas rectangle(double x, double y, double width, double height) // 填充當(dāng)前路徑 6、public PdfCanvas fill()//恢復(fù)圖像的狀態(tài) 7、public PdfCanvas restoreState()// 開(kāi)始文本塊(PDF BT操作符) 8、public PdfCanvas beginText()//結(jié)束文本塊(PDF ET操作符) 9、public PdfCanvas endText() // 通過(guò)移動(dòng)文本行矩陣移動(dòng)文本(PDF Td操作符)。 10、public PdfCanvas moveText(double x, double y)//顯示文本(操作符Tj)。 11、public PdfCanvas showText(String text)//移動(dòng)到下一行并顯示文本 12、public PdfCanvas newlineShowText(String text)//將2x3仿射變換矩陣連接到由畫(huà)布管理的內(nèi)容流中的當(dāng)前矩陣。對(duì)比setTextMatrix //在第三列的元素的值總是固定的（0，0，和1） //值a，b，c，和d可用于縮放，旋轉(zhuǎn)和傾斜的坐標(biāo)系。沒(méi)有理由將我們限制在軸正交或 //X 方向的進(jìn)度需要與 Y 方向的進(jìn)度相同的坐標(biāo)系中。 13、public PdfCanvas concatMatrix(double a, double b, double c, double d, double e, double f) 14、public PdfCanvas setTextMatrix(float a, float b, float c, float d, float x, float y)

Rectangle

表示矩形對(duì)象

Rectangle 構(gòu)造方法

public Rectangle(float x, float y, float width, float height)

Rectangle 常用方法

// 獲取矩形左邊緣的X坐標(biāo)。和getX()一樣 public float getLeft() public float getX()// 獲取矩形下邊緣的Y坐標(biāo)。一樣:getY()。 public float getBottom()// 獲取矩形的高度。 public float getHeight()// 獲取矩形的寬度 public float getWidth()

IRenderer

渲染器對(duì)象負(fù)責(zé)在文檔或畫(huà)布上繪制相應(yīng)的布局對(duì)象。每個(gè)布局對(duì)象都有一個(gè)渲染器，默認(rèn)情況下是對(duì)應(yīng)的類型之一，例如，你可以向com.itextpdf.layout.element.Image請(qǐng)求其ImageRenderer。渲染器被設(shè)計(jì)成可擴(kuò)展的，自定義實(shí)現(xiàn)可以在運(yùn)行時(shí)被播種到布局對(duì)象(或它們的自定義子類)中。

IRenderer 常用方法

AbstractRenderer

定義了大多數(shù)IRenderer實(shí)現(xiàn)共享的最常見(jiàn)的屬性和行為。所有的默認(rèn)渲染器都是這個(gè)默認(rèn)實(shí)現(xiàn)的子類。

// 獲取包含此IRenderer寫(xiě)入DrawContext的所有內(nèi)容的包圍框。 public Rectangle getOccupiedAreaBBox()

BlockRenderer

IEventDispatcher

事件調(diào)度器接口

// 添加新的事件處理程序 void addEventHandler(String type, IEventHandler handler)

IEventHandler

處理事件的接口。EventHandlers 被添加到 EventDispatcher 中。

只有一個(gè)方法

// 用于處理事件的鉤子。實(shí)現(xiàn)可以訪問(wèn)與指定事件關(guān)聯(lián)的PdfDocument實(shí)例， // 如果可用，也可以訪問(wèn)PdfPage實(shí)例 void handleEvent(Event event);

PdfDocumentEvent

PdfDocumentEvent 常用方法

//在頁(yè)面刷新到文檔之前發(fā)送。當(dāng)創(chuàng)建了一個(gè)連續(xù)的頁(yè)面時(shí)，不一定會(huì)分派這個(gè)事件。//在使用高級(jí)iText API時(shí)，請(qǐng)記住這一點(diǎn) public static final String END_PAGE = "EndPdfPage"// 返回與此事件關(guān)聯(lián)的PdfDocument public PdfDocument getDocument()// 返回與此事件關(guān)聯(lián)的PdfPage。警告:該值可以為空。 public PdfPage getPage()

SolidBorder

在被設(shè)置的元素周?chē)L制實(shí)邊。

SolidBorder 構(gòu)造方法

// 創(chuàng)建具有指定寬度和指定顏色的SolidBorder。 public SolidBorder(Color color, float width)// 創(chuàng)建指定寬度、顏色和不透明度的SolidBorder。 public SolidBorder(Color color, float width, float opacity)public SolidBorder(float width)

總結(jié)

以上是生活随笔為你收集整理的iText 7 基础的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。