2022年iText入门基础教程 .pdf

《2022年iText入门基础教程 .pdf》由会员分享，可在线阅读，更多相关《2022年iText入门基础教程 .pdf（18页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、iText 入门教程用 iText 生成常用的 pdf iText 是一个非常著名的能够快速产生PDF 文件的 Java类库。支持文本，表格，图形的操作， 可以方便的跟Servlet 进行结合、著名的Spring 也采用 iText 作为生成 PDF 的解决方案。 2011-5-12 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 1 页，共 18 页 - - - - - - - - - 目 录一、iText 简介 . 41)What is iText? . 4二、搭建 iText

2、环境. 61)环境准备 . 62)几个基础的类的含义. 6三、用 iText 进行 PDF 操作 . 71)经典的 hello word. . 72)给 pdf 来点颜色 . 93)设置阅读器参数 . 104)给文档设置密码和权限. 135)解决中文的问题 . 166)总结:. 18名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 2 页，共 18 页 - - - - - - - - - 教程版本说明作者0.9内部培训入门级教程、此教程仅仅作为入门理解之用、不做深入研究。若做深入研究、

3、建议阅读itext.in.action 这本书wanghe 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 3 页，共 18 页 - - - - - - - - - 一、 iText 简介1)What is iText?如果你在需要创建PDF 的一系列操作 ,你将使用像 Adobe Acrobat 或者 Adobe InDesign这样的桌面图形设计工具去手动或者半自动的创建一个文档。另一种情况 , PDF 文档是利用软件应用提供的API 自动创建的、 不需要或者最小化地依赖人工介入

4、。有一些场景是文档先被创建成一些其他的格式、例如:html 、 xml, 然后再转换成PDF.这些不同方式的需求可能需要不同的软件工具。类似的情况发生在操作PDF,你可能用Adobe Acrobat更新 PDF ，但是也有工具可以使你将数据库形式的数据去增加内容。iText 就是一个专注于自动化方面的工具。iText 是一个 PDF 的类库iText 是提供了一组API ，允许开发人员做一下的事情:(不仅仅局限以下、还有更多可以做的) 从 xml 或者数据库生成文档或者报表。制作绘图和书籍，开拓很多PDF 中的交互特性在现有的PDF 中增加书签，页码，水印，和其他特性切分或者整合存在的PDF

5、文件填写互动表格在 WEB 浏览器中提供动态生成和操作PDF 的服务iText 不是最终用户的工具.你必须将iText 搭建在你自己的应用中,这样你可以进行PDF的一系列操作了. 功能预览下图罗列出了你可以用iText 进行的操作：名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 4 页，共 18 页 - - - - - - - - - iText 支持的功能iText 部分支持的功能iText 主要的作用是创建和操作PDF 文档当前最新版本 :5.1.0 项目官方网站 :http:/

6、 下载地址 :http:/cdnetworks-kr- 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 5 页，共 18 页 - - - - - - - - - 二、 搭建 iText 环境1) 环境准备MyEclipse8.5 下载 iText 最新 jar 包新建一个 javaProject、将 iText.jar 导入 classPath 、这样就可以用iText 进行 PDF开发了。2) 几个基础的类的含义名称解释PdfWriter书写器、用于往document中写入信息。D

7、ocument 一个 PDF 文档组件。Chunk 文本块、这是可以写入文档的最小的组件。Phrase短语、由一系列Chunk 组成。paragraph 段落、有一系列的Phrase 或者 Chunk组成。TableWrapper 表格、处理简单表格的组件PdfPTable 表格、处理复杂表格的组件Image 图形处理组件Rectangle 代表几何图形组件、可以通过此组件设置背景色、边框等样式，类似html里的Box BaseColor 定义颜色组件、预装了很多常用颜色名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整

