下载地址0积分
项目名称
在线签约(signup) (v1.1.0)
目录
项目简介
*-signup项目(以下简称signup项目),是一个纯在线提供签约服务的项目
。也可以理解为是辅助签约的工具包,其中不包含数据库操作和消息队列操作,提供的是在线文件转换和签约接口整合的项目。目前签约方三方服务提供者为上上签(https://www.bestsign.cn/)
功能简述
此版本功能包含了提供的线上服务和项目的以下特色:
线上服务:
- 格式转换:word2pdf、html2pdf、pdf2img、pdf2file还支持html2img、html2md等一系列格式转换服务;
- 在线签约:集成大多上上签官网提供的api接口,简单配置开发者信息便可开箱使用。
- 特别加强:pdf异步解析,静默签功能
项目特色
- 双系统支持:支持window和linux作为服务器,对应插件位置放对就行;
- 定时任务:支持多维度系统定时任务;
- 鉴权:自定义filter过滤器;
- 自定义业务异常:自定义业务异常;
- 全局异常:全局异常处理器;
- 全局响应格式:全局响应格式返回;
- 唯一异常:全局异常封装处理,友好返回给前端,唯一编号查询系统日志,唯一编码可反编译出时间格式(由于swagger2apimodel冲突暂未生效);
- knife4j:knife4j在线文档;
- 转发资源直访支持:例如上上签静态资源访问本需要token访问,继承后我们系统支持的直接访问;
- pdf高清和缩略图的高效解决方案:首页访问和缓存访问的解决方案,分片异步解析图片;
- 线程池的最佳实践:核心数自动是cpu核数,无需配置;
- redis中央缓存服务:第一次解析的pdf图片集都在redis中,过期时间可配置;
- 全局配置中心管理:更好管理配置;
- 静默签友好支持实现:一键开启常见的企业的静默签署实现;
- 内容校验器:本地对发送合同的内同做了常规性校验,校验项多大20多处。
可扩展的
- 全局异常日志查询接口(唯一异常暂未开启,无法实现)
项目架构
springboot+redis+knife4j+scheduTask+pdfbox+aspose+plugs+businessAsync
目录结构
├── Readme.md // readme文档
├── pom // 依赖pom
├── src // src
│ └──main // main
│ ├── java // java
│ │ └── a.b.c.signup // 代码主目录
│ │ ├── advice // 通知
│ │ │ ├── GlobalExceptionAdvice // 全局异常通知
│ │ │ └── RestReturnValueHandlerAdvice // 全局响应通知
│ │ ├── async // 异步
│ │ │ └── BusinessAsync // 业务异步
│ │ ├── config // 配置
│ │ │ ├── configEntity // 配置实体类
│ │ │ ├── BestSignConfig // 上上签配置类
│ │ │ ├── CustomParamResolverConfigurer // CustomParamResolverConfigurer
│ │ │ ├── FrameworkConfig // 自定义鉴权配置
│ │ │ ├── HttpSessionConfig // HttpSessionConfig
│ │ │ ├── InterceptorConfig // InterceptorConfig
│ │ │ ├── MvcConfigurer // MvcConfigurer
│ │ │ ├── CommandExecutor // CommandExecutor
│ │ │ ├── RestReturnValueHandlerConfigurer // 全局响应程序配置类
│ │ │ ├── ScheduleConfig // ScheduleConfig
│ │ │ ├── Swagger2Config // swagger2ui信息配置
│ │ │ └── WebAppConfig // WebAppConfig
│ │ ├── entity // 实体类
│ │ ├── enums // 枚举
│ │ ├── exception // 异常
│ │ │ └── BusinessException // 业务异常
│ │ ├── filter // 过滤器
│ │ │ └── SignFilter // 验签过滤器
│ │ ├── interceptor // 拦截器
│ │ │ └── AllInterceptor // 总拦截器
│ │ ├── listener // 监听器
│ │ │ └── ApplicationStartup // 服务启动监控
│ │ ├── model // 模型
│ │ │ ├── AjaxResult // ajax返回模型
│ │ │ └── ReturnInfo // 全局响应模型
│ │ ├── open // 开放接口层
│ │ ├── pool // 池化
│ │ │ └── TaskExecutor // 本地任务池
│ │ ├── resolver // 整理
│ │ ├── service // 业务层
│ │ ├── task // 任务
│ │ │ └── ScheduTask // 计划任务/定时任务
│ │ ├── util // 工具
│ │ └── SignupApp // Application
│ └── resources // 资源集
│ ├── application.yml // 主配置文件
│ ├── *.properties // 各类环境配置文件
│ ├── *.yml // 各类环境配置文件
│ ├── license.xml // aspose服务验签的配置文件(word2pdf水印去除服务)
│ └── logback-spring.xml // 系统slf4j日志配置文件
└──test // test
使用效果
安装说明
- 环境:(open)jdk 8.0+
- 说明(必要说明):
- 1.jdk要支持fx扩展,可在其jre/lib/ext查看是否有jfxrt.jar包支持,oracle jdk 本身对fx支持不友好,所以正常运行这个项目必须要有这个jar支持
- 2.*********
- 3.html2pdf,html2img功能使用的插件完成的,插件分为win和linux,也需要这些来配合功能完成
- 4.在linux环境下要添加必须的相关字体库,比如重要的宋体simsum.tff
使用说明
参照安装说明,安装好相关环境组件和项目依赖后(最低JVM堆大小4G+),正常启动SignupApp.main即可
开发人员
- AAA
- BBB
- CCC
版权信息
当前版本 v.1.1.0
当前版本内容
- 格式转换:word2pdf、html2pdf、pdf2img、pdf2file还支持html2img、html2md等一系列
- 在线签约:像上上签官网提供的api大多常用的我们内部都封装支持,像常用的发送合同,合同撤销,盖章等
- 特别加强:pdf异步解析,静默签功能,内容校验器
更新日志
版本 | 时间 | 内容 |
---|---|---|
v.1.0.0 | 2021.8.x | 基本在线服务支持(格式转换,在线签约,文件服务) |
v.1.1.0 | 2021.9.x | 去除文件流操作和附件服务,添加redis中央缓存操作,异步解析pdf方案以及静默签 |