README文档模板 含下载地址0积分 项目文档模板 springboot文档示例 readme参考文档 目录跳转 项目架构 使用说明 目录结构 等等 (含附件下载)

下载地址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.02021.8.x基本在线服务支持(格式转换,在线签约,文件服务)
v.1.1.02021.9.x去除文件流操作和附件服务,添加redis中央缓存操作,异步解析pdf方案以及静默签
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

若光672

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值