# FAMS 项目模板 基于 `F:\myeclipse-workspace\wcp`,参照 `F:\idea-workspace\zs.oa` 的平台 JAR + 独立业务项目结构生成。 ## 项目结构 - Maven 坐标:`zbooksoft:fams:1.0.0-SNAPSHOT`,WAR 名称:`fams.war`。 - 业务根包:`zbooksoft.fams`,预留 common、config、controller、dao、data/dto、data/vo、service。 - 平台代码:`src/main/webapp/WEB-INF/lib/com.ruili.wcp.jar`,来自当前 WCP 编译输出,保留 `com.ruili.wcp` 包名。 - 配置及平台 Mapper:`src/main/resources`,使用当前 WCP 版本。 - 业务 Mapper:`src/main/resources/mapper/fams`;业务 SQL:`src/main/resources/sql`。 - 页面及静态资源:`src/main/webapp`,使用当前 WCP 版本。 平台包名、spring-wcp.xml、static/wcp 和平台 Mapper namespace 保持原名称,因为它们是平台内部引用。 业务 Spring 组件、MVC Controller 和 MyBatis DAO 扫描均已加入 `zbooksoft.fams`;Mapper XML 支持子目录。 没有复制 zs.oa 的业务代码、数据库账号、私钥、Git 历史、IDE 设置或旧构建产物。 ## 导入和启动 1. 在 IDEA 中打开本目录的 `pom.xml`,按 Maven 项目导入,Project SDK 选择 JDK 8。 2. 创建独立数据库 `fams`,从已有 WCP 初始化脚本或平台数据库结构备份导入基础表及必要的平台配置数据。本项目没有完整的数据库初始化脚本;WCP 的 db/upgrade 是增量升级脚本,不能单独初始化空库。 3. 修改 `src/main/resources/jdbc.properties`,填写实际数据库账号、密码和连接地址。默认指向 localhost:3306/fams,密码留空。 4. 按部署环境配置平台授权及外部服务(例如文件存储、全文检索、Office 预览)。授权验证沿用 WCP 平台机制。 5. 执行 `mvn -DskipTests package`,将 `target/fams.war` 部署至兼容 javax.servlet 的 Tomcat 8.5/9,访问 `http://localhost:8080/fams/`。IDEA 的 Tomcat 部署上下文同样设为 `/fams`。 构建固定 resources 插件 3.3.1、war 插件 3.4.0,兼容 JDK 8;其余依赖延续当前 WCP。 WEB-INF/lib 中的第三方本地 JAR 与平台 JAR 一并保留,使用与 zs.oa 相同的 Maven system 依赖方式。 ## 开发业务功能 - Controller 放在 `zbooksoft.fams.controller`,服务放在 `zbooksoft.fams.service`。 - Mapper 接口放在 `zbooksoft.fams.dao`,XML 放在 `mapper/fams`,namespace 使用对应接口的完整包名。 - JSP 放在 `src/main/webapp/WEB-INF/view/fams`,Controller 返回视图名称 `fams/页面名`。 - SQL 变更放在 `src/main/resources/sql`,由部署流程按需执行。 ## 更新平台 JAR 在 WCP 项目使用 JDK 8 执行 `mvn -DskipTests compile` 后,将 `target/classes/com` 打包: ```powershell & "$env:JAVA_HOME\bin\jar.exe" cf F:\idea-workspace\fams\src\main\webapp\WEB-INF\lib\com.ruili.wcp.jar -C target\classes com ``` 如完整 compile 被本机 Maven 默认插件或缓存影响,可使用 `mvn -DskipTests compiler:compile` 编译平台代码。 平台 JAR 仅包含平台类;平台升级涉及的 Mapper、Spring 配置、页面和静态资源需同步更新到业务项目,再重新打包。 ## 本次验证 平台 Java 代码已编译成功;生成时已核对平台源码对应的类文件(无注解的 package-info.java 不生成 class)。 数据库初始化、外部服务配置和 Tomcat 实际启动需要部署环境,未连接现有数据库执行验证。 已使用 JDK 8 执行 Maven package,结果 BUILD SUCCESS,输出 target/fams.war;XML 配置和本地 JAR 依赖路径检查通过。 ## IDEA 编译时 ZIP64 报错修复 AspectJ rt/weaver 已统一至 1.9.22,解决 IDEA 自带新 JDK 读取旧版 1.8.9 时的 Invalid CEN header 错误。IDEA 项目 SDK 使用本机已注册的 1.8,语言级别为 Java 8。修改后在 IDEA 执行 Reload All Maven Projects;若仍引用旧依赖,重开项目并 Rebuild Project。新版 AspectJ JAR 已通过 IDEA 自带 JDK 的读取及编译验证。