在线编辑、预览、基于wps web office，v3版强势来袭（已适配solon）

置顶 mose-x

已于 2025-01-11 23:29:38 修改

阅读量8.1k

点赞数 33

分类专栏： java 文章标签： wps

于 2024-05-06 22:51:35 首次发布

本文链接：https://blog.csdn.net/qq_23501739/article/details/138510874

版权

java 同时被 2 个专栏收录

20 篇文章

订阅专栏

wps

1 篇文章

订阅专栏

说明

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.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();
    }
}