# PageOffice最简集成代码(VUE+Springboot)
本文描述了PageOffice产品在(VUE+Springboot)前后端分离的项目中如何集成调用。调用PageOffice打开文件的主要核心代码是:后端Springboot项目中第6步和前端VUE项目中第6步的代码,其他代码都属于环境配置代码。
假设开发环境电脑IP为:
192.168.1.100
# 后端Springboot项目
新建Springboot后端项目:springboot-back,在配置文件application.properties中设置项目端口为:8081
server.port=8081
在您项目的pom.xml中通过下面的代码引入PageOffice依赖。pageoffice.jar已发布到Maven中央仓库 (opens new window),建议使用最新版本。
如果使用Tomcat10及以上版本,使用下面的pom.xml配置
<dependency>
<groupId>com.zhuozhengsoft</groupId>
<artifactId>pageoffice</artifactId>
<version>6.0.0.11</version>
</dependency>
如果使用Tomcat9及以下的版本,使用下面的pom.xml配置
<dependency>
<groupId>com.zhuozhengsoft</groupId>
<artifactId>pageoffice</artifactId>
<version>6.0.0.11-javax</version>
</dependency>
新建一个pageoffice文件夹,用来存放PageOffice的系统文件(如license.lic、客户端安装包等),比如windows环境下创建:D:/pageoffice,linux环境下创建:/root/pageoffice
拷贝pageoffice客户端安装程序到上一步创建的pageoffice文件夹下。
- 客户端是windows环境:拷贝posetup_6.0.0.11.exe到pageoffice文件夹下;
- 客户端是国产操作系统环境:拷贝对应芯片的PageOffice客户端deb安装包到pageoffice文件夹下;
PageOffice客户端安装程序下载地址:https://gitee.com/pageoffice/pageoffice6-client/releases (opens new window)
- 打开springboot-back项目的配置文件application.properties,添加一个posyspath变量,值为上一步创建的pageoffice文件夹的路径
server.port=8081
posyspath=D:/pageoffice
- 在您项目的启动类Application类中添加一项@Bean配置,此为PageOffice服务器端的必要配置,代码如下:
@Value("${posyspath}")
private String poSysPath;
@Bean
public ServletRegistrationBean pageofficeRegistrationBean() {
com.zhuozhengsoft.pageoffice.poserver.Server poserver
= new com.zhuozhengsoft.pageoffice.poserver.Server();
poserver.setSysPath(poSysPath);//设置PageOffice注册成功后,license.lic文件存放的目录
ServletRegistrationBean srb = new ServletRegistrationBean(poserver);
srb.addUrlMappings("/poserver.zz");
srb.addUrlMappings("/poclient");
srb.addUrlMappings("/pageoffice.js");
srb.addUrlMappings("/sealsetup.exe");
return srb;
}
- 新建Controller并调用PageOffice在线打开D盘根目录下的test.docx文件,例如DocumentController代码如下:
@RestController
@RequestMapping(value = "/doc")
public class DocumentController {
@RequestMapping(value="/openFile")
public String openFile(HttpServletRequest request) {
PageOfficeCtrl poCtrl = new PageOfficeCtrl(request);
poCtrl.setSaveFilePage("saveFile");
//webOpen的第一个参数支持能够输出下载文件的Url相对地址或者文件在服务器上的磁盘路径两种方式
//查看详细,请在本站搜索“PageOffice属性或方法中涉及到的URL路径或磁盘路径的说明”
poCtrl.webOpen("D:\\test.docx", OpenModeType.docNormalEdit, "张三");
return poCtrl.getHtmlCode();
}
@RequestMapping("/saveFile")
public void saveFile(HttpServletRequest request, HttpServletResponse response) {
FileSaver fs = new FileSaver(request, response);
fs.saveToFile("D:\\" + fs.getFileName());
fs.close();
}
}
# 前端Vue项目
新建Vue前端项目:vue-front
Vue配置代理。
devServer: { proxy: { '/api': { // "/api"对应后端项目"http://192.168.1.100:8081"地址 target: 'http://192.168.1.100:8081', ws: true, changeOrigin: true, pathRewrite: { '^/api': '' } }, } }
在您Vue项目的index.html中引用后端项目中的pageoffice.js文件(后端项目中pageofficeRegistrationBean配置了pageoffice.js文件的访问地址)。
注意
pageoffice.js文件必须来自于后端项目。
<script type="text/javascript" src="/api/pageoffice.js"></script>
- 新建一个Vue页面:src/views/DocView.vue,用来显示在线打开的文档。
<template>
<div class="doc">
演示: 文档<br/><br/>
<!-- 此div用来加载PageOffice客户端控件 -->
<div style="width:auto; height:700px;" v-html="poHtmlCode" ></div>
</div>
</template>
<script>
const axios=require('axios');
export default {
name: 'DocView',
data(){
return {
poHtmlCode: '',
}
},
created: function(){
// 请求后端项目打开文件的controller方法
axios.post("/api/doc/openFile").then((response) => {
this.poHtmlCode = response.data;
}).catch(function (err) {
console.log(err)
})
},
methods:{
OnPageOfficeCtrlInit() {
// PageOffice的初始化事件回调函数,您可以在这里添加自定义按钮
},
AfterDocumentOpened(){
// PageOffice的文档打开后事件回调函数
},
BeforeDocumentSaved() {
// PageOffice的文档保存前事件回调函数
},
AfterDocumentSaved() {
// PageOffice的文档保存后事件回调函数
}
},
mounted: function () {
// 以下的为PageOffice事件的回调函数,名称不能改,否则PageOffice控件调用不到
window.OnPageOfficeCtrlInit = this.OnPageOfficeCtrlInit;
window.AfterDocumentOpened = this.AfterDocumentOpened;
window.BeforeDocumentSaved = this.BeforeDocumentSaved;
window.AfterDocumentSaved = this.AfterDocumentSaved;
}
}
</script>
- 配置DocView.vue的访问路由
const routes = [
// 其他路由配置项…
// 下面添加DocView.vue的路由
,
{
path: ‘/showDoc’,
name: ‘doc’,
component: () => import(‘…/views/DocView.vue’)
}
]
- 在您要打开文件的Vue页面(比如首页)添加一个超链接,点击超链接调用POBrowser对象的openWindow方法,弹出新浏览器窗口访问DocView.vue在线打开文件,代码如下:
<a href=“javascript:POBrowser.openWindow(‘/showDoc’,‘width=1150px;height=900px;’);”>
在线打开文档
</a>
- 启动springboot-back和vue-front项目,点击“在线打开文档”超链接,查看在线打开编辑保存Office文件的效果。
转载: PageOffice最简集成代码(VUE+Springboot)