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

说明

  1. v1 版本已经不再更新了,官方也只是提供以前申请下来的账号能继续使用,新申请,需要用到v3了
  2. v3 版本sdk参考 wps-weboffice-sdk-v3, 里面有很详细的注释
  3. v3 集成方法,后端请参考wps-weboffice-v3-demo, 实现你需要对接的接口即可
  4. 使用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.2</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.1</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>
 */
@Service
public 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>
 */
@Service
public 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();
    }
}

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

  1. 单阶段,即直接保存,没有那么多花里胡哨的
  2. 三阶段保存
    • 先获取自定义的加密算法
    • 获取到自定义的文件上传接口,同时将文件元信息给到你
    • 当wps后台上传完文件后(通过步骤2上传),再调用你的上传完成接口,作为回调,告诉你上传完成的信息


但是
⛔开发者请注意

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



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


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


V3实际效果

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


docx 在线预览/编辑


pptx 在线预览/编辑


xlsx 在线预览/编辑


pdf 在线预览/编辑





WebOffice是一款由北京点聚信息技术有限公司提供的完全免费(商业用途也免费)且功能强大的在线Word/excel/wps编辑辅助控件,可以实现: 1.在线编辑Word、Excel、PPT、WPS... ... 2.全面支持MS Office的界面定制,包括对于Office2007的全面支持 3.修订留痕 4.限制打印、保存、复制 5.直接保存到服务器,支持标准Http Post协议 6.强大的书签管理 7.套红、文档保护 8.模板管理 9.其他功能扩展 10.提供开发论坛http://www.dianju.cn/forum/,在其中提供软件更新及问题回答服务 本控件不同于其它同类软件,不是基于微软的开放源码DsoFramer,也不基于OLE,可以解决DsoFramer及其派生产品的一些稳定性问题 本控件不同于其它同类收费软件,本控件完全免费和界面完全可控制。 点聚会定期更新本控件,并解答论坛上的询问,免费不代表免服务,每一个使用者都能得到及时服务。 安装包内包含: 1.WebOffice安装包(仅包含WebOffice控件) 2.WebOffice接口SDK 3.WebOffice网页接口调用例子 4.DES手写及签章系统(Office签章系统)试用。 5.演示章及证书 6.点聚产品白皮书 WebOffice组件可以无缝集成点聚公司的电子签章和手写审批类产品。 点聚信息(http://www.dianju.com.cn)是国内专业的安全和文档中间件软件制造商。公司注重自主知识产权产品的研发,始终坚持技术为本、服务为先的原则,在电子印章、手写签批、安全式文档和电子表单等领域处于国内领先水平。 点聚自主研发的式文件系统独创性的将整个系统缩小为1M大小的组件,并在多项重要技术指标上领先PDF和其它式格式。 点聚支持全系列手写及签章解决方案,可同时提供Office签章系统(Word/Excel/Wps)、网页签章系统、式签章系统. 点聚是国内唯一一家同时拥有国密和军密资质的电子印章及安全文档产品提供商(国密、军密、公安部销售许可)。
评论 28
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

打赏作者

mose-x

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

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

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

打赏作者

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

抵扣说明:

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

余额充值