在线编辑、预览、基于wps web office,v3版 强势来袭(已适配solon) ...

打印 上一主题 下一主题

主题 905|帖子 905|积分 2715

说明


  • 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
  1. <dependency>
  2.   <groupId>cn.ljserver.tool</groupId>
  3.   <artifactId>web-office-v3</artifactId>
  4.   <version>3.1.1</version>
  5. </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
  1. <dependency>
  2.   <groupId>cn.ljserver.tool</groupId>
  3.   <artifactId>web-office-v3-solon-plugin</artifactId>
  4.   <version>1.0.0</version>
  5. </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 内里的接口即可
  1. /**
  2. * 文件预览服务必要的接口实现
  3. * <br>
  4. * <a href="https://solution.wps.cn/docs/callback/preview.html">-详见官方文档-</a>
  5. */
  6. @Service
  7. public class PreviewServiceImpl implements PreviewService {
  8.     @Autowired
  9.     private UserService userService;
  10.     @Autowired
  11.     private FileService fileService;
  12.     /**
  13.      * 获取文件信息
  14.      *
  15.      * @param fileId 文件id <br>
  16.      *               <a href="https://solution.wps.cn/docs/callback/preview.html#获取文件信息">-详见官方文档-</a>
  17.      */
  18.     @Override
  19.     public FileInfo fetchFileInfo(String fileId) {
  20.         // 解释说明下,这里在实际的设计中,需要将 文件信息 表 和历史文件版本表分开放
  21.         // 这里是通过文件id,获取到当前文件最新一个版本的文件信息,并返回
  22.         // 这里为了方便,所以设计成了一张表
  23.         return fileService.fetchFile(fileId).toFileInfo();
  24.     }
  25.     /**
  26.      * 获取文件下载地址
  27.      *
  28.      * @param fileId 文件id <br>
  29.      *               <a href="https://solution.wps.cn/docs/callback/preview.html#获取文件下载地址">-详见官方文档-</a>
  30.      */
  31.     @Override
  32.     public DownloadInfo fetchDownloadInfo(String fileId) {
  33.         // 解释说明下,这里在实际的设计中,需要将 文件信息 表 和历史文件版本表分开放
  34.         // 然后这里就会获取最后一个版本的文件并返回
  35.         // 这里为了方便,所以设计成了一张表
  36.         return Optional.ofNullable(fileId)
  37.                 .map(fileService::findById)
  38.                 .map(Collection::stream)
  39.                 .flatMap(s -> s.max(Comparator.comparingInt(f -> f.getId().getVersion())))
  40.                 .map(f -> DownloadInfo.builder()
  41.                         .url(f.getUrl())
  42.                         .build())
  43.                 .orElseThrow(FileNotExist::new);
  44.     }
  45.     /**
  46.      * 获取用户文件权限
  47.      *
  48.      * @param fileId 文件id <br>
  49.      *               <a href="https://solution.wps.cn/docs/callback/preview.html#文档用户权限">-详见官方文档-</a>
  50.      */
  51.     @Override
  52.     public UserPermission fetchUserPermission(String fileId) {
  53.         // 解释说明下,这里在实际的设计中,需要将 文件信息 表 和 用户权限 表 分开放
  54.         // 这里为了方便,并没有设计表,返回了所有权限到前端
  55.         // check file exists
  56.         fileService.fetchFile(fileId);
  57.         // 获取user信息,这个方法点进去看看把!!!
  58.         User user = userService.fetchUserByToken();
  59.         // 构建user对应的文件权限
  60.         return UserPermission.builder()
  61.                 .userId(String.valueOf(user.getId()))
  62.                 .read(true)
  63.                 .update(true)
  64.                 .rename(true)
  65.                 .download(true)
  66.                 .copy(true)
  67.                 .comment(true)
  68.                 .history(true)
  69.                 .build();
  70.     }
  71. }
复制代码
文档编辑,单阶段生存,嗯,很简单,如下
  1. /**
  2. * 单阶段文件保存接口
  3. * <p>
  4. * <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>
  5. */
  6. @Service
  7. public class SinglePhaseFileStorageServiceImpl implements SinglePhaseFileStorageService {
  8.     @Autowired
  9.     private UserService userService;
  10.     @Autowired
  11.     private FileService fileService;
  12.     /**
  13.      * 上传文件
  14.      *
  15.      * @param request 上传文件请求
  16.      * @return 文件信息
  17.      * <p>
  18.      * <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>
  19.      */
  20.     @Override
  21.     public FileInfo uploadFile(FileUploadSinglePhase.Request request) {
  22.         // 获取用户信息 -> 这个方法点进去看看 ??!!
  23.         final User user = userService.fetchUserByToken();
  24.         // 保存文件信息
  25.         final File file = Optional.of(request)
  26.                 .map(r -> fileService.fetchFile(request.getFileId()))
  27.                 .map(f -> File.builder()
  28.                         .id(f.getId().copyForNewVersion())
  29.                         .creator(f.getCreator())
  30.                         .createTime(f.getCreateTime())
  31.                         .modifyTime(LocalDateTime.now())
  32.                         .modifier(user)
  33.                         .name(request.getName())
  34.                         .size(request.getSize())
  35.                         // 上传文件获取到URL
  36.                         // --------------------------------
  37.                         // 这里不应该直接保存URL,而是不带domain的uri方便后续迁移等等
  38.                         // 为了方便,就这么弄了
  39.                         // --------------------------------
  40.                         .url(QnFileService.upload(request.getFile()))
  41.                         .build())
  42.                 .map(f -> fileService.repository().save(f))
  43.                 .orElseThrow(FileNotExist::new);
  44.         // 返回文件信息
  45.         return file.toFileInfo();
  46.     }
  47. }
复制代码

这里说明下,单阶段生存,和三阶段生存

  • 单阶段,即直接生存,没有那么多花里胡哨的
  • 三阶段生存

    • 先获取自界说的加密算法
    • 获取到自界说的文件上传接口,同时将文件元信息给到你
    • 当wps背景上传完文件后(通过步调2上传),再调用你的上传完成接口,作为回调,告诉你上传完成的信息



但是
⛔开发者请留意
由于生存接口的升级,单阶段提交将于2024年9月1日起制止新的接入
正在利用单阶段提交的开发者,您仍可继续利用,不受此次升级影响
正在对接单阶段提交的开发者,请留意对接截止时间,保举您对接三阶段生存接口
若关闭单阶段提交代口,则该接口不能被再次开启



此次先给到java的sdk,java-demo以及最简单的html页面来让大家快速对接,如果确实有需要的话,后续我再把官网前端那些对接的,弄个vue的项目,供大家参考,反正闲着也是闲着。。。

嗯,别忘了给v3项目小星星哦!

V3现实效果

和v1效果差不多,只是v3现在有自带的水印

docx 在线预览/编辑

pptx 在线预览/编辑

xlsx 在线预览/编辑

pdf 在线预览/编辑





免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。
回复

使用道具 举报

0 个回复

倒序浏览

快速回复

您需要登录后才可以回帖 登录 or 立即注册

本版积分规则

北冰洋以北

金牌会员
这个人很懒什么都没写!
快速回复 返回顶部 返回列表