6.x升级到6.6的升级说明(Vue+Springboot)

后端项目

1. 升级PageOffice后端jar，在pom.xml中配置如下：

• 如果是Springboot2，或tomcat9及以下版本：

<dependency>
  <groupId>com.zhuozhengsoft</groupId>
  <artifactId>pageoffice</artifactId>
  <version>6.6.1.3-javax</version>
</dependency>

• 如果是Springboot3，或tomcat10及以上版本：

<dependency>
  <groupId>com.zhuozhengsoft</groupId>
  <artifactId>pageoffice</artifactId>
  <version>6.6.1.3</version>
</dependency>

2. 新增对websocket的引用，在当前项目pom.xml中添加：

  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-websocket</artifactId>
  </dependency>

3. 新增powserver相关配置,在当前项目启动类比如App.java中添加：

/**
 * 使用 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地址,后端地址" 
      *      (如"ui.example.com,192.168.1.1,localhost")
      *    - 单体多入口："域名,ip"
      *      (如"www.oa.com,192.168.1.100")
      */
    return servletContext ->
            servletContext.setInitParameter("powserver-allowedOrigins", "*");
}

4. 配置powserver完全开放访问权限,将powserver请求从后端拦截器SpringSecurity或者Shiro等授权认证校验框架中放出来。具体代码位置请参考在原有的poserver.zz请求开放完全访问权限的代码基础上再新增对powserver请求配置完全开放访问权限。

• SpringSecurity

.antMatchers("/powserver").permitAll()

• Shiro

filterChainDefinitionMap.put("/powserver", "anon");

5. 将posetup_6.6.1.3.exe和com.zhuozhengsoft.pageoffice_6.6.1.3_amd64.deb等安装包拷贝到当前服务器对应的license.lic目录下，并删除旧的PageOffice相关客户端安装程序。

前端项目

1. 升级js-pageoffice的版本，在package.json中配置如下：

 "js-pageoffice": "6.6.1",

注意

修改 package.json 中的 js-pageoffice 版本后，请运行 npm install 使更改生效。

2. 新增powserver相关配置。

• Vue3下在vite.config.js中添加如下配置：

  proxy: { 
    // 项目原有的通用代理配置
    "/dev-api": {
      target: "http://localhost:8081",
      changeOrigin: true,
      rewrite: (path) => path.replace(/^\/dev-api/, ""),
      ws: true, //v6.6+必须，启用websocket。
    },
  },
  

• vue2下在vue.config.js中添加如下配置：

  proxy: {
    // 项目原有的通用代理配置
    "/dev-api": {
      target: "http://localhost:8081",
      ws: true, //v6.6+必须，启用websocket。
      changeOrigin: true, 
      pathRewrite: {
        "^/dev-api": "",
      },
    },
  },
  

部署阶段：

nginx部署时，新增支持WebSocket的配置。详细步骤可参考：Nginx普通部署(v6.6+)

集群部署阶段：

集群（负载均衡）部署时，比如nginx集群部署时，新增支持WebSocket的配置。详细步骤可参考：Nginx集群部署(v6.6+)