6.x升级到6.6的升级说明(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"
         *      (如"www.oa.com,192.168.1.100")
         */
    return servletContext ->
        servletContext.setInitParameter("powserver-allowedOrigins", "*");
}

4.为 powserver 请求配置完全开放访问权限。请参照 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相关客户端安装程序。

部署阶段：

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

集群部署阶段：

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