本项目在原eladmin项目的基础上,进行了部分扩展及尝试,在此表示感谢。
本分支将停留在17版本,待22年底Spring 6.x Release后,试着整合。另将在dev_3.x
分支,尝试后续版本的JDK
启动类 AppRun.java 和配置文件 resources 详见 eladmin-starter 模块。启停脚本。注:模块化当前只支持研发模式,要打包部署需要将module-info.java 删除,以非module化运行。
Java16之后,默认强封装JDK内部类,详见JEP 396 JEP 403 ,需在启动时添加相关参数开启包访问。较简单的是添加
--add-opens java.base/java.lang=ALL-UNNAMED
,也可根据需要缩小范围(在Java 9引入的JPMS。在对项目完成相关改造之前(当前未找到jar启动的方式),应该只能用ALL-UNNAMED表示对所有未命名模块开放)。
详见:Java 16 Java 17
后台运行jar(开启远程调试端口5005)。2>&1 表示在同一个文件中同时捕获 System.err和 System.out(有一个箭头的表示以覆盖的方式重定向,而有两个箭头的表示以追加的方式重定向。如果需要将标准输出以及标准错误输出同时重定向到一个文件,需要将某个输出转换为另一个输出,例如 2>&1 表示将标准错误输出转换为标准输出)。
nohup java --add-opens java.base/java.lang=ALL-UNNAMED -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005 -jar eladmin-starter-3.0.0.jar >nohup.out 2>&1 &
若外置依赖启动参数需添加,-Dloader.path=lib
引入依赖。外置依赖可以大大减少jar包的体积。方便后续更新部署
#启动示例
nohup java --add-opens java.base/java.lang=ALL-UNNAMED -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005 -Dloader.path=lib -jar eladmin-starter-3.0.2.jar >nohup.out 2>&1 &
#在未来的3.x版本开始,因为已完成JPMS改造,可移除启动参数中 --add-opens 部分
nohup java -XX:+UseZGC -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005 -Dloader.path=lib -jar eladmin-starter-3.0.3.jar >nohup.out 2>&1 &
key | 目的 |
---|---|
loader.path | lib包加载路径 |
loader.home | 用于解析loader.path中的相对路径。 例如,给定loader.path = lib,则$ {loader.home} / lib是类路径位置(以及该目录中的所有jar文件)。 此属性还用于查找loader.properties文件,如以下示例/ opt / app所示。它默认为$ {user.dir}。 |
loader.args | main方法的默认参数(以空格分隔) |
loader.main | 要启动的主类的名称(例如com.app.Application) |
loader.config.name | 属性文件的路径(例如,classpath:loader.properties)。 默认为loader.properties。 |
loader.system | 布尔值标志,指示应将所有属性添加到系统属性。 默认为false。 |
可根据需要选择版本
<!--2.6.18版本为springfox + 未进行动态权限改造-->
<!-- https://mvnrepository.com/artifact/com.lwohvye/eladmin -->
<dependency>
<groupId>com.lwohvye</groupId>
<artifactId>eladmin</artifactId>
<version>2.6.18</version>
<type>pom</type>
</dependency>
<!--3.x系列版本为springdoc + 动态权限改造 + JPMS部分改造-->
<dependency>
<groupId>com.lwohvye</groupId>
<artifactId>eladmin</artifactId>
<version>3.0.3</version>
<type>pom</type>
</dependency>
一个基于最新的Java 17版本、 Spring Boot 2.7、 Jpa、 JWT、Spring Security、Redis、ShardingSphere、RabbitMQ、Vue的前后端分离的管理系统
- 使用最新技术栈,社区资源丰富,基于Java 17、Spring Boot 2.7。
- 高效率开发,代码生成器可一键生成前后端代码
- 基于注解的动态查询(Specification),可根据需要扩充查询注解。
- 支持数据字典,可方便地对一些状态进行管理
- 支持接口限流,避免恶意请求导致服务层压力过大
- 支持接口级别的功能权限与数据权限,可自定义操作
- 自定义权限注解与匿名接口注解,可快速对接口拦截与放行
- 对一些常用前端组件封装:表格数据请求、数据字典等
- 前后端统一异常拦截处理,统一输出异常,避免繁琐的判断
- 提供服务器性能监控功能
- 支持运维管理,可方便地对远程服务器的应用进行部署与管理
- 使用ShardingSphere实现多数据源和读写分离。该方式针对Mysql数据库。对系统侵入性小。(只需引入依赖,并在yaml中配置数据源信息即可)。
- 整合Redisson拓展Redis的功能,读写分离
- 整合消息队列RabbitMQ,实现消息通知、延迟消息。
- 用户管理:提供用户的相关配置,新增用户后,默认密码为123456
- 角色管理:对权限与菜单进行分配,可根据部门设置角色的数据权限
- 菜单管理:已实现菜单动态路由,后端可配置化,支持多级菜单
- 部门管理:可配置系统组织架构,树形表格展示
- 岗位管理:配置各个部门的职位
- 字典管理:可维护常用一些固定的数据,如:状态,性别等
- 系统日志:记录用户操作日志与异常日志,方便开发人员定位排错
- SQL监控:采用druid 监控数据库访问性能,默认用户名admin,密码123456
- 定时任务:整合Quartz做定时任务,加入任务日志,任务运行情况一目了然
- 代码生成:高灵活度生成前后端代码,减少大量重复的工作任务
- 邮件工具:配合富文本,发送html格式的邮件
- 阿里云OSS:可实现基础的上传及下载功能
- 阿里短信通道SMS:可实现基础的发送短信功能
- 服务监控:监控服务器的负载情况
- 运维管理:一键部署你的应用
项目采用按功能分模块的开发方式,结构如下
-
eladmin-common
系统的公共模块,各种工具类,公共配置存在该模块 -
eladmin-api
基础实体及API,方便后续服务拆分 -
eladmin-system
系统核心模块,包含管理侧权限配置等。 -
eladmin-logging
系统的日志模块,其他模块如果需要记录日志需要引入该模块 -
eladmin-tools
第三方工具模块,包含:邮件、OSS、SMS、本地存储 -
eladmin-generator
系统的代码生成模块,代码生成的模板在 system 模块中。这部分待优化 -
eladmin-starter
启动类,项目入口,包含模块及组件配置,枚举类动态扩展的简单demo -
eladmin-search
通过mongodb进行最基础的检索,整合elasticsearch,SPI相关demo
- eladmin-common 公共模块
- annotation 为系统自定义注解
- aspect 自定义注解的切面
- base 提供了Entity、Service、DTO基类和mapstruct的通用mapper
- config 自定义权限实现、redis配置、openApi配置、Rsa配置等
- exception 项目统一异常的处理
- utils 系统通用工具类
- eladmin-api 基础实体及DTO
- annotation 为模块自定义注解
- modules 基础实体及接口定义
- utils 通用工具类扩展
- eladmin-system 系统核心模块
- config 配置跨域、静态资源、数据权限、DB Insert主键、实体表映射、系统完成入口
- thread 线程池相关
- rabbitmq 消息队列相关
- modules 系统相关模块(登录授权、消息队列、系统监控、定时任务、运维管理等)
- eladmin-starter 系统启动入口。相关示例
- eladmin-logging 系统日志模块
- eladmin-tools 系统第三方工具模块
- eladmin-generator 系统代码生成模块
- Java 17 基础运行环境
- Mysql 5.7/8.0 数据库 读写分离/单数据源-通过配置数据源的方式切换
- Redis 6.0 缓存
- RabbitMQ 发布-订阅(解耦、异步)
- ELK 日志系统,若不需要可调整logback-spring.xml中的配置
- 可基于docker 一键搭建。当然目录还是要自己建的,另外RabbitMQ记得装延迟插件,ES记得装IK
- 若想搭建k8s版,可参照 ,这个是基于NFS挂载的。
-
感谢 JetBrains 提供的非商业开源软件开发授权
-
感谢 PanJiaChen 大佬提供的前端模板
-
感谢 Moxun 大佬提供的前端 Curd 通用组件
-
感谢 zhy6599 大佬提供的后端运维管理相关功能
-
感谢 j.yao.SUSE 大佬提供的匿名接口与Redis限流等功能
-
感谢 d15801543974 大佬提供的基于注解的通用查询方式
-
感谢 elunez 大佬提供的eladmin项目
- dev_3.0 Springdoc相关。Web侧跟进(无限delay)
- ASM字节码增强
- 授权(Authorization)模块-颁发及刷新Token (accessToken & refreshToken)Jwt Token 都是成对出现的,一个为平常请求携带的 accessToken, 另一个只作为刷新 accessToken 用的 refreshToken
- dev_3.0 JPMS改造(3.0版本有做部分尝试,当前在IDEA中可启动,当下无法打包成功(3.0版本时明明可以打包成功的,只是启动不起来),也未找到jar包的启动方式,故暂缓,可能要等到Spring 6.x 及 Spring Boot 3.X对 JPMS相关支持及Java 17了)