# JDoper

**Repository Path**: jadison/JDoper

## Basic Information

- **Project Name**: JDoper
- **Description**: JDoper是全网最强大、最灵活、最简单、最好用的Java处理word及pdf工具包，没有之一。
无需安装office，支持多平台，绝对无损导出及转换，所见即所得。
支持文档模板设置，支持文本、图片，支持doc、docx、pdf文件的生成及互相转换。
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 11
- **Forks**: 9
- **Created**: 2021-01-10
- **Last Updated**: 2024-12-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# JDoper

## JDoper介绍

JDoper是全网最强大、最灵活、最简单、最好用的Java导出word及pdf工具包，没有之一。（咱说话要严谨，插一句“目前为止作者所了解的”~）

JDoper在处理word方面完全可以秒杀Jacob、Apache POI、Java2word、FreeMarker、PageOffice等框架，因为这些框架都各有缺点，主要集中在以下几方面：

- Jacob的服务器只能是windows平台，不支持unix和linux，且服务器上必须安装微软Office
- Apache POI更适合excel处理，对于word实现一些简单文件的操作凑合，不能设置样式且生成的word文件格式不够规范
- FreeMarker有很多常用的word格式无法处理或表现怪异，比如：超链、换行、乱码、部分生成的文件打不开等
- Java2word没有FreeMarker强大，不能够根据模版生成Word文档，word的文档的样式等信息都不能够很好的操作
- PageOffice必须在客户端生成文件，不支持纯服务器端生成文件
- 另外还有一些提供在线导出及转换api的服务商，对接比较麻烦，而且收费不便宜，关键是不能私有化部署总感觉差点儿意思

总结一下这些框架，或是环境要求复杂，或是导出格式失真无法满足要求，或是只支持文本不支持图片，或是其他莫名其妙的原因而无法使用！

而我们，作为一名有要求的Coder，完美的需求是这样的：

- 无需安装office，支持多平台
- 支持自定义文档格式（离线使用自己电脑的office或wps编写即可）
- 格式绝对无损地导出及转换，所见即所得
- 文档模板设置，支持文本、图片的动态化组装
- 支持doc、docx、pdf文件的生成及互相转换

OK，如果你也需要做word导出转换类功能，从此不用再冥思苦想各种搜索万千尝试，也不用再努力半天一地鸡毛，因为JDoper可以满足你的所有幻想！

让我们从此开启一种极致、简单的方式，来实现那些梦寐以求的功能吧！

## 使用流程

- 在wps或office word中编辑文档，此步骤是设计文档格式，将来导出的文档与此文档格式一模一样
- 在文档中设置替换参数，以#(name)的方式声明哪些地方是需要根据数据动态替换的
- 上传文档（也可以直接导出文档xml，然后将xml内容放入指定表中）
- 在后台代码中准备数据集，与第二步中设置的参数相对应（键值对）
- 调用工具包的方法，传入要生成的文件路径、文件名、文件类型
- 获取文件

再次强调，使用本工具包可以保证导出的word或pdf与最初设计的文档格式完全一致！！！ 

##  获取方式

代码及开源包还在整理中，可加微信获取：

![image-20210115175010105](https://gitee.com/jadison/pubimg/raw/master/img/image-20210115175010105.png)