- Java版SDK&DEMO
- 第一步:创建应用及相关权限申请
- 第二步:下载SDK和DEMO
- SDK获取
- DEMO获取
- 第三步:DEMO试用
- 以Windows为例:
- 第四步:应用开发
- 集成开发环境
- 此DEMO主要包含通过WPS文件选择器获取用户云文档文件,并获取其分享链接进行在线编辑:
- WPS选择器的使用步骤和Js举例使用请参考WPS文件选择器进行接入。
- 文件选择器选择文件后,获取该文件的分享链接的流程操作请参考以下SDK接口进行对接。
- 集成开发环境
- SDK相关接口调用
- SDK接口说明如下:
- 1, 获取分享链接
- 1, 获取分享链接
Java版SDK&DEMO
第一步:创建应用及相关权限申请
请先阅读快速接入模块,开展相关环节。
第二步:下载SDK和DEMO
SDK获取
开发语言 | 资源下载 | 环境要求 |
---|---|---|
Java | SDK | 适用于Java语言、jdk版本1.7以上的环境 |
DEMO获取
开发语言 | 资源下载 | 开发平台 |
---|---|---|
Java | DEMO | Windows |
Java | DEMO | Mac |
第三步: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.解压压缩包,进入demo-wpsdoc下的exec目录,试用DEMO所需的文件都放在这里: nginx-1.15.5为nginx启动及配置目录 server.jar为打包好的DEMO服务 application.Properties为jar包的配置文件 wpsdocdemo模拟了应用中心,旨在调起DEMO首页
2.需要在Application.properites文件中填写已申请的appId和appKey; 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的应用信息:
public static void setConfig(String appid, String appKey);
参数说明
参数 | 参数类型 | 说明 |
---|---|---|
appid | string | 应用唯一标识 |
appKey | string | 应用秘钥 |
调用方式:Config.setConfig(appId, appKey);
SDK接口说明如下:
1, 获取分享链接
public static LinkInfo getFileLinkInfo(String access_token, long fileid);
参数说明
参数 | 参数类型 | 说明 | |
---|---|---|---|
access_token | string | required | access_token |
fileid | int64 | required | 文件id |
调用方式:LinkInfo linkInfo = YunFile.getFileLinkInfo(accessToken, fileId);
有任何疑问,请加入QQ群: 732130805 或者联系open@wps.cn获取帮助。