一、概述
一个 java 语言简化处理 pdf 的框架
项目主页
项目概述
x-easypdf是一个java语言简化处理pdf的框架,包含fop模块与pdfbox模块,fop模块以创建功能为主,基于xsl-fo模板生成pdf文档,以数据源的方式进行模板渲染;pdfbox模块以编辑功能为主,对标准的pdfbox进行扩展,添加了成吨的功能。
项目特性
fop模块
以创建功能为主,基于 xsl-fo 模板生成 pdf 文档,以数据源的方式进行模板渲染。
- 基于模板生成
- 内置多种数据源(xml 数据源、thymeleaf 数据源、freemarker 数据源、jte 数据源、document 数据源)
- 提供面向对象的方式生成模板(document 数据源)
- 灵活的扩展性
pdfbox模块
以编辑功能为主,对标准的 pdfbox 进行扩展,添加了成吨的功能。
- 超出页面宽度自动换行,超出页面高度自动分页
- 内置华为鸿蒙字体,天然支持中文文本
- 内置页眉页脚,简单快捷
- 内置多个组件,满足不同的需求
- 内置多种扩展器,方便解析、提取与处理文档内容
- 支持自定义组件与扩展
springboot简单集成测试
<dependency> <groupId>org.dromara.x-easypdf</groupId> <artifactId>x-easypdf</artifactId> <version>3.2.1</version> </dependency> <dependency> <groupId>org.dromara.x-easypdf</groupId> <artifactId>x-easypdf-pdfbox</artifactId> <version>3.2.1</version> </dependency> <dependency> <groupId>org.dromara.x-easypdf</groupId> <artifactId>x-easypdf-fop</artifactId> <version>3.2.1</version> </dependency>
测试代码:
@Test void contextLoads() { String content = "t先帝创业未半而中道崩殂,今天下三分,益州疲弊,此诚危急存亡之秋也。然侍卫之臣不懈于内,忠志之士忘身于外者,盖追先帝之殊遇,欲报之于陛下也。诚宜开张圣听,以光先帝遗德,恢弘志士之气,不宜妄自菲薄,引喻失义,以塞忠谏之路也。n" + "n" + "宫中府中,俱为一体,陟罚臧否,不宜异同。若有作奸犯科及为忠善者,宜付有司论其刑赏,以昭陛下平明之理,不宜偏私,使内外异法也。n" + "n" + "侍中、侍郎郭攸之、费祎、董允等,此皆良实,志虑忠纯,是以先帝简拔以遗陛下。愚以为宫中之事,事无大小,悉以咨之,然后施行,必能裨补阙漏,有所广益。n" + "n" + "将军向宠,性行淑均,晓畅军事,试用于昔日,先帝称之曰能,是以众议举宠为督。愚以为营中之事,悉以咨之,必能使行阵和睦,优劣得所。n" + "n" + "亲贤臣,远小人,此先汉所以兴隆也;亲小人,远贤臣,此后汉所以倾颓也。先帝在时,每与臣论此事,未尝不叹息痛恨于桓、灵也。侍中、尚书、长史、参军,此悉贞良死节之臣,愿陛下亲之信之,则汉室之隆,可计日而待也。n" + "n" + "臣本布衣,躬耕于南阳,苟全性命于乱世,不求闻达于诸侯。先帝不以臣卑鄙,猥自枉屈,三顾臣于草庐之中,咨臣以当世之事,由是感激,遂许先帝以驱驰。后值倾覆,受任于败军之际,奉命于危难之间,尔来二十有一年矣。n" + "n" + "先帝知臣谨慎,故临崩寄臣以大事也。受命以来,夙夜忧叹,恐托付不效,以伤先帝之明,故五月渡泸,深入不毛。今南方已定,兵甲已足,当奖率三军,北定中原,庶竭驽钝,攘除奸凶,兴复汉室,还于旧都。此臣所以报先帝而忠陛下之职分也。至于斟酌损益,进尽忠言,则攸之、祎、允之任也。n" + "n" + "愿陛下托臣以讨贼兴复之效,不效,则治臣之罪,以告先帝之灵。若无兴德之言,则责攸之、祎、允等之慢,以彰其咎;陛下亦宜自谋,以咨诹善道,察纳雅言,深追先帝遗诏,臣不胜受恩感激。n" + "n" + "今当远离,临表涕零,不知所言。"; // (1)PDFBox方式创建文件 Document document = PdfHandler.getDocumentHandler().create(); // 设置使用字体 document.setFontName("仿宋"); // 创建页面 Page page = new Page(document); // 创建文本域 Textarea textarea = new Textarea(page); // 设置文本 textarea.setText(content); // 设置字体颜色 textarea.setFontColor(Color.BLUE); // 渲染文本 textarea.render(); // 添加页面 document.appendPage(page); // 保存文档 document.save("E:\PDF\出师表(1).pdf"); // 关闭文档 document.close(); //(2)模板方式创建文件 TemplateHandler.Document.build().addPage(TemplateHandler.Page.build(). addBodyComponent(TemplateHandler.Text.build(). setFontFamily("宋体"). setText(content))). setAuthor("诸葛亮"). setSubject("出师表"). setTitle("出师表"). transform("E:\PDF\出师表(2).pdf"); }
文档效果:
(1)PDFBox方式创建文件
(2)模板方式创建文件