您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 綜合教學

Jeecg-P3 1.0 發布：基於 Spring MVC 的 Java 插件化開發框架，支持業務組件 JAR 化與獨立部署

編輯：Java 綜合教學

Jeecg-P3 1.0 發布：基於 Spring MVC 的 Java 插件化開發框架，支持業務組件 JAR 化與獨立部署

框架定位

Jeecg-P3 是一款輕量級、插件化的 Java 快速開發框架，核心理念：「業務組件以 JAR 包形式提供，插件模式、鬆耦合、可插拔、支持獨立部署，亦可無縫集成 Jeecg 主平台」。

技術棧

Web 框架：Spring MVC
ORM：MiniDAO（類 MyBatis 輕量封裝）
模板引擎：Velocity（禁用 JSP）
構建工具：Maven 多模塊管理
UI 庫：EasyUI / Bootstrap / zTree

模塊結構

jeecg-p3-parent (聚合父工程)
├── jeecg-p3-web          # 啟動主工程 (WAR/JAR)
├── jeecg-p3-biz-demo     # 插件演示工程 (JAR)
└── jeecg-p3-biz-*        # 其它業務插件 (JAR)

核心特性

特性	說明
插件化架構	業務模塊打包為 JAR，主工程通過 Maven 依賴引入，啟動時自動掃描註冊 Controller/Service/Mapper
Velocity 模板	強制使用 .vm 模板，邏輯與視圖分離，支持指令、宏、佈局復用
MiniDAO	基於 Spring JDBC 封裝，支持注解映射、分頁、動態 SQL，輕於 MyBatis
代碼生成器	根據表結構生成 Entity/Service/DAO/Controller/VM 頁面，支持單表、一對多模型
權限體系	RBAC 模型：用戶-角色-菜單-按鈕-數據權限，集成 Shiro
在線開發	Online Coding：配置表單、列表、查詢無需寫代碼
多租戶/SaaS 就緒	插件隔離、數據權限隔離、獨立部署能力

快速啟動指南

1. 環境準備

JDK 1.8+、Maven 3.6+、MySQL 5.7+、Tomcat 8.5+ / Spring Boot 2.x
IDE：IntelliJ IDEA / Eclipse (安裝 Maven 插件)

2. 數據庫初始化

# 1. 創建數據庫
CREATE DATABASE jeecg_p3 DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

# 2. 執行腳本
source jeecg-p3-web/doc/sql/jeecg-p3-mysql.sql;

3. 配置數據源

# jeecg-p3-web/src/main/resources/dbconfig.properties
jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/jeecg_p3?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=false&serverTimezone=Asia/Shanghai
jdbc.username=root
jdbc.password=123456

4. Maven 安裝插件 (關鍵步驟)

cd jeecg-p3-parent
mvn clean install -DskipTests
# 會將 jeecg-p3-biz-demo 等插件安裝到本地倉庫，主工程依賴才能解析

5. 運行主工程

IDE 運行：啟動 jeecg-p3-web 的 Main 類 / Tomcat 插件 tomcat:run。
命令行：cd jeecg-p3-web && mvn tomcat7:run。

6. 訪問驗證

列表頁：https://localhost:8080/jeecg-p3-web/p3/wxActInvite.do?list
權限頁：https://localhost:8080/jeecg-p3-web/p3/auth.do?list

插件開發流程

創建 Maven Module (jar 打包)，添加 jeecg-p3-web 依賴 (provided)。
編寫 Entity/DAO/Service/Controller，Velocity 模板放在 src/main/resources/vm/。
在主工程 pom.xml 添加依賴：

<dependency>
    <groupId>org.jeecg.p3</groupId>
    <artifactId>jeecg-p3-biz-yourmodule</artifactId>
    <version>1.0.0</version>
</dependency>

執行插件 SQL 腳本（建表、菜單、字典）。
後台配置菜單掛載插件 Controller 路徑。
重啟主工程，插件功能自動掛載生效。

代碼生成器使用

工具類：jeecg-p3-web/src/main/java/util/P3CodeGenerateUtil.java
配置文件：jeecg-p3-web/src/main/resources/p3-cg-config.properties (配置表名、包路徑、作者等)
模板目錄：jeecg-p3-web/src/main/resources/p3/cg/template/ftl/ (FreeMarker 模板，可二次開發)
運行 P3CodeGenerateUtil.main() 即可生成全套代碼至指定目錄。

優缺點評估

優點	缺點/注意點
插件隔離極佳，適合 SaaS 多租戶	Velocity 模板語法學習成本，非主流
代碼生成器覆蓋 80%+ CRUD	MiniDAO 生態較 MyBatis 窄，複雜 SQL 需手寫
輕量啟動快，無冗餘依賴	社區活躍度一般，文檔不夠系統化
無縫集成 Jeecg 主平台	版本升級需注意插件兼容性

總結

Jeecg-P3 以「插件化、輕量、代碼生成」三大核心優勢，為中小型企業級應用、SaaS 產品提供了極具性價比的開發框架選擇。若團隊接受 Velocity 模板、追求極致開發效率與模塊解耦，值得嘗試；若偏好主流技術棧（Thymeleaf/MyBatis Plus/ Spring Boot），可參考其插件化思想自研適配。