Word GO

WordGO - 让Java生成word文档更容易.

【choose language:English

项目背景

传统的Java生成word通常需要先手动创建模板文件,之后导入。如果不希望创建模板,还想少些点代码,选Word GO是个好主意~~

安装

手动导入jar包

  • IDEA导入:点击File-Project Structure;然后在左侧找到Modules并点击;最后在右侧点击绿色的+号,选择JARs or directories选取要导入的jar包即可。
  • Eclipse导入:右击“项目”→选择Properties,在弹出的对话框左侧列表中选择Java Build Path

maven中央仓库导入

  1. <dependency>
  2. <groupId>com.github.qrpcode</groupId>
  3. <artifactId>wordgo</artifactId>
  4. <version>1.0-SNAPSHOT</version>
  5. </dependency>

环境依赖和兼容性

只要能运行java这个就能用,他不依赖于任何第三方Office应用

兼容性请看表:

分类 软件名称 兼容性说明
桌面版 Microsoft Word 完美兼容
WPS 完美兼容
永中Office 完美兼容
在线版 金山文档 该系统本身对部分属性不支持
腾讯文档 该系统本身对部分属性不支持
石墨文档 该系统本身对部分属性不支持,偶尔可能提醒文档需要修复,但能正常导入和显示
其他常用 手机QQ 该系统本身对部分属性不支持
手机微信 该系统本身对部分属性不支持

[注] 经过测试,石墨文档应该不是用xml解析的,似乎是字符串截取的,正在努力适配~

使用

来,导入了jar包,我们先来创建一个“Hello World”

  1. WordGo wordGo = new WordGo();
  2. //新建一个word
  3. wordGo.add("Hello World", "font-size: 15; color: #FF0000");
  4. //填充数据可以查看对应功能说明
  5. wordGo.create("C:\\demo.docx");
  6. //最后生成即可,参数是生成目录,必须带文件名且以.docx结尾

是的,它和Css写法很类似,很容易上手~~

代码支持JDK1.5 +(含)

对应功能说明(10分钟就能学会)

👉 WordGO 构造和生成文件

👉 设置文档属性信息

👉 设置纸张大小和边距

👉 文字、换页有关操作

👉 创建、填充、添加表格有关操作

👉 图片有关操作

👉 页眉页脚有关操作

主要项目负责人

@qrpcode

参与

没错,我也觉得我代码写的 有点 (十分) 乱

来帮帮我吧,Fork 之后 pull request 一下就可以啦~

开源协议

Apache-2.0 License

(也就是说他是可以商用的,详细看协议吧~~)

💖 如果觉得有用记得点 Star⭐

.

当前仍为快照版,还存在较多bug,

不建议用于生产环境

发现BUG滑动页面到最上方有一个【❕ issues】选项卡,留言后我就会尽快回复和修复啦~~

已发现BUG:

  1. 样式表只写一个且属性为颜色的时候可能会无效(已修复)
  2. addLine方法逻辑存在问题,部分时候可能无法正常换行(已修复)

[注] maven引用快照版本,我修改同步之后您无需修改将自动替换为最新版本

V1.0快照版 更新记录:

2020.9.2 修正了addLine方法,原来可能无法正常换行;解决了部分属性可能设置后不显示的问题(解决方法不是很好,下一版本改成更好的吧,现在可以正常使用~)

2020.8.2 添加了页眉页脚和纸张操作

2020.7.15 项目开始