前后端分离VUE3+Springboot项目集成PageOffice核心代码

后端Springboot项目

1. 在项目的pom.xml中通过下面的代码引入PageOffice依赖。pageoffice.jar已发布到Maven中央仓库，建议使用最新版本。

<dependency>
  <groupId>com.zhuozhengsoftgroupId>   
  <artifactId>pageofficeartifactId>   
  <version>6.3.3.1-javaxversion>
dependency>

2. 在项目的启动类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("/sealsetup.exe");
  return srb;
}

3. 新建Controller并调用PageOffice在线打开文件，例如DocumentController代码如下：

@RestController
@RequestMapping(value = "/doc")
public class DocumentController {
	//获取doc目录的磁盘路径，比如，Linux服务器的Office文件存放路径为：/root/documents/
	private String dir = "/root/documents/";

	@RequestMapping(value="/openFile")
	public String openFile(HttpServletRequest request, String file_name)  {
		PageOfficeCtrl poCtrl = new PageOfficeCtrl(request);
		//webOpen的第一个参数支持能够输出下载文件的Url相对地址或者文件在服务器上的磁盘路径两种方式
		//查看详细，请在"https://www.pageoffice.cn/"搜索“PageOffice属性或方法中涉及到的URL路径或磁盘路径的说明”
		poCtrl.webOpen("file://"+dir+file_name, OpenModeType.docNormalEdit, "张三");
		return poCtrl.getHtml();//必须
	}

	@RequestMapping("/saveFile")
	public void saveFile(HttpServletRequest request, HttpServletResponse response)  {
		FileSaver fs = new FileSaver(request, response);
		fs.saveToFile(dir + file_name);
		fs.close();
	}
}

前端vue项目

1. 引用js-pageoffice库。
   使用命令安装：npm install [email protected] --save-exact

注意：请确保安装的js-pageoffice库版本号与后端项目pom.xml文件中引用的PageOffice JAR包版本号的前三位相同。

2. 在全局拦截器中添加PageOffice相关配置。

   import axios from "axios";
   import { POBrowser } from "js-pageoffice";
   
   // 创建 axios 实例
   const service = axios.create({
    baseURL: "/dev-api", // 设置你的基础 URL
    timeout: 5000, // 设置请求超时时间
   });
   // 请求拦截器
   service.interceptors.request.use(
     (config) => {
       // 在发送请求之前做些什么
       //const token = Cookies.get('token'); // 假设你的token存储在cookie中
       const token = "123";
       if (token) {
         config.headers["Authorization"] = "Bearer " + token; // 将token添加到请求头中
         // PageOffice全局配置，必须在此拦截器中定义
         //必须。设置后端代理,具体属性值以您实际开发为准,比如POBrowser.setProxyBaseAPI(process.env.VUE_APP_BASE_API);
         POBrowser.setProxyBaseAPI("/dev-api");
         //必须。向PageOffice后端请求设置header，支持多次调用setHeader()设置更多的值，具体属性名称和属性值以您实际开发为准。
         POBrowser.setHeader("Authorization", "Bearer " + token); 
         /**
          * 前端存储token的方案
          *方案1.使用Cookie
          *如果您的令牌(token)存储在Cookie中，PageOffice会默认支持通过Cookie方式保存令牌，因此您无需编写任何额外的代码。
          *方案2.使用Localstorage或者SessionStorage
          *如果令牌(token)是保存在LocalStorage或SessionStorage中，您必须调用POBrowser.setStorage()方法。
          */
         //POBrowser.setStorage("Admin-Token",getToken());//支持多次调用setStorage()设置更多的值，具体属性名称和属性值以您实际开发为准。
       }
   
       return config;
     },
     (error) => {
       // 对请求错误做些什么
       return Promise.reject(error);
     }
   );
   

3. 新建一个Vue页面：src/views/DocView.vue，用来显示在线打开的文档。

4. 比如配置DocView.vue的访问路由为：/showDoc，在您的Vue页面（比如HomeView.vue，PageOffice中把这个页面称之为父页面）添加一个打开文件的超链接，点击超链接调用POBrowser对象的openWindow方法，弹出PageOffice浏览器（POBrowser）窗口访问DocView.vue在线打开文件，代码如下：

    打开文件

详细请参考：https://pageoffice.cn/pages/1c2c6e/