本文描述了PageOffice产品在Springboot项目中如何集成调用。（本示例使用了Thymeleaf模板引擎）
1. 新建Springboot项目：pageoffice6-springboot2-simple
2. 在您项目的pom.xml中通过下面的代码引入PageOffice依赖。pageoffice.jar已发布到[Maven中央仓库](https://mvnrepository.com/artifact/com.zhuozhengsoft/pageoffice)，建议使用最新版本。
	如果使用Springboot3，或Tomcat10及以上版本，使用下面的pom.xml配置
```xml
<dependency>
  <groupId>com.zhuozhengsoft</groupId>   
  <artifactId>pageoffice</artifactId>   
  <version>6.6.1.3</version>
</dependency>
<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-websocket</artifactId>
</dependency>
```
如果使用Springboot2，或Tomcat9及以下的版本，使用下面的pom.xml配置
```xml
<dependency>
  <groupId>com.zhuozhengsoft</groupId>   
  <artifactId>pageoffice</artifactId>   
  <version>6.6.1.3-javax</version>
</dependency>
<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-websocket</artifactId>
</dependency>
```
3. 新建一个pageoffice文件夹，用来存放PageOffice的系统文件（如license.lic、客户端安装包等），比如windows环境下创建：D:/pageoffice，linux环境下创建:/root/pageoffice
4. 拷贝pageoffice客户端安装程序到上一步创建的pageoffice文件夹下。
	- 客户端是windows环境：拷贝posetup_6.6.1.3.exe到pageoffice文件夹下；
	- 客户端是国产操作系统环境：拷贝对应芯片的PageOffice客户端deb安装包到pageoffice文件夹下；

>PageOffice客户端安装程序下载地址：[https://www.zhuozhengsoft.com/dowm/(opens new window)](https://www.zhuozhengsoft.com/dowm/)

5. 打开springboot项目的配置文件application.properties，添加一个posyspath变量，值为上一步创建的pageoffice文件夹的路径
```
posyspath=D:/pageoffice
```
6. 在您项目的启动类Application类中添加一项@Bean配置，此为PageOffice服务器端的必要配置，代码如下：
```java
@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;
}

// PageOffice V6.6及以上版本新增以下代码（V6.5及之前版本无需此代码）
// --------------------------------------------------------------

/**
 * 使用 SpringBoot 内嵌容器（Jar包部署）必须注册该 Bean；使用外部独立容器（War包部署）无需注册。
 * PageOffice WebSocket 的 ServerEndpointExporter
 */
@Bean
public ServerEndpointExporter serverEndpointExporter() {
    ServerEndpointExporter exporter = new ServerEndpointExporter();
    exporter.setAnnotatedEndpointClasses(
            com.zhuozhengsoft.pageoffice.poserver.WServer.class
    );
    return exporter;
}
@Bean
public ServletListenerRegistrationBean powContextListener() {
    return new ServletListenerRegistrationBean<>(new POWContextListener());
}
@Bean
public ServletContextInitializer pageofficeContextParams() {
    /*
         * powserver跨域安全配置：
         * 1. 生产环境不推荐使用"*"，建议明确指定允许的域名/IP
         * 2. 格式：多个地址用逗号分隔，如"域名1,域名2,IP"。注意：本地开发环境地址(localhost,127.0.0.1)也必须在此配置
         * 3. 示例:
         *    - 单体多入口："域名,ip"
         *      (如"www.oa.com,192.168.1.100")
         */
    return servletContext ->
        servletContext.setInitParameter("powserver-allowedOrigins", "*");
}
```
7. 在D盘根目录下准备一个有内容的test.docx文件，新建Controller并调用PageOffice在线打开此文件，例如SimpleWordController代码如下：
```java
@Controller
@RequestMapping(value = "/simpleWord")
public class SimpleWordController {  
    
  @RequestMapping(value="/openFile")
  public String openFile(HttpServletRequest request) {
      PageOfficeCtrl poCtrl = new PageOfficeCtrl(request);
      //webOpen的第一个参数支持能够输出下载文件的Url相对地址或者文件在服务器上的磁盘路径两种方式
      //查看详细，请在本站搜索“PageOffice属性或方法中涉及到的URL路径或磁盘路径的说明”
      poCtrl.webOpen("D:\\test.docx", OpenModeType.docNormalEdit, "张三");
      request.setAttribute("poHtmlCode", poCtrl.getHtml());
      return  "simpleWord";
  }
    
  @RequestMapping("/saveFile")
  public void saveFile(HttpServletRequest request, HttpServletResponse response) {
      FileSaver fs = new FileSaver(request, response);
      fs.saveToFile("D:\\" + fs.getFileName());
      fs.close();
  }
    
}
```
8. 为上一步代码中的openFile方法准备Thymeleaf模板：simpleWord.html，代码如下：
```html
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>最简单的打开保存文件</title>
</head>
<body>
<div style="width:100%; height:800px;"  th:utext="${poHtmlCode}"></div>
<script>
    function Save() {
        //使用SaveFilePage属性设置后端保存方法的Controller路由地址，这个地址必须从"/"开始
        pageofficectrl.SaveFilePage = "/simpleWord/saveFile";
        pageofficectrl.WebSave();
    }
    function OnPageOfficeCtrlInit() {
        pageofficectrl.AddCustomToolButton("保存", "Save", 1);
    }
</script>
</body>
</html>
```
9. 在需要点击超链接实现在线打开文件的页面（比如：index.html）中添加pageoffice.js文件的引用。

```html
<script type="text/javascript" src="/pageoffice.js"></script>
```
10. 然后在页面中添加一个超链接，点击超链接调用POBrowser对象的openWindow方法，弹出新浏览器窗口访问`simpleWord/openFile`在线打开文件，代码如下：

```html
<a href="javascript:POBrowser.openWindow('simpleWord/openFile','width=1150px;height=900px;');">
    在线打开文档
</a>
```
11. 启动项目，点击“在线打开文档”超链接，查看在线打开编辑保存Office文件的效果。
![image.png](https://developer.qcloudimg.com/http-save/yehe-8580977/73441c143887d6639607324fa5db460c.png)
原文地址https://www.pageoffice.cn/pages/f8e4fe/

本文描述了PageOffice产品在Springboot项目中如何集成调用。（本示例使用了Thymeleaf模板引擎）

Springboot集成PageOffice的最简步骤

PageOffice作为一种文档控件，集成到Web系统后成为其不可分割的一部分，确保了文档处理功能的稳定性和可靠性，同时文档的安全性和隐私保护完全由Web系统掌控，能够更好地满足政府和企业对数据安全的严格要求

数据库

PageOffice在Springboot项目中的集成调用方法，包括Maven依赖配置、系统文件存放路径设置、启动类配置、Controller编写及Thymeleaf模板使用。详细步骤涵盖从项目创建到在线打开编辑Office文件的全过程，适用于Springboot2/3和不同Tomcat版本。

热销域名限时优惠，新客首年免费！


domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Springboot集成PageOffice的最简步骤-腾讯云开发者社区-腾讯云

Springboot集成PageOffice的最简步骤

Springboot集成PageOffice的最简步骤

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