• Java版SDK&DEMO
    • 第一步:创建应用及相关权限申请
    • 第二步:下载SDK和DEMO
      • SDK获取
      • DEMO获取
    • 第三步:DEMO试用
      • 以Windows为例:
  • 第四步:应用开发
    • 集成开发环境
      • 此DEMO主要包含通过WPS文件选择器获取用户云文档文件,并获取其分享链接进行在线编辑:
      • WPS选择器的使用步骤和Js举例使用请参考WPS文件选择器进行接入。
      • 文件选择器选择文件后,获取该文件的分享链接的流程操作请参考以下SDK接口进行对接。
  • SDK相关接口调用
  • SDK接口说明如下:
    • 1, 获取分享链接

    Java版SDK&DEMO

    第一步:创建应用及相关权限申请

    请先阅读快速接入模块,开展相关环节。

    第二步:下载SDK和DEMO

    SDK获取

    开发语言资源下载环境要求
    JavaSDK适用于Java语言、jdk版本1.7以上的环境

    DEMO获取

    开发语言资源下载开发平台
    JavaDEMOWindows
    JavaDEMOMac

    第三步:DEMO试用

    DEMO服务的首页地址为: http://demo.cn/wpsdoc/index.html模拟应用中心调起服务的首页地址为: http://demo.cn/wpsdocdemo

    开放平台官网应用基本设置: 填入已申请的APPID和APPKEY IP白名单: 贵公司出口IP 域名白名单:demo.cn 回调地址:调用DEMO服务的地址,即 http://demo.cn/wpsdoc/index.html

    本地配置: 在本地测试运行DEMO需要设置hosts文件 127.0.0.1 demo.cn

    注意: 开放平台官网设置的服务回调地址应与DEMO服务地址一致 若修改回调地址,请同时修改本地hosts、域名白名单以及wpsdocdemo/js/wpsdocindex.js中的redirect_uri回调地址

    以Windows为例:

    1. 1.解压压缩包,进入demo-wpsdoc下的exec目录,试用DEMO所需的文件都放在这里: nginx-1.15.5nginx启动及配置目录 server.jar为打包好的DEMO服务 application.Propertiesjar包的配置文件 wpsdocdemo模拟了应用中心,旨在调起DEMO首页
    2. 2.需要在Application.properites文件中填写已申请的appIdappKey; 3.需要在wpsdocdemo/js/wpsdocindex.js中填写已申请的appId,并查看redirect_uri回调地址是否与官网设置一致; 4.需要在nginx-1.15.5文件夹下的nginx.conf中配置nginx访问根路径,将C:/demo-wpsdoc/exec修改为当前exec目录; 5.nginx-1.15.5文件夹下,运行nginx.exe启动nginx; 6.在当前目录下打开shell环境,输入java -jar server.jar启动DEMO服务; 7.在浏览器上输入 [http://demo.cn/wpsdocdemo](uploads/projects/436/6366.png) **Mac版的使用方式除了更换适应平台的nginx外,其余步骤基本一致,详情请参考压缩包中的使用指南。如若不能正常运行,请联系open@wps.cn.**

    第四步:应用开发

    该模块将详细介绍demo的集成和涉及的SDK接口调用详解,可参考该部分打造属于您自己的应用,剖析如下:

    集成开发环境

    进入压缩包的的源码文件夹,用IntelliJ IDEA开发工具导入OpenWPSDoc文件夹下代码即可。其中: 1. Gradle版本用gradle-2.2.1及以上版本,JDK使用JDK1.7及以上版本, 2. 依赖Jar包opensdk-1.0.jar在工程的libs目录下,导入工程时会自动导入, 3. Demo前端代码在src\main\resources\static\wpsdoc目录下,前端代码建议使用JetBrains WebStorm导入后再编辑, 4. 在application.properties中配置好server.port、appid以及appkey参数, 5. 在Application.java文件中启动工程, 6. 控制台出现类似如下信息表示工程启动成功:Started Application in 3.489 seconds (JVM running for 4.135)。

    此DEMO主要包含通过WPS文件选择器获取用户云文档文件,并获取其分享链接进行在线编辑:
    WPS选择器的使用步骤和Js举例使用请参考WPS文件选择器进行接入。
    文件选择器选择文件后,获取该文件的分享链接的流程操作请参考以下SDK接口进行对接。

    SDK相关接口调用

    注意: 在调用SDK的文件相关接口前,需要先配置SDK的应用信息:

    1. public static void setConfig(String appid, String appKey);

    参数说明

    参数参数类型说明
    appidstring应用唯一标识
    appKeystring应用秘钥

    调用方式:Config.setConfig(appId, appKey);

    SDK接口说明如下:

    1, 获取分享链接

    1. public static LinkInfo getFileLinkInfo(String access_token, long fileid);

    参数说明

    参数参数类型说明
    access_tokenstringrequiredaccess_token
    fileidint64required文件id

    调用方式:LinkInfo linkInfo = YunFile.getFileLinkInfo(accessToken, fileId);

    有任何疑问,请加入QQ群: 732130805 或者联系open@wps.cn获取帮助。