Charles7c
ec28705b6f
style: 优化常量命名风格,XxxConsts => XxxConstants
2023-11-22 23:06:50 +08:00
Charles7c
f4c0919eda
refactor: 优化部分使用类的引用路径
2023-11-21 22:22:07 +08:00
Charles7c
8dbec9d1a3
fix: 修复合并冲突后的若干错误
...
1.完善 @Serial
2.完善 javax => jakarta
3.修复 canAccess() 使用错误
4.兼容 JustAuth Spring Boot Starter
5.CI 脚本更新 JDK 8 => 17
2023-11-05 10:41:26 +08:00
Charles7c
51e1cd9307
Merge remote-tracking branch 'origin/2.0.x' into dev
...
# Conflicts:
# README.md
# continew-admin-common/src/main/java/top/charles7c/cnadmin/common/base/BaseReq.java
# continew-admin-common/src/main/java/top/charles7c/cnadmin/common/base/BaseServiceImpl.java
# continew-admin-common/src/main/java/top/charles7c/cnadmin/common/handler/GlobalExceptionHandler.java
# continew-admin-common/src/main/java/top/charles7c/cnadmin/common/util/ExceptionUtils.java
# continew-admin-common/src/main/java/top/charles7c/cnadmin/common/util/helper/QueryHelper.java
# continew-admin-monitor/src/main/java/top/charles7c/cnadmin/monitor/interceptor/LogInterceptor.java
# continew-admin-system/src/main/java/top/charles7c/cnadmin/system/model/req/DeptReq.java
# continew-admin-system/src/main/java/top/charles7c/cnadmin/system/model/req/MenuReq.java
# continew-admin-system/src/main/java/top/charles7c/cnadmin/system/model/req/RoleReq.java
# continew-admin-system/src/main/java/top/charles7c/cnadmin/system/service/impl/DeptServiceImpl.java
# continew-admin-system/src/main/java/top/charles7c/cnadmin/system/service/impl/RoleServiceImpl.java
# continew-admin-system/src/main/java/top/charles7c/cnadmin/system/service/impl/UserServiceImpl.java
# continew-admin-ui/src/components/footer/index.vue
# continew-admin-webapi/src/main/java/top/charles7c/cnadmin/webapi/controller/common/CommonController.java
# continew-admin-webapi/src/main/java/top/charles7c/cnadmin/webapi/controller/system/UserCenterController.java
# continew-admin-webapi/src/main/resources/config/application-dev.yml
# continew-admin-webapi/src/main/resources/config/application-prod.yml
# pom.xml
2023-11-04 23:57:06 +08:00
Charles7c
87f90567db
refactor: 💥 调整后端请求、响应参数模型命名风格
...
XxxRequest => XxxReq
XxxVO => XxxResp
2023-11-04 17:19:00 +08:00
Charles7c
3a176ac5ef
style: 优化部分代码格式及注释
2023-10-10 22:37:24 +08:00
Charles7c
3a3a5d6b71
refactor: 公告类型适配字典数据
...
1.新增 <dict-tag> 自定义组件,用于回显字典标签
2.重构 useDict 方法,支持查询字典数据
3.优化部分字典相关数据类型
2023-09-17 13:26:14 +08:00
Charles7c
b3b6446433
refactor: 💥 分离 HTTP 状态码和业务状态码
...
1.传输正常的情况下无论业务是否有异常,HTTP 状态码始终为 200
2.防止非 HTTPS 情况下出现运营商劫持(例如:404)
2023-09-10 22:35:50 +08:00
Charles7c
31f0abbae2
fix: 修复是否为管理员判断错误
2023-09-06 20:11:50 +08:00
Charles7c
be394f3de4
style: 优化登录用户信息角色相关信息命名
...
1.roles => roleCodes
2.roleSet => roles
2023-09-02 00:12:45 +08:00
Charles7c
bfea689b0e
refactor: 优化分页总记录数数据类型
2023-09-01 00:36:56 +08:00
Charles7c
015ff5512b
fix: 修复在线用户列表等自定义分页查询 NPE 的问题
2023-09-01 00:35:43 +08:00
Charles7c
58e838d5f9
docs: 完善接口文档信息
2023-08-23 21:44:12 +08:00
Charles7c
90e1c64db6
refactor: 将全局异常处理器未知异常的异常类型从 Exception 调整为 Throwable
2023-08-15 23:36:26 +08:00
Charles7c
487fa82306
style: 优化 == 及 != 表达式格式
...
1.将 null 或常量值调整到符号左侧
2.将无特殊意义的方法判空写法改为表达式判断写法
2023-08-15 23:31:50 +08:00
Charles7c
fa916b9324
refactor: 将时间戳单位从毫秒调整为秒
...
时间戳是指格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒)起至现在的总秒数。通俗的讲,时间戳是一份能够表示一份数据在一个特定时间点已经存在的完整的可验证的数据。它的提出主要是为用户提供一份电子证据,以证明用户的某些数据的产生时间。在实际应用上,它可以使用在包括电子商务、金融活动的各个方面,尤其可以用来支撑公开密钥基础设施的“不可否认”服务。
2023-08-15 00:31:48 +08:00
Charles7c
a61196cd62
refactor: 将验证码唯一标识格式从无符号 UUID 调整为带符号 UUID
2023-08-15 00:26:05 +08:00
Charles7c
190385ed36
docs: 完善公共模块相关接口文档信息
2023-08-15 00:23:58 +08:00
Charles7c
9def265af6
docs: 完善代码生成相关接口文档信息
2023-08-12 23:33:58 +08:00
Charles7c
76c65463c2
refactor: 移除所有的 @Accessors(chain = true),并全局配置禁止使用
2023-08-11 23:59:44 +08:00
Charles7c
bb6f47cfd2
feat: 新增系统工具模块(存放系统工具模块相关功能,例如:代码生成、文件管理等)
2023-08-05 00:08:41 +08:00
Charles7c
668124591e
Merge branch '1.0.x' into dev
...
# Conflicts:
# continew-admin-common/src/main/java/top/charles7c/cnadmin/common/base/BaseController.java
2023-07-19 23:17:39 +08:00
Charles7c
76f04dd38f
fix: 优化分页总记录数数据类型
2023-07-05 22:07:59 +08:00
Charles7c
3738fa4872
Merge branch 'dev' into 2.0.x
...
# Conflicts:
# continew-admin-common/src/main/java/top/charles7c/cnadmin/common/model/query/SortQuery.java
# continew-admin-monitor/src/main/java/top/charles7c/cnadmin/monitor/model/query/LoginLogQuery.java
# continew-admin-monitor/src/main/java/top/charles7c/cnadmin/monitor/model/query/OperationLogQuery.java
# continew-admin-monitor/src/main/java/top/charles7c/cnadmin/monitor/model/query/SystemLogQuery.java
# continew-admin-system/src/main/java/top/charles7c/cnadmin/auth/model/query/OnlineUserQuery.java
# continew-admin-system/src/main/java/top/charles7c/cnadmin/system/model/query/DeptQuery.java
# continew-admin-system/src/main/java/top/charles7c/cnadmin/system/model/query/MenuQuery.java
# continew-admin-system/src/main/java/top/charles7c/cnadmin/system/model/query/RoleQuery.java
# continew-admin-system/src/main/java/top/charles7c/cnadmin/system/model/query/UserQuery.java
2023-04-13 22:36:57 +08:00
Charles7c
ae8d294705
refactor: 优化 springdoc-openapi 对象型参数处理
...
1.使用 default-flat-param-object 全局设置对象型参数展示形式。此设置是在 springdoc-openapi v1.6.11 版本开始添加的新特性(详情请参阅:https://github.com/springdoc/springdoc-openapi/pull/1805),在此之前,只能在所有需要处理的对象型参数类上使用 @ParameterObject,工作量较大。
2.作者在使用上方这个配置时还遇到了一个 Bug,那就是只要在对象型参数前使用了注解,例如:@Validated PageQuery pageQuery,这个配置就不会生效了。此问题已在 GitHub 提交了相应 issue(详情请参阅:https://github.com/springdoc/springdoc-openapi/issues/2181),并且 springdoc-openapi 社区某个小伙伴儿已在当前最新发布的 v2.1.0 和 v1.7.0 中修复。
注意:由于当前使用的 Knife4j 版本其内部引入的 springdoc-openapi 相关依赖非最新版本,所以为了解决配置不生效问题,暂时将部分对象型参数移除了 @Validated 注解(除了 PageQuery,其他类当前也未实际添加校验,所以直接移除了)。当然如果不想移除的话,也可以从依赖上功夫,即移除 Knife4j 内引入的 springdoc-openapi 相关依赖,然后自行添加 springdoc-openapi 相关依赖并指定最新版本即可。
2023-04-09 01:13:23 +08:00
Charles7c
2d2a7e7c8e
fix: 修复分页查询条件默认值未生效的问题
...
Spring MVC 对于对象型参数的属性赋值,如果属性值为 null 则不会调用其对应 set 方法,所以在 set
方法中添加默认处理逻辑无效
2023-04-09 00:40:28 +08:00
Charles7c
38f52aaafa
style: 适配 Java 14 新特性
...
1.增强 switch(Java 12 预览特性 => Java 14 标准特性)
详情请参阅:https://docs.oracle.com/en/java/javase/14/language/switch-expressions.html
2.@Serial(类似于 @Override 的检查注解,用于检查序列化)
2023-03-31 23:00:57 +08:00
Charles7c
0aafcc015c
Merge branch 'pr_2' into 2.0.x
...
# Conflicts:
# continew-admin-common/pom.xml
# continew-admin-common/src/main/java/top/charles7c/cnadmin/common/base/BaseController.java
# continew-admin-common/src/main/java/top/charles7c/cnadmin/common/util/helper/LoginHelper.java
# continew-admin-system/src/main/java/top/charles7c/cnadmin/system/model/request/DeptRequest.java
# continew-admin-system/src/main/java/top/charles7c/cnadmin/system/model/request/MenuRequest.java
# continew-admin-system/src/main/java/top/charles7c/cnadmin/system/model/request/RoleRequest.java
# continew-admin-system/src/main/java/top/charles7c/cnadmin/system/model/request/UpdateBasicInfoRequest.java
# continew-admin-system/src/main/java/top/charles7c/cnadmin/system/model/request/UserRequest.java
# pom.xml
2023-03-30 22:59:43 +08:00
dlj
dea160a7b2
chore: Spring Boot 2.7.8 => 3.0.3
...
1.Spring Boot 2.7.8 => 3.0.3
2.Knife4j 适配 Spring Boot 3.x
3.ServletUtil => JakartaServletUtil
4.javax.* => jakarta.*
2023-03-30 22:28:02 +08:00
Charles7c
bc54acd60b
重构:重构获取登录用户信息的代码逻辑
...
1.用户基本信息调整为实时获取
2.登录用户不再保存基本信息,降低维护成本
3.移除冗余的维护登录用户基本信息的代码
2023-03-26 10:58:23 +08:00
Charles7c
fb0effed9a
新增:新增角色数据权限功能(基于 MyBatis Plus DataPermissionInterceptor 插件实现)
...
1.基于 MyBatis Plus DataPermissionInterceptor 插件实现的数据权限功能
2.通过在指定 Mapper 接口层方法添加 @DataPermission 注解实现数据权限
2023-03-07 23:55:24 +08:00
Charles7c
405c821e2a
重构: 🔥 基于阿里巴巴 Java 开发手册(黄山版)重构各表基本结构(简化列名)
...
1.MySQL数据库>建表规约>第9条:
【强制】表必备三字段:id,create_time,update_time。
说明:其中 id 必为主键,类型为 bigint unsigned、单表时自增、步长为 1。create_time,update_time 的类型均为datetime 类型,如果要记录时区信息,那么类型设置为 timestamp。
个人理解:简化列名的目的是为了后续能抽取更多公共能力
2.MySQL数据库>SQL语句>第10条:
【推荐】SQL 语句中表的别名前加 as,并且以 t1、t2、t3、...的顺序依次命名。
说明:
1)别名可以是表的简称,或者是依照表在 SQL 语句中出现的顺序,以 t1、t2、t3 的方式命名。
2)别名前加 as 使别名更容易识别。
正例:select t1.name from first_table as t1 , second_table as t2 where t1.id = t2.id;
2023-03-06 00:09:11 +08:00
Charles7c
4cd4ad1f82
优化:优化分页查询条件
2023-03-05 20:24:40 +08:00
Charles7c
5f1f39d968
完善:完善部分类实现序列化接口
2023-03-04 16:38:44 +08:00
Charles7c
89a327920e
优化:基于阿里巴巴 Java 开发手册(黄山版)优化常量
...
1.编程规约>常量定义>第1条:
【强制】不允许任何魔法值(即未经预先定义的常量)直接出现在代码中。
2023-03-04 14:35:45 +08:00
Charles7c
4779d77265
优化:基于阿里巴巴 Java 开发手册(黄山版)优化方法排序及访问权限修饰符
...
1.编程规约>OOP规约>第20条:
【推荐】当一个类有多个构造方法,或者多个同名方法,这些方法应该按顺序放置在一起,便于阅读,
此条规则优先于下一条。
2.编程规约>OOP规约>第21条:
【推荐】类内方法定义的顺序依次是:公有方法或保护方法 > 私有方法 > getter / setter 方法。
说明:公有方法是类的调用者和维护者最关心的方法,首屏展示最好;保护方法虽然只是子类关心,也可能是“模板设
计模式”下的核心方法;而私有方法外部一般不需要特别关心,是一个黑盒实现;因为承载的信息价值较低,所有
Service 和 DAO 的 getter / setter 方法放在类体最后。
3.编程规约>OOP规约>第26条:
【推荐】类成员与方法访问控制从严:
1)如果不允许外部直接通过 new 来创建对象,那么构造方法必须是 private。
2)工具类不允许有 public 或 default 构造方法。
3)类非 static 成员变量并且与子类共享,必须是 protected。
4)类非 static 成员变量并且仅在本类使用,必须是 private。
5)类 static 成员变量如果仅在本类使用,必须是 private。
6)若是 static 成员变量,考虑是否为 final。
7)类成员方法只供类内部调用,必须是 private。
8)类成员方法只对继承类公开,那么限制为 protected。
说明:任何类、方法、参数、变量,严控访问范围。过于宽泛的访问范围,不利于模块解耦。思考:如果是一个
private 的方法,想删除就删除,可是一个 public 的 service 成员方法或成员变量,删除一下,不得手心冒点汗吗?
变量像自己的小孩,尽量在自己的视线内,变量作用域太大,无限制的到处跑,那么你会担心的。
2023-03-04 10:41:43 +08:00
Charles7c
6da85463c9
优化:基于阿里巴巴 Java 开发手册(黄山版)优化部分空集合处理
...
1.编程规约>集合处理>第7条:(个人理解:emptyList() 固然可以减少资源浪费,但未来由于不确定的需求变更,一旦增删元素必然会引发异常)
【强制】Collections 类返回的对象,如:emptyList() / singletonList() 等都是 immutable list,不可
对其进行添加或者删除元素的操作。
反例:如果查询无结果,返回 Collections.emptyList() 空集合对象,调用方一旦在返回的集合中进行了添加元素的操
作,就会触发 UnsupportedOperationException 异常。
2.编程规约>集合处理>第17条:
【推荐】集合初始化时,指定集合初始值大小。
说明:HashMap 使用构造方法 HashMap(int initialCapacity) 进行初始化时,如果暂时无法确定集合大小,那么指
定默认值(16)即可。
正例:initialCapacity = (需要存储的元素个数 / 负载因子) + 1。注意负载因子(即 loaderfactor)默认为 0.75,如果
暂时无法确定初始值大小,请设置为 16(即默认值)。
反例:HashMap 需要放置 1024 个元素,由于没有设置容量初始大小,随着元素增加而被迫不断扩容,resize() 方法
总共会调用 8 次,反复重建哈希表和数据迁移。当放置的集合元素个数达千万级时会影响程序性能。
2023-03-03 23:41:01 +08:00
Charles7c
dc751fc3ec
优化:基于阿里巴巴 Java 开发手册(黄山版)优化部分方法使用
...
1.编程规约>OOP规约>第12条:
【强制】禁止使用构造方法 BigDecimal(double) 的方式把 double 值转化为 BigDecimal 对象。
说明:BigDecimal(double) 存在精度损失风险,在精确计算或值比较的场景中可能会导致业务逻辑异常。
如:BigDecimal g = new BigDecimal(0.1F);实际的存储值为:0.100000001490116119384765625
正例:优先推荐入参为 String 的构造方法,或使用 BigDecimal 的 valueOf 方法,此方法内部其实执行了 Double 的
toString,而 Double 的 toString 按 double 的实际能表达的精度对尾数进行了截断。
BigDecimal recommend1 = new BigDecimal("0.1");
BigDecimal recommend2 = BigDecimal.valueOf(0.1);
2.编程规约>OOP规约>第19条:
【推荐】使用索引访问用 String 的 split 方法得到的数组时,需做最后一个分隔符后有无内容的检查,
否则会有抛 IndexOutOfBoundsException 的风险。
说明:
String str = "a,b,c,,";
String[] ary = str.split(",");
// 预期大于 3,结果等于 3
System.out.println(ary.length);
2023-03-03 23:14:15 +08:00
Charles7c
1257a4bc35
优化:基于阿里巴巴 Java 开发手册(黄山版)优化常量及包命名
...
1.编程规约>常量定义>第4条:
【推荐】不要使用一个常量类维护所有常量,要按常量功能进行归类,分开维护。
说明:大而全的常量类,杂乱无章,使用查找功能才能定位到要修改的常量,不利于理解,也不利于维护。
正例:缓存相关常量放在类 CacheConsts 下;系统配置相关常量放在类 SystemConfigConsts 下。
2.编程规约>常量定义>第5条:
【推荐】常量的复用层次有五层:跨应用共享常量、应用内共享常量、子工程内共享常量、包内共享常
量、类内共享常量。
1)跨应用共享常量:放置在二方库中,通常是 client.jar 中的 constant 目录下。
2)应用内共享常量:放置在一方库中,通常是子模块中的 constant 目录下。
反例:易懂常量也要统一定义成应用内共享常量,两个程序员在两个类中分别定义了表示“是”的常量:
类 A 中:public static final String YES = "yes";
类 B 中:public static final String YES = "y";
A.YES.equals(B.YES),预期是 true,但实际返回为 false,导致线上问题。
3)子工程内部共享常量:即在当前子工程的 constant 目录下。
4)包内共享常量:即在当前包下单独的 constant 目录下。
5)类内共享常量:直接在类内部 private static final 定义。
2023-03-03 22:34:19 +08:00
Charles7c
94be1f9553
新增:新增功能权限适配及校验
...
1.后端 API 注解鉴权使用方式:@SaCheckPermission("system:user:add")
2.前端全局指令函数使用方式:v-permission="['system:user:add']"
3.前端权限判断函数使用方式:checkPermission(['system:user:add'])
2023-03-02 23:39:22 +08:00
Charles7c
8200ea822f
新增:新增系统管理/岗位管理(列表、查看详情、新增、修改、删除、导出)
2023-02-26 00:19:56 +08:00
Charles7c
91165e63e5
重构:重构查询角色树 API 为查询角色字典列表
...
1.新增 LabelValueVO 通用字典数据结构
2023-02-24 22:24:25 +08:00
Charles7c
56449263d3
优化:优化校验注解提示信息的写法
2023-02-16 20:54:17 +08:00
Charles7c
03b57fb021
优化: 🔥 深度优化后端 CRUD 公共组件,并抽取前端下载功能到 CRUD 公共组件
...
1. 后端抽取导出功能到 CRUD 公共组件
2. 查询列表及导出接口支持排序参数
3. 深度优化 BaseServiceImpl 中的 CRUD 公共实现
4. 前端抽取公共下载组件
5. 优化部分细节并修复部分错误
2023-02-13 21:15:06 +08:00
Charles7c
8085edbfe6
优化:优化响应时间戳数据值
2023-02-08 22:11:05 +08:00
Charles7c
c44503b7ea
新增:部门管理对接用户信息(新增所属部门),并完善查看部门详情(增加上级部门显示)
2023-02-07 22:04:22 +08:00
Charles7c
c5d4e8ae21
重构:重构部门管理前端代码;新增修改部门、批量删除部门、查看部门详情功能(后端主要基于 CRUD 通用组件提供 API)
2023-02-01 23:25:36 +08:00
Charles7c
3075038067
优化:优化模型类命名(为数据模型类添加 DO 后缀),并优化所有模型相关变量命名
2023-01-30 21:00:30 +08:00
Charles7c
d7851bc811
重构:初步封装后端 CRUD 公共组件(BaseController、BaseService、BaseServiceImpl)
2023-01-29 23:40:29 +08:00
Charles7c
dab3e597c2
优化:优化部分校验类型(业务验证迁移到 Service 层,使用 CheckUtils 来验证)
2023-01-25 23:07:25 +08:00