本文主要是介绍在线编辑、预览、基于wps web office,v3版 强势来袭,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
说明
- v1 版本已经不再更新了,官方也只是提供以前申请下来的账号能继续使用,新申请,需要用到v3了
- v3 版本sdk参考 wps-weboffice-sdk-v3, 里面有很详细的注释
- v3 集成方法,后端请参考wps-weboffice-v3-demo, 实现你需要对接的接口即可
- 使用v3的大前提是,你申请了开发账号,并且申请下来了appid,–web-office官网–
其实v3版本已经是小半年了,但是呢,实在看不下去官方的那个sdk,所以,自己就接着弄吧,毕竟v1的java版本,就是我出的,虽然也没有多少工作量,主要是让用的人能快速接入~~~
基于官方最新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.0</version>
</dependency>
基于此sdk的实现,也给你demo以及简单的html页面
demo地址 https://gitee.com/mose-x/wps-weboffice-v3
效果呢,和v1版本的大差不差,只是接入方式完全变化了
使用sdk接入,反倒更加简单了,需要接入的,多看看demo里面的注释,以及sdk的注释
比如文件预览,引入maven后,你只需实现PreviewService 里面的接口即可
/*** 文件预览服务必要的接口实现* <br>* <a href="https://solution.wps.cn/docs/callback/preview.html">-详见官方文档-</a>*/
@Service
public class PreviewServiceImpl implements PreviewService {@Autowiredprivate UserService userService;@Autowiredprivate FileService fileService;/*** 获取文件信息** @param fileId 文件id <br>* <a href="https://solution.wps.cn/docs/callback/preview.html#获取文件信息">-详见官方文档-</a>*/@Overridepublic 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>*/@Overridepublic 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>*/@Overridepublic UserPermission fetchUserPermission(String fileId) {// 解释说明下,这里在实际的设计中,需要将 文件信息 表 和 用户权限 表 分开放// 这里为了方便,并没有设计表,返回了所有权限到前端// check file existsfileService.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>*/
@Service
public class SinglePhaseFileStorageServiceImpl implements SinglePhaseFileStorageService {@Autowiredprivate UserService userService;@Autowiredprivate 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>*/@Overridepublic 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上传),再调用你的上传完成接口,作为回调,告诉你上传完成的信息
此次先给到java的sdk,java-demo以及最简单的html页面来让大家快速对接,如果确实有需要的话,后续我再把官网前端那些对接的,弄个vue的项目,供大家参考,反正闲着也是闲着。。。
嗯,别忘了给v3项目小星星哦!
V3实际效果
和v1效果差不多,只是v3目前有自带的水印(无解,v1有特权,v3不给了)
docx 在线预览/编辑
pptx 在线预览/编辑
xlsx 在线预览/编辑
pdf 在线预览/编辑
这篇关于在线编辑、预览、基于wps web office,v3版 强势来袭的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!