ueboot 开源项目教程
1、项目介绍
ueboot 是一个基于 Spring Boot 2 和 Vue 2.0 的基础开发平台,旨在通过提供一套完整的开发框架和最佳实践,帮助开发者快速实现 CRUD 功能的系统。ueboot 结合了 Spring Boot 的后端能力和 Vue 的前端能力,通过 iView UI 提供了一套 CRUD 快速开发 UI 组件,开发者只需配置 JSON 即可完成单表的 CRUD 功能。此外,ueboot 还提供了安全防范措施,如防止 XSS 攻击和 SQL 注入,以及代码生成器,帮助开发者快速生成前后端代码,避免重复劳动。
2、项目快速启动
2.1 环境准备
- Java 8 或更高版本
- Maven 3.x
- Node.js 12.x 或更高版本
- MySQL 5.7 或更高版本
2.2 克隆项目
git clone https://github.com/ueboot/ueboot.git
cd ueboot
2.3 配置数据库
在 ueboot-shiro
模块的 resources/application.yml
文件中,修改数据库连接和 Redis 配置。
spring:
datasource:
url: jdbc:mysql://localhost:3306/ueboot?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai
username: root
password: yourpassword
redis:
host: localhost
port: 6379
2.4 初始化数据库
执行 ueboot-shiro
模块中的 SQL 脚本文件 /resources/sql/ueboot-shiro.sql
,初始化数据库表结构。
2.5 启动前端
cd ueboot-view
npm install
npm run dev
2.6 启动后端
在 IDE 中打开 ueboot-shiro
模块,找到 com.ueboot.shiro.ShiroLocalStartApplication
类,直接右键运行即可。
2.7 访问应用
默认用户名:ueboot
,密码:111111
3、应用案例和最佳实践
ueboot 已经被广泛应用于多个企业级项目中,特别是在需要快速开发 CRUD 功能的场景下。通过 ueboot 提供的代码生成器,开发者可以在几分钟内完成单表的前后端增删改查功能,极大地提高了开发效率。此外,ueboot 还提供了最佳实践的开发约定,如 Maven 模块管理、前后端接口、异常处理、日志和权限管理等,帮助团队协同开发,保持代码规范一致性。
4、典型生态项目
- ueboot-core: 核心模块,包含安全拦截、统一异常处理、数据库查询等功能。
- ueboot-shiro: 权限管理模块,包含了整个权限功能的后端代码和前端页面。
- ueboot-generator: 代码生成器,可以快速生成前后端代码。
- ueboot-ui: 前端 UI 组件,基于 iView UI 提供了一套 CRUD 快速开发组件。
通过这些模块的组合使用,开发者可以快速构建一个功能完善的后台管理系统。