8、理 - - - - - - - 第 6 页，共 18 页 - - - - - - - - - 三、 用 iText 进行 PDF 操作1) 经典的 hello word. 说明 : 生成一个 PDF 、内容为Hello word！Code: 1.新建 Class HelloItext、在 main方法中 : - / 新建一个文档Document document = new Document(); try / 建立一个书写器(Writer)与document对象关联PdfWriter.getInstance( document,new FileOutputStream(D:helloworld

9、.pdf); / 打开一个文档document.open(); / 向文档中添加文字:hello world!document.add(new Paragraph(hello world!); catch (FileNotFoundException e) e.printStackTrace(); catch (DocumentException e) e.printStackTrace(); finally document.close(); 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - -

10、 - 第 7 页，共 18 页 - - - - - - - - - 运行 - 输出 : 在D盘可看见生成了一个helloworld.pdf文件 : 打开 helloworld.pdf、可看见里面显示了文字hello world! （局部截图）名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 8 页，共 18 页 - - - - - - - - - 2) 给 pdf来点颜色说明 : 基于第一个例子代码基础上、给文档设置背景颜色、边框、外边距Code: 1.新建 Class ColorIt

11、ext、在 main方法中 : - / 定义一个 A4 大小的矩形组件Rectangle rect = new Rectangle(PageSize.A4 ); / 设置背景色为浅灰色rect.setBackgroundColor(BaseColor.LIGHT_GRAY ); / 设置 border类型为 box( 四周都有 )rect.setBorder(Rectangle.BOX); / 设置 border颜色为深灰色rect.setBorderColor(BaseColor.DARK_GRAY); / 设置 border宽度为 5rect.setBorderWidth(5); / 创建

12、一个文档,将rect 作为预设的样式传入,后面的 10,10,10,10是文档的外边距Document document = new Document(rect,10,10,10,10); try PdfWriter.getInstance(document,newFileOutputStream(D:helloworld.pdf); document.open(); document.add(new Paragraph(hello world!); catch (FileNotFoundException e) e.printStackTrace(); catch (DocumentExce

13、ption e) e.printStackTrace(); finally document.close(); 运行 - 输出 : 打开 helloworld.pdf-有颜色了吧名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 9 页，共 18 页 - - - - - - - - - 3) 设置阅读器参数说明 : 基于第一个例子代码基础上、设置阅读器的参数Code: 1.新建 Class WriterItext、在 main方法中 : - Document document = new

14、 Document(); try PdfWriter pdf = PdfWriter.getInstance(document,newFileOutputStream(D:helloworld.pdf); /* * PdfWriter.PageModeUseThumbs:显示缩略图 * PdfWriter.PageLayoutTwoColumnLeft:双列显示 , 奇数页在左 * PdfWriter.HideMenubar:隐藏阅读程序的菜单 */pdf.setViewerPreferences(PdfWriter.PageModeUseThumbs|PdfWriter. PageLayou

15、tTwoColumnLeft|PdfWriter.HideMenubar); document.open(); document.add(new Paragraph(hello world!); catch (FileNotFoundException e) e.printStackTrace(); catch (DocumentException e) e.printStackTrace(); finally document.close(); 运行 - 输出 : 打开 helloworld.pdf 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - -

16、 - - - - - 名师精心整理 - - - - - - - 第 10 页，共 18 页 - - - - - - - - - 设置阅读器参数的一些静态变量含义类型静态变量名作用页面布局PdfWriter.PageLayoutSinglePage 同时只显示一个页面PdfWriter.PageLayoutOneColumn 单列显示PdfWriter.PageLayoutTwoColumnLeft 双列显示 ,奇数页在左PdfWriter.PageLayoutTwoColumnRight 双列显示 ,奇数页在右页面模式PdfWriter.PageModeUseNone 既不显示大钢也不显示缩略

17、图PdfWriter.PageModeUseOutlines 显示大纲PdfWriter.PageModeUseThumbs 显示缩略图PdfWriter.PageModeFullScreen 全屏模式， 没有菜单、 windows控件或者其他任何windows可见控件PdfWriter.HideToolbar 当文档激活时， 是否隐藏阅读程序 （如Adobe Reader）的工具条PdfWriter.HideMenubar 当文档激活时，是否隐藏阅读程序的菜单PdfWriter.HideWindowUI 当文档激活时，是否隐藏阅读程序的界面元素，如滚动条、导航条等，而仅仅保留文档显示PdfW

18、riter.FitWindow 是否调整文档窗口尺寸以适合显示第一页PdfWriter.CenterWindow 是否将文档窗口放到屏幕中央全 屏PdfWriter.NonFullScreenPageModeUseNo既不显示大钢也不显示缩略图名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 11 页，共 18 页 - - - - - - - - - 模 式下 页面 布局ne PdfWriter.NonFullScreenPageModeUseOutlines 显示大钢PdfWrite

19、r.NonFullScreenPageModeUseThumbs 显示缩略图名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 12 页，共 18 页 - - - - - - - - - 4) 给文档设置密码和权限说明 : 基于第一个例子代码基础上、设置文档的密码和权限注意若需要加密则必须导入bcprov-jdk16-1.44.jar这个包下载地址为：http:/mirrors.ibiblio.org/pub/mirrors/maven2/org/bouncycastle/bcprov-

20、jdk16/1.44/bcprov-jdk16-1.44.jarCode: 1.新建 Class EncryptionItext、在 main方法中 : - Document document = new Document(); try PdfWriter pdf = PdfWriter.getInstance(document,newFileOutputStream(D:helloworld.pdf); /* * 第一个参数是设置userPassword为123 * 第二个参数是设置ownerPassword为1234 * 第三个参数设置user 的权限可以复制、可以打印 * 第四个参数设置

21、加密类型 */pdf.setEncryption(newbyte1, 2, 3,newbyte1, 2, 3, 4,PdfWriter.ALLOW_COPY|PdfWriter.ALLOW_PRINTING , PdfWriter.STANDARD_ENCRYPTION_40); document.open(); document.add(new Paragraph(hello world!); catch (FileNotFoundException e) e.printStackTrace(); catch (DocumentException e) e.printStackTrace()

22、; finally document.close(); 运行 - 输出 : 打开 helloworld.pdf 弹出窗口要求输入口令,输入 123 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 13 页，共 18 页 - - - - - - - - - 打开 PDF 后、查看文档属性 : 可以看出只有打印和内容复制是被允许操作的设置文档权限相关静态变量含义下列表列出了文档许可参数设置的含义，不过要注意，如果你用 40bit进行加密，那么标注为128bit的会自动的被禁止，如果你想要

23、取消这些许可,你必须用128bit进行加密 ,显而易见，用128bit进行加密提供了更高的安全级别。静态变量名作用标注PdfWriter. ALLOW_ASSEMBLY 插入、删除、旋转页面、 加入书签的允许。内容不能被改变、除非PdfWriter. ALLOW_MODIFY_CONTENTS设128bit 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 14 页，共 18 页 - - - - - - - - - 置了许可PdfWriter. ALLOW_COPY 拷贝或者提取文本或

24、者图像的许可PdfWriter. ALLOW_DEGRADED_PRINTING Printing the document, but not with the quality offered by PdfWriter.Allow-Printing. 128bit PdfWriter. ALLOW_FILL_IN 填充表单域许可128bitPdfWriter. ALLOW_MODIFY_ANNOTATIONS 填写注释许可PdfWriter. ALLOW_MODIFY_CONTENTS 修改内容许可， 比如改变页面内容、或者插入删除页面PdfWriter. ALLOW_PRINTING 允许打

25、印文档PdfWriter. ALLOW_SCREENREADERS Extracting text and graphics for use by accessibility devices. 128bit FAQ ：如果你想取消拷贝或者保存PDF 文件的许可 ,这样是很难做到的，你不能使abode reader的 Save(Save as)命令取消 ,这不是 iText 的 bug, 而是 PDF 本身带来的安全问题,如果你真想这么做的话，你必须利用digital rights management(数字版权加密保护技术)作为解决方案 ,有许多这样的技术提供者，但是这些工具是相当昂贵的。名师

26、资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 15 页，共 18 页 - - - - - - - - - 5) 解决中文的问题说明 : 由于itext默认是不支持亚洲文字的,如果要想使用中文,则必须在应用中应用亚洲语言包(itext-asian.jar)，我们基于第一个例子代码基础上、向文档中写入中文Code: 1.新建 Class ChineseItext、在 main方法中 : - Document document = new Document(); try PdfWriter.

27、getInstance(document,newFileOutputStream(D:helloworld.pdf); BaseFont base = null; Font fontChinese = null; try /创建一个简体中文的基本字体、UniGB-UCS2-H为简体中文 base = BaseFont.createFont( STSong-Light, UniGB-UCS2-H,BaseFont.EMBEDDED); fontChinese = new Font(base, 12, Font.NORMAL); catch (DocumentException e) e.prin

28、tStackTrace(); catch (IOException e) e.printStackTrace(); document.open(); /设置文档中文字为简体中文document.add(new Paragraph( 大家好 ! ,fontChinese); catch (FileNotFoundException e) e.printStackTrace(); catch (DocumentException e) e.printStackTrace(); finally document.close(); 运行 - 输出 : 此时会出现异常: com.itextpdf.tex

29、t.DocumentException: Font STSong-Light with UniGB-UCS2-H is not recognized. 这是由于我们没有加入亚洲语言包的问题引起的,不过如果我们用itext5.0+以上版本也会出现这个异常，这是由于itext5.0+以上版本在获取资源文件的时候包路径发生了变化，由原来的“com/ 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 16 页，共 18 页 - - - - - - - - - lowagie/text/pdf/

30、fonts/”变成了 ” com/itextpdf/text/pdf/fonts/”而老版的itext-asian.jar路径是 ” com/ lowagie/text/pdf/fonts/”(我没有找到最新版本的语言包、可能最新的语言包已经修复了这个问题) 更改 iTextAsian.jar包名的方法如下:1) 将iTextAsian.jar解压，目录结构如下com/ lowagie/text/pdf/fonts/2) 将加压后 com 目录下的包名lowagie更改为 itextpdf 3) 在命令行转至iTextAsian目录，重新打包为iTextAsian.jar文件命令如下：jar

31、cvf iTextAsian.jar cm/itextpdf/text/pdf/fonts/* 执行后，将新的iTextAsian.jar加入到 classpath路径再次运行 -输出 : 打开 helloworld.pdf 此时可以正常显示中文了名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 17 页，共 18 页 - - - - - - - - - 6) 总结: iText 功能非常强大、此教程仅仅作为入门理解级别的教程、后续有时间还会增加一些高级例子、有基础的同学可以参考这本书名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 18 页，共 18 页 - - - - - - - - -