说明
v1 版本已经不再更新了，官方也只是提供以前申请下来的账号能继续使用，新申请，需要用到v3了v3 版本sdk参考 wps-weboffice-sdk-v3, 里面有很详细的注释v3 集成方法，后端请参考wps-weboffice-v3-demo, 实现你需要对接的接口即可使用v3的大前提是，你申请了开发账号，并且申请下来了appid，–web-office官网–其实v3版本已经是小半年了，但是呢，实在看不下去官方的那个sdk，所以，自己就接着弄吧，虽然也没有多少工作量，主要是让用的人能快速接入~~~
基于官方最新sdk-v3 ------------ V3开发文档官网
基于官方的sdk,做了大量优化,增加了最为详细的注释,并推送到maven,方便大家使用
sdk地址 https://gitee.com/mose-x/wps-weboffice-sdk-v3
引入maven
<dependency> <groupId>cn.ljserver.tool</groupId> <artifactId>web-office-v3</artifactId> <version>3.1.1</version></dependency>基于此sdk的实现,也给你demo以及简单的html页面
demo地址 https://gitee.com/mose-x/wps-weboffice-v3
号外
web office 已经适配 国产框架 solon，想体验的去试试，或者试试这个solon demo，相关说明
sdk地址 https://gitee.com/mose-x/wps-weboffice-sdk-v3-solon
引入maven
<dependency> <groupId>cn.ljserver.tool</groupId> <artifactId>web-office-v3-solon-plugin</artifactId> <version>1.0.0</version></dependency>基于此sdk的实现,也给你demo以及简单的html页面
demo地址 https://gitee.com/mose-x/wps-weboffice-v3-solon-demo
go sdk
项目地址 : (https://gitee.com/mose-x/weboffice)
使用:
go get github.com/mose-x/weboffice
– 接着说 –
效果呢,和v1版本的大差不差,只是接入方式完全变化了
使用sdk接入,反倒更加简单了,需要接入的,多看看demo里面的注释,以及sdk的注释
比如文件预览，引入maven后，你只需实现PreviewService 里面的接口即可
/** * 文件预览服务必要的接口实现 * <br> * <a href="https://solution.wps.cn/docs/callback/preview.html">-详见官方文档-</a> */@Servicepublic class PreviewServiceImpl implements PreviewService { @Autowired private UserService userService; @Autowired private FileService fileService; /** * 获取文件信息 * * @param fileId 文件id <br> * <a href="https://solution.wps.cn/docs/callback/preview.html#获取文件信息">-详见官方文档-</a> */ @Override public FileInfo fetchFileInfo(String fileId) { // 解释说明下，这里在实际的设计中，需要将 文件信息 表 和历史文件版本表分开放 // 这里是通过文件id，获取到当前文件最新一个版本的文件信息，并返回 // 这里为了方便，所以设计成了一张表 return fileService.fetchFile(fileId).toFileInfo(); } /** * 获取文件下载地址 * * @param fileId 文件id <br> * <a href="https://solution.wps.cn/docs/callback/preview.html#获取文件下载地址">-详见官方文档-</a> */ @Override public DownloadInfo fetchDownloadInfo(String fileId) { // 解释说明下，这里在实际的设计中，需要将 文件信息 表 和历史文件版本表分开放 // 然后这里就会获取最后一个版本的文件并返回 // 这里为了方便，所以设计成了一张表 return Optional.ofNullable(fileId) .map(fileService::findById) .map(Collection::stream) .flatMap(s -> s.max(Comparator.comparingInt(f -> f.getId().getVersion()))) .map(f -> DownloadInfo.builder() .url(f.getUrl()) .build()) .orElseThrow(FileNotExist::new); } /** * 获取用户文件权限 * * @param fileId 文件id <br> * <a href="https://solution.wps.cn/docs/callback/preview.html#文档用户权限">-详见官方文档-</a> */ @Override public UserPermission fetchUserPermission(String fileId) { // 解释说明下，这里在实际的设计中，需要将 文件信息 表 和 用户权限 表 分开放 // 这里为了方便，并没有设计表，返回了所有权限到前端 // check file exists fileService.fetchFile(fileId); // 获取user信息，这个方法点进去看看把！！！ User user = userService.fetchUserByToken(); // 构建user对应的文件权限 return UserPermission.builder() .userId(String.valueOf(user.getId())) .read(true) .update(true) .rename(true) .download(true) .copy(true) .comment(true) .history(true) .build(); }}文档编辑，单阶段保存，嗯，很简单，如下
/** * 单阶段文件保存接口 * <p> * <a href="https://solution.wps.cn/docs/callback/save.html#%E5%8D%95%E9%98%B6%E6%AE%B5%E6%8F%90%E4%BA%A4">详见wps web office官网</a> */@Servicepublic class SinglePhaseFileStorageServiceImpl implements SinglePhaseFileStorageService { @Autowired private UserService userService; @Autowired private FileService fileService; /** * 上传文件 * * @param request 上传文件请求 * @return 文件信息 * <p> * <a href="https://solution.wps.cn/docs/callback/save.html#%E5%8D%95%E9%98%B6%E6%AE%B5%E6%8F%90%E4%BA%A4">详见wps web office官网</a> */ @Override public FileInfo uploadFile(FileUploadSinglePhase.Request request) { // 获取用户信息 -> 这个方法点进去看看 ？？！！ final User user = userService.fetchUserByToken(); // 保存文件信息 final File file = Optional.of(request) .map(r -> fileService.fetchFile(request.getFileId())) .map(f -> File.builder() .id(f.getId().copyForNewVersion()) .creator(f.getCreator()) .createTime(f.getCreateTime()) .modifyTime(LocalDateTime.now()) .modifier(user) .name(request.getName()) .size(request.getSize()) // 上传文件获取到URL // -------------------------------- // 这里不应该直接保存URL，而是不带domain的uri方便后续迁移等等 // 为了方便，就这么弄了 // -------------------------------- .url(QnFileService.upload(request.getFile())) .build()) .map(f -> fileService.repository().save(f)) .orElseThrow(FileNotExist::new); // 返回文件信息 return file.toFileInfo(); }}这里说明下，单阶段保存，和三阶段保存
单阶段，即直接保存，没有那么多花里胡哨的三阶段保存 先获取自定义的加密算法获取到自定义的文件上传接口，同时将文件元信息给到你当wps后台上传完文件后（通过步骤2上传），再调用你的上传完成接口，作为回调，告诉你上传完成的信息但是
⛔开发者请注意
由于保存接口的升级，单阶段提交将于2024年9月1日起停止新的接入
正在使用单阶段提交的开发者，您仍可继续使用，不受此次升级影响
正在对接单阶段提交的开发者，请留意对接截止时间，推荐您对接三阶段保存接口
若关闭单阶段提交接口，则该接口不能被再次开启
此次先给到java的sdk，java-demo以及最简单的html页面来让大家快速对接，如果确实有需要的话，后续我再把官网前端那些对接的，弄个vue的项目，供大家参考，反正闲着也是闲着。。。
嗯，别忘了给v3项目小星星哦！
V3实际效果
和v1效果差不多，只是v3目前有自带的水印
docx 在线预览/编辑
pptx 在线预览/编辑
xlsx 在线预览/编辑
pdf 在线预览/编辑