CHANGELOG.md · (๑′ᴗ‵๑) Lᵒᵛᵉᵧₒᵤ辰/ballcat

# 更新日志

## [0.5.0] 2021-12-03

### :warning: Warning

- 由于业务实体类的统一修改，其对应的表结构发生了变化
- 批量方法从 `saveBatchSomeColumn` 切换到 `saveBatch` 后，注意项目中的 jdbcUrl 配置，需要添加 rewriteBatchedStatements=true 条件，否则插入效率降低

### ⭐ New Features

- 【修改】 业务实体类添加父类 `LogicDeletedBaseEntity`，统一支持逻辑删除
- 【修改】 业务实体类统一修改描述、备注等属性名为 remarks
- 【修改】 业务代码批量插入部分方法从 `saveBatchSomeColumn` 切换到 `saveBatch`， 经实测，开启批处理事务以及 jdbcUrl 连接添加`rewriteBatchedStatements=true` 后,  循环 insert into 批量提交比 insert into values 语法速度更快。
- 【新增】 **ballcat-spring-boot-starter-file** 组件，支持 local 本地 和 ftp 文件上传操作
- 【添加】 `TreeUtils#treeToList()` 方法，支持将树平铺为列表
- 【添加】 `ImageUtils#mixResolveClone()` 方法，先使用快速解析，若失败回退到正常解析方法
- 【新增】 `FileUtils` 工具类
- 【新增】 `BaseEntity` 和 `LogicDeletedBaseEntity` 实体类基类
- 【新增】 支持定制 Redis Key 前缀的生成规则
- 【新增】 `DistributeLock` , 更加方便的进行分布式锁的使用
- 【新增】 `AbstractMessageEventListener` 类，提供默认的消息序列化处理
- 【添加】 `ExtendService#saveBatch()` 方法
- 【新增】 多线程对同一 websocket session 进行发送操作的支持
- 【修改】 默认提供的 MybatisPlusConfig 配置类中的自动填充处理类的条件注解修改，方便用户替换为自己的 `MetaObjectHandler`
- 【新增】 线程池配置 `@Async` 异步线程日志支持 traceId 输出
- 【添加】 `TokenGrantBuilder#getAuthenticationManager()` 方法，方便子类继承时获取 AuthenticationManager (#133)
- 【修改】 `FileService` ，OssClient 不再为必须依赖，当没有配置 Oss 时，默认回退使用 FileClient，根据配置走本地存储或者
- 【修改】 `MappedStatementIdsWithoutDataScope` 的 `WITHOUT_MAPPED_STATEMENT_ID_MAP` 属性类型为 `ConcurrentHashMap`
- 【修改】 `TraceIdFilter` 默认在响应头中返回 TraceId 参数，方便排查问题
- 【修改】 `UserInfoCoordinator` 从类调整为接口，并提供默认实现 `DefaultUserInfoCoordinatorImpl`

### 🐞 Bug Fixes

- 【修复】 数据权限使用 JDK动态代理或者桥接方法时无法正确找到 `@DataPermission` 注解的问题
- 【修复】 数据权限在 SQL 右连接，内连接失效的问题
- 【修复】 数据权限对于使用括号包裹的 sql 解析失效的问题
- 【修复】 在仅使用  `ballcat.swagger.enabled=false` 的情况下，swagger 没有正常关闭的问题
- 【修复】 由于跨域问题，导致 swagger 无法在聚合者 Aggregator 中对 文档提供者 Provider 进行调试的问题
- 【修复】 WebSocket 在接收普通文本属性时的异常问题，现在会回退使用 `PlanTextMessageHandler` 进行处理
- 【修复】 查询指定名称的组织时构建树失败的问题

### 🔨 Dependency Upgrades

- 【升级】 spring-boot from  2.5.4 to 2.5.6
- 【升级】 spring-boot-admin from 2.5.1 to 2.5.4

## [0.4.0] 2021-10-15

### Warning

- mybatis-plus 升级，其对应一些 count 方法，返回值修改为了 Long 类型，项目中有使用的地方需要对应修改
- 默认登录时返回的 token 属性有所变更，原 roles 修改为 roleCodes，前端注意对应升级
- websocket 默认使用 local 进行分发，这将导致集群状态下的数据推送异常，如需集群部署，请修改对应配置
- websocket 相关接口 MessageSender 移除，该接口并入 MessageDistributor ，注意修改对应依赖引入类型

### Added

- feat：**ballcat-auth** 授权服务器定制增强：
  - 允许用户自定义 `AccessTokenConverter`，修改自省端点 `/check_token` 的返回值
  - 允许用户定制授权处理器或者新增授权处理器，用户可以通过覆盖 `TokenGrantBuilder` 实现
  - 允许用户添加自己的 `AuthenticationProvider` 方便处理自定义的 grant_type
  - 添加 OAuth2ClientConfigurer 抽象接口，方便用户替换 ClientDetailsService 的配置方式
  - 和 **ballcat-system** 模块解耦，方便复用 **ballcat-auth** 快速搭建一个授权服务器，例如 C 端用户 和 后台用户分离登陆系统，各搭建一套基于 OAuth2 的登录。
  - 根据 OAuth2 规范，调整 check_token 端点响应，在 token 不正确时响应 200，响应体为 `{ active: false }`，而不是返回 400
- feat：数据权限对于 jsqlparse 4.2 后，连表使用尾缀多个 OnExpression 方式的 SQL 解析支持
- feat：角色添加 scopeResource 属性，以便支持自定义数据权限设置一些信息
- feat：默认的 jackson 时间序列化添加了 `Instant` 类型支持，防止在使用时出现异常 InvalidDefinitionException: Java 8 date/time type `java.time.Instant` not supported by default

### Changed

- refactor：资源服务器对于客户端凭证生产的token 解析支持，对应的 userdetails 为 `ClientPrincipal`

- refactor：授权服务器自省端点的 scope 属性响应调整，根据 OAuth2 自省端点协议，scope 应返回字符串，用空格间隔

- refactor：数据权限调整

- 问题修复： fix 数据权限在表名使用 `` 转义字符时失效的问题
  - 性能优化：对于无需数据权限控制的 sql 在解析一次后进行记录，后续不再进行解析处理
  - 结构调整：防止误用以及避免歧义，DataScopeHolder 修改为 DataScopeSqlProcessor 的私有内部类

- refactor：SelectData 试图对象中的 value 修改为 Object 类型，selected 和 disabled 修改为 Boolean 类型

- refactor：系统用户相关的 service 和 mapper 层，修改使用 Collection 接收参数，方便使用

- refactor：TokenAttributeNameConstants 常量类拆分

- refactor：UserInfoDTO 属性调整，新增了 menus 用于存储用户拥有的菜单对象集合，修改 roles 属性用于存储用户拥有的角色对象集合，原 roles 属性修改为 roleCodes 存储角色标识集合

- refactor：为避免歧义，登录和自省端点返回信息中的属性名称 roles 修改为 roleCodes

- bug：修复使用 **ballcat-spring-boot-starter-web** 时，若没有引入 security 依赖则启动异常的问题

- refactor： system 相关事件优化调整
  1. 用户组织变动时发布 UserOrganizationChangeEvent 事件
  2. 用户新建的事件由 UserChangeEvent 修改为 UserCreatedEvent
  3. system 的 event 类从 biz 迁移到 model 模块中

- refactor：**ballcat-common-websocket** 移除 MessageSender 接口，将其并入消息分发器 MessageDistributor

- refactor：**ballcat-spring-boot-starter-websocket** 与 redis 解耦，将默认注册的消息分发器由 redis 改为 local，基于内存分发。可通过 ballcat.websocket.message-distributor 属性修改为 redis 或者 custom，值为 custom 表示，用户自己定制 MessageDistributor（如修改为使用 mq，可用性更高）

```yaml
  ballcat:
  	websocket:
  		# 默认为 local 仅支持单节点使用，redis 基于 PUB/SUB 消息订阅支持了集群下的消息推送问题
  		message-distributor: redis # local | redis | custom
  ```

- refactor：**ballcat-spring-boot-starter-redis** 调整 AddMessageEventListenerToContainer 的注册方式，防止用户配置包扫描导致的加载顺序异常

- refactor：有用户绑定组织时，不允许删除组织

### Dependency

- Bump spring-boot from 2.4.8 to 2.5.5
- Bump lombok from 1.18.16 to 1.18.20
- Bump mybatis-plus 3.4.4 to 3.4.3.4
- Bump mybatis  3.5.6 to 3.5.7
- Bump jsqlparser 4.0 to 4.2
- Bump flatten-maven-plugin from 1.2.5 to 1.2.7
- Bump spring-javaformat from 0.0.27 to 0.0.28
- Bump hutool from 5.7.3 to 5.7.12
- Bump spring-boot-admin from 2.4.2 to 2.5.1
- Bump dynamic-datasource-spring-boot-starter from 3.3.2 to 3.4.1

## [0.3.0] 2021-09-09

### Warning

- 多个模块包名调整，注意重新 import 对应路径
- 国际化重构，改动较大，注意对应代码调整。国际化使用文档参看：http://www.ballcat.cn/guide/feature/i18n.html
- 由于 **ballcat-common-conf** 的删除，非 admin 服务中的 mybatis-plus 的相关配置，如分页插件，批量插入方法的注入，需要按需添加。
- 操作日志优化，修改了 `OperationLogHandler` 的相关方法，如果有自定义 OperationLogHandler ，需要注意同步更新
- 现在资源服务器默认关闭了表单登录功能，可通过配置开启表单登录并指定登录页地址

### Added

- feat: 国际化功能的默认支持，新增 **ballcat-i18n** 相关模块，以便提供默认的业务国际化实现方式

- feat: 登录用户名密码错误时的错误消息国际化处理

- feat: **ballcat-common-redis** 针对 PUB/SUB 新增 `MessageEventListener` 接口，**ballcat-spring-boot-starter-redis**  中会自动注册所有实现 `MessageEventListener` 接口的监听器

- feat:  **ballcat-common-redis** 中的 `@CacheDel` 注解，新增 multiDel 属性，方便批量删除缓存

- feat: 新增 **ballcat-common-idempotent** 幂等模块

- feat: 针对 hibernate-validation 校验的提示消息，支持使用 {}，占位替代 defaultMessage

- feat:  **ballcat-common-core** 中默认新增了 `CreateGroup` 和 `UpdateGroup` 接口，方便分组校验使用

- feat:  新增 **ballcat-spring-boot-starter-web** 模块，该模块基于 `spring-boot-starter-web`, 并使用 undertow 作为默认的嵌入式容器，且将 **ballcat-common-conf** 中对 web 应用的配置增强，如全局异常管理，以及 Sql 防注入处理，jackson 的默认配置等配置移动到此项目中

- feat: **ballcat-extend-mybatis-plus** 模块中，为了支持连表查询的条件构建，新增 `OtherTableColumnAliasFunction` ，方便使用  `LambdaAliasQueryWrapperX` 进行关联表查询条件的构建

- feat: **ballcat-spring-boot-starter-easyexcel** 支持导出时进行 Excel 头信息的国际化处理，使用 `{}` 进行占位表示，使用示例可参看 I18nData 的导出使用

- feat: **ballcat-spring-boot-starter-swagger** 配置的扫描路径 `basePackage` ，支持使用 `,`  进行多包名的分割扫描

- feat: **ballcat-spring-boot-starter-datascope** 中的数据权限控制注解 @DataPermission 扩展支持在 Mapper 之外使用，且支持方法嵌套调用时使用不同的 @DataPermission 环境

- feat: **ballcat-common-security** 中资源服务器配置不再默认开启表单登录，新增两个配置属性用于开启并指定登录页地址：

```yaml
  ballcat:
  	security:
  		oauth2:
  			resourceserver:
  				# 是否开启表单登录，默认 false
  				enable-form-login: true
  				# 登录页地址，开启表单登录时生效，不配置则默认为 /login
  				form-login-page: http://login-domin
  ```

### Changed

- refactor: **ballcat-common-conf** 内原先对于 mybati-plus 的自动填充、分页插件、以及批量插入方法注入的配置移动到 **ballcat-admin-core** 中

- refactor:  `SpELUtils` 改名为 `SpelUtils`，并移动到 **ballcat-common-util** 模块中

- refactor:  `ApplicationContextHolder` 改名为 `SpringUtils`，并移动到 **ballcat-common-util** 模块中

- refactor: **ballcat-spring-boot-starter-log** 中拆分出 **ballcat-common-log** 模块，解决在 log-biz 模块中需要引入 starter 的问题，部分代码的包名有变更

- refactor: **ballcat-spring-boot-starter-redis** 中拆分出 **ballcat-common-redis** 模块

- refactor: 重构原先的国际化 i18n 功能，新增 **ballcat-common-i18n** 模块，移除原先的 **ballcat-extend-i18n** 模块

- pref: 取消 **ballcat-spring-boot-starter-web** 中 **spring-security-core** 的传递依赖

- fix: 修复当查询一个不存在的系统配置后，由于缓存空值，导致添加配置后依然查询不到的问题

- pref: 菜单查询的返回类型修改为 SysMenuPageVO

- fix: 修复 excel 导出的 content-type 和实际文件类型不匹配的问题

- fix: 提高缓存切面的 Order，使其在事务提交后执行更新或删除操作，防止并发导致缓存数据错误

- pref: 菜单支持删除 icon

- fix: 修复当菜单 id 修改时，未级联修改其子菜单的父级 id 的问题

- pref: 优化操作日志，改为在方法执行前获取方法参数信息，防止用户在执行方法时将方法入参修改了

- pref: **ballcat-admin-core** 中默认扩展 springboot 默认的 TaskExecutor 配置，将拒绝策略从抛出异常修改为使用当前线程执行

- refactor:  移动 TreeNode 模型到 common-util 包中，以便减少 common-util 包的依赖

- refactor: **ballcat-spring-boot-starter-xss** 抽象出 XssCleaner 角色，用于控制 Xss 文本的清除行为，方便用户自定义

- pref: 用户登陆时的错误信息返回原始的细节信息，而不是全部返回用户名密码错误

- fix:  **ballcat-system-biz** websocket 包名拼写错误修复

### Removed

- 移除 **ballcat-common-conf**，相关代码拆分入 **ballcat-spring-boot-starter-web** 和 **ballcat-admin-core**

### Dependency

- Bump jsoup from 1.13.1 to 1.14.2

## [0.2.0] 2021-08-11

### Added

- feat: 新增 ballcat-extend-redis-module 模块，提供对布隆过滤器的操作
- feat: 新建用户时可以直接绑定用户角色，而不必分两次操作了
- feat: 支持修改菜单ID，方便转移菜单位置时，保持菜单 ID 规则
- feat: **新增 ballcat-common-security 模块**
  - 新增 CustomRedisTokenStore 用于在序列化异常时，直接清除缓存。避免每次修改 UserDetails 时都需要用户手动去删除所有缓存信息
  - 迁移 PasswordUtils 从 common-util 到 common-security，且 PasswordEncoder 使用 DelegatingPasswordEncoder, 方便未来切换密码加密算法
  - 迁移 OAuth 相关的异常处理，从 ballcat-oauth-controller 到 common-secutiy
  - 新增 ResourceServer 相关配置以及基础组件，基于 SpringSecurity 5.X
  -  SysUserDetails rename to User, sysUser 中的相关属性，现在直接写在 User 类中，同时删除了 userResource 和 userAttributes 属性，新增了 attributes 属性。

### Changed

- refactor: 数据权限 dataScopes 通过 ThreadLocal 进行方法间传递
- refactor: 拆分 admin-websocket 模块，方便用户剔除不需要的组件.
- refactor: ballcat-spring-boot-starter-websocket 模块中 websocket 相关的封装代码抽取到 **ballcat-commo-websocket** 模块，starter 仅保留自动配置相关代码
- pref: 菜单的逻辑删除属性使用 mybatis-plus 的自动填充功能，且当菜单 ID 已使用时提示详情
- pref: 精简了一些 common 模块中不需要的依赖
- refactor: OAuth2 ResourceServer 底层从 spring-security-oauth2 依赖迁移至 SpringSecurity 5.x
- pref: common-conf 中现在默认注册 jackson 的脱敏序列化器了，用户可以通过注册 name 为 ”desensitizeCustomizer“ 的 Jackson2ObjectMapperBuilderCustomizer bean，覆盖默认配置
- refactor: ballcat-spring-boot-starter-log 和业务解耦，操作日志的生产和存储全部交由业务项目自己处理，ballcat-log-biz 模块中提供了默认的操作日志实体类，以及 OperationLogHandler 的默认实现
- refactor: 由于 common-security 的抽取， ballcat-oauth 模块只剩下了授权相关，故更名为 ballcat-auth，同时做了一些结构上的调整，方便后续独立部署授权服务器。
  - 配置 `ballcat.upms.loginCaptchaEnabled` 现在调整为 `ballcat.security.oauth2.authorizationserver.loginCaptchaEnabled` ，用以控制登录验证码的开关
  - 配置 `ballcat.security.ignoreUrls` 现在调整为 `ballcat.security.oauth2.resourceserver.ignoreUrls` 用以控制资源服务器对部分 url 的鉴权忽略
  - 配置 `ballcat.security.iframeDeny` 现在调整为  `ballcat.security.oauth2.resourceserver.iframeDeny` 用于开启资源服务器的嵌入 iframe 允许
  - 新增 `@EnableOauth2AuthorizationServer` 注解，用以开启授权服务器 (ballcat-admin-core 模块中默认开启）

### Removed

- 移除 ballcat-oauth-model，相关代码迁入 ballcat-common-security

### Dependency

- Bump spring-boot from 2.4.3 to 2.4.8
- knife4j from 2.0.8 to 2.0.9
- hutool from 5.5.8 to 5.7.3
- fastjson from 1.2.75 to 1.2.76
- dynamic-datasource from 3.3.1 to 3.3.2
- spring-boot-admin from 2.4.1 to 2.4.2
- anji-captcha from 1.2.8 to 1.2.9

## [0.1.0] 2021-06-28

### Warning

- 此版本重构了前端路由部分，服务端权限表 sys_permission 改为 sys_menu，改动较大，迁移时建议先备份原始数据，执行增量 sql 后若出现问题，再进行比对处理
- 调整了模块名，sys => system，后续包名也都尽量不再使用缩写，注意修改对应类的引用包路径
- 项目部分配置添加 ballcat. 前缀
  - 文件存储现在修改为了对象存储（OssProperties.java），配置前缀为 ballcat.oss
  - 登录验证码开关和超级管理员指定的配置（UpmsProperties.java），前缀为 ballcat.upms
  - 登录密码的 AES 加解密密钥，忽略鉴权的 url 列表，iframe 嵌入配置开关等安全相关的配置 （SecurityProperties.java），前缀为 ballcat.security
- 模块拆分重构，原 `admin.modules` 下的 `log`、`system`、`notify` 相关代码，全部独立模块。目前拆分为 `model`，`biz`，`controller` 三层，方便按需引入。`ballcat-admin-core` 依然默认集成所有模块
  - log 模块涉及的表名以及类名修改，原 AdminXXXLog 类，全部去除 Admin 开头。表名前缀由 `admin_` 修改为 `log_`
  - log 中的登录日志也不再默认开启，需要登录日志，可手动注册 `LoginLogHandler` 类，代码示例可参考 `ballcat-sample-admin` 项目中的  `LogHandlerConfig`。
  - 同样访问日志和操作日志也需对应注册 handler，且在启动类上添加 @EnableXXXLog 注解
  - mapper.xml 文件移动，由于模块拆分，目前各模块的 mapper.xml 直接放置在了 mapper 文件夹下，对应的文件扫描配置 `mybatis-plus.mapper-locations` 需要修改为 `classpath*:/mapper/**/*Mapper.xml`
    ```yml
    mybatis-plus:
      mapper-locations: classpath*:/mapper/**/*Mapper.xml
    ```

### Added

- feat: 新增了国际化插件 i18n extend 和 i18n starter
- feat: BusinessException 的错误消息支持占位符了
- feat: PageParam 分页查询参数对象，支持用户自定义其子类以便做额外的功能处理
- feat: TreeUtils 现在构建树时，支持传入 Comprator，进行自定义排序
- feat: 新增 SmsUtils，以及 GSMCharst 类，用于短信长度计算
- feat: 新增了一个根据用户id查询 UserInfo 的接口
- feat: ballcat-extend-mybatis-plus 模块中添加普通枚举类型处理. 根据 name() 返回值判断枚举值
- feat: ballcat-spring-boot-starter-easyexcel 新增 @RequestExcel 注解，方便导入 excel 直接解析为实体对象
- feat: 新增了一个接口用于组织机构树形层级和深度的错误数据校正

### Changed

- refactor: SysPermission 移除，新增 SysMenu 类，相关关联类同步修改，减少了大部分的配置属性，转交由前端处理
- refactor: Lov 实体修改为 SysLov
- refactor: 移除 AdminRuleProperties.java，adminRule 相关配置与登陆验证码开关控制一并合入 UpmsProperties, 密码加密密钥配置并入 SecurityProperties，并将其配置前缀统一添加 ballcat.
- refactor: SysUserDetailsServiceImpl.getUserDetailsByUserInfo 方法调整为 public 级别, 便于以api方式登录的请求注入用户信息
- refactor: 重构了 excel 自定义头生成器的使用方式
- refactor: 修改 AbstractRedisThread.getObjType 默认实现, 使其更符合大多数情况(获取失败的情况下子类重写此方法)
- refactor: 文件存储 starter-storage 重构，修改为对象存储，使用 S3 协议和云端交互，所有支持 S3 协议的云存储都可以使用，如亚马逊、阿里云、腾讯云、七牛云
- refactor: 移除 userInfoDTO 中的 roleIds 属性
- refactor: 系统配置添加缓存注解，提升查询效率，更新和删除修改为使用 confKey, 而不是 ID
- pref: 根据 mapstruct 官方文档，调整了 lombok 和 mapstruct 的依赖引入方式
- pref: 所有 @RequestParam 和 @PathVariable 注解，指定 value 值，避免因环境问题，编译未保存参数名称，导致的参数绑定异常
- pref: 简化微信原生支付方法
- pref: 前后端交互密码解密异常时的错误日志以及响应信息优化
- fix: 禁止删除有子节点的组织，以及不能修改父组织为自己的子组织
- fix: 修复由于 mapstruct 的引入方式修改，导致 yml 中配置信息不提示的问题
- fix: 修复 easyexcel 添加 password 后会导致 excel 文件打开异常的问题
- pref: starter-log 和 starter-oss 模块包名拼写错误修复，commom -> common
- refactor: AccessLogSaveThread 不再默认启动，AbstractQueueThread 中对非活动状态的线程进行启动，避免重复启动异常
- fix: 修复组织架构移动到子层级时，导致其他节点的层级和深度被错误修改的问题（之前的错误数据可用此版本新增的校正功能修复）
- fix: 修复操作日志添加参数忽略类型的异常问题

### Dependency

- Bump  spring-boot-admin from 2.4.1 to 2.4.1
- Bump virtual-currency  from 0.4.1  to  0.4.2

## [0.0.9] 2021-04-28

### Warning

- 由于用户属性和用户资源类的抽象，更新版本后，需要删除原来缓存的用户数据，否则会造成反序列化移除
- ExtendService#selectByPage 方法移除，原本使用此方法的分页查询，需要更改为使用 baseMapper#selectPage
- 部分类路径有修改，注意迁移
- 代码生成器独立到新的仓库：https://github.com/ballcat-projects/ballcat-codegen
- 示例使用迁移到新的仓库：https://github.com/ballcat-projects/ballcat-samples

### Added

- feat: RedisHelper 工具类新增 list 的 rightPush 和 leftPop 方法
- feat: 新增了一个基于 Redis 的线程队列
- feat: 新增解绑用户角色关联关系的功能
- feat: `ExtendService#saveBatchSomeColumn` 现在支持分批批量插入了
- feat: admin-websocket 新增了 Lov 弹窗选择器修改时的 websocket 推送

### Changed

- refactor: 用户属性和用户资源抽象出接口，不再使用 Map 存储，具体使用类交由使用方进行构造，类似于` UserDetails`
- refactor: common-desensitize 优化，支持自定义注解脱敏

- refactor: 抽象 `AbstractThread` 类. 让下级自定义 poll 和 put 方法.
- refactor: `AbstractQueueThread` 添加程序关闭时的处理方法，防止停机时的数据丢失问题
- refactor: 简化了支付宝和微信的回调类，并添加了验签方法
- refactor: 使用 `Jackson2ObjectMapperBuilder` 构造 `ObjectMapper`，保留使用配置文件配置 jackson 属性的能力，以及方便用户增加自定义配置
- refactor: xss 防注入重构，抽取成一个 starter，限制基于 jsoup 的白名单过滤，可自定义排除路径和请求类型的配置，admin-core 包现在默认集成此 starter
- refactor: 工具类添加 finnal 关键字和私有构造
- refactor:  修改 extends 下的三个支付模块的类路径, 把 starter 修改为 extend
- refactor:  优化 JsonUtils 的类型转换
- fix: 修复 `LambdaQueryWrapperX#inIfPresent` 参数错误处理成流，导致的 sql 拼接异常
- fix: 修复当没有字典项时，无法正常删除字典的 bug
- fix: 修复几次版本更新导致的代码生成器的各种 bug，如目录项拖动，以及zip 文件流末端损坏等
- fix: 操作日志记录时，参数为 null 导致的空指针问题

### Removed

- 移除新酷卡短信组件
- 移除 mybatis-plus-extend 中的 selectByPage 方法，因为其无法真正修改返回类型，现在使用 `page.convert` 进行 数据转换

### Dependency

- Bump virtual-currency  from 0.3.2  to  0.4.1
- Bump  spring-boot-admin from 2.4.0 to 2.3.1

## [0.0.8] 2021-03-04

### Warning

- 更新了 Service 层的父类，现在无法直接使用 service 对象，进行 Wrapper 条件构造
- 更新了分页查询的排序参数，前端需要对应升级
- commom-model和common-util的抽离，导致部分工具类和部分通用实体包名修改, 请注意替换

### Added

- feat: Swagger3 支持，文档地址更新为 /swagger-ui/index.html
- feat: 剥离全局异常捕获中请求方法和请求媒体类型不支持的异常，方便生产环境排查问题
- feat: 新增 common-desensitize 脱敏模块，默认提供了部分常用脱敏类型，且支持SPI形式追加用户自定义脱敏处理器
- feat: 新增 pay-ali 模块，用于支持支付宝支付
- feat: 新增图形验证码开关配置，默认开启
- feat: 分页查询出入参封装，提供 PageParam 作为入参，PageResult 作为出参，不再用 Page 贯穿
- feat: 密码在日志中的存储脱敏
- feat: 数据权限注解提供对于指定 Mapper类，或指定方法的数据权限关闭功能
- feat: 添加 JsonUtils 根据依赖执行对应的json处理方法
- feat: 添加 RedisHelper 提供对redis的常用方法支持
- test: 对 client test 跳过登陆验证和密码解密，便于测试，注意生产环境不要开启 test client

### Changed

- refactor: 取消了项目文件格式化指定换行符使用 LF 的限制
- refactor: 分页查询的排序参数属性修改，用于支持多列排序
- refactor: mybatis-plus-extend 扩展包调整
  - 新增 LambdaQueryWrapperX ，提供 ifPresent 方法，用于简化条件判断
  - 新增 LambdaAliasQueryWrapperX 用于构造带别名的条件语句和查询sql
  - ExtendMapper 新增 selectByPage 方法，扩展自 selectPage 方法，支持查询数据直接转换为 VO 的映射
  - ExtendMapper 新增 insertBatchSomeColumn，使用 insert into 方式进行插入，提升批量插入效率
  - ExtendService 扩展自 IService，但是取消所有对外暴露 Wrapper 参数的方法，便于规范代码分层
- refactor: 所有 Service 改为继承 ExtendService，所有 Mapper 改为继承 ExtendMapper，且所有查询 条件构造下沉入DAO 层
- refactor:  部分方法名修改，查询方法返回结果为集合时，方法名使用 list 开头
- refactor: 钉钉消息通知优化，每次通知使用新的 request 实例
- refactor: 访问日志默认忽略验证码获取请求，操作日志忽略 MutipartFile 类型的参数记录
- refactor: 用户密码在 service 使用明文密码交互，AES 加解密在 controller 或者过滤器中完成
- refactor: 密码加解密密钥的配置添加 ballcat 前缀：ballcat.password.secret-key
- refactor: hutool 改为按需引入
- refactor: 取消代码文件换行符强制使用 LF 的限制
- refactor: 取消 jackson 配置中，全局 Null 值转 '' 的处理，但是以下对 类型 Null 值特殊处理
  - String Null 转 ''
  - Array 和 Collection Null 转 []
  - Map Null 转 {}
- refactor: 从 common-core 中剥离出 common-util 和 common-model

### Removed

- 移除 mybatis-plus-extend-mysql 扩展包，相关方法移入 mybatis-plus-extend 扩展中
- 移除 model 的 AR 模式支持
- 移除 hibernate-validator 的版本指定，改为跟随 spring-boot 的依赖版本
- 移除 JacksonUtils

### Dependency

- Bump spring-boot from 2.4.1 to 2.4.3
- Bump mapstruct from 1.4.1.final to 1.4.2.final
- Bump spring-javaformat-maven-plugin 0.0.26 to 0.0.27
- Bump hutool from 5.5.7 from 5.5.8
- Bump mybatis-plus from 3.4.1 to 3.4.2
- Bump dynamic-datasource from 3.2.0 to 3.3.1
- Bump spring-boot-admin from 2.3.1 to 2.4.0
- Bump oss.aliyun from 3.8.0 to 3.11.3
- Bump anji-captcha 1.2.5 to 1.2.8

## [0.0.7] 2021-01-19

### Added

- feat: 多页签导出支持每个页签不同头类型
- feat: 新增创建人和更新人的自动填充支持
- feat: 提供ExcelWriterBuilder，使用者可以复写此接口方法，来对excel导出做自定义处理
- feat: 数据权限注解 @DataPermission 提供方法级别的忽略支持
- add: 新增 HtmlUtil，方便快捷提取 html 中的纯文本，且保留换行结构
- feat: 代码编辑器的模板编辑框提供全屏功能
- feat:  新增用户成的发布事件
- feat:  新增登陆时的图形验证码校验，提升安全性
- feat:  新增虚拟货币的支付stater支持
- feat:  新增基于 websocket-starter，方便系统集成 websocket 使用
- feat: 新增系统公告，支持多种方式指定接收人，以及多种公告推送方式
- feat:  新增 admin-websocket 插件包，引入此依赖，可获得实时的站内公告推送以及字典项更新推送能力，默认使用redis发布订阅进行集群支持，用户可通过自定义 MessageDistributor 来更换消息分发模式，比如使用专业的消息队列，也提供了 LocalMessageDistributor，在单节点时使用此分发器，更高效稳定

### Changed

- refactor:  代码格式化强制换行符使用 LF，保证跨系统协同开发的统一性
- refactor:  mail-stater 的结构微调，修改了部分类名
- refactor：调整了系统的依赖结构，将 spring 相关依赖版本管理由父工程移动到 ballcat-dependencies 中

### Bug

- fix: 修复由于SpringMvc5.3版本后的跨域通配符使用方式导致 swagger 跨域配置 * 号无法生效的问题
- fix: 修复字典项删除时未更新hashcode 导致的前台缓存问题
- fix: 添加依赖，修复高版本 lombok 和 mapstruct 的冲突问题
- fix: 修复代码生成器模板生成失败以及无法平移文件的问题
- fix: 修复操作日志在记录入参时，若参数中含有 request 或 response 导致的堆栈溢出问题

### Dependency

- Bump spring-boot from 2.4.0 to 2.4.1
- Bump mapstruct from 1.3.1.final to 1.4.1.final
- Bump spring-javaformat-maven-plugin 0.0.25 to 0.0.26

## [0.0.6] 2020-12-03

### Warning

- 更新了 UserDetail，缓存反序列化将会出现问题，更新版本前需要清除对应缓存
- 返回体结构修改，属性 msg 修改为 message，可能影响前端信息展示，接入系统的第三方的响应数据接收，升级前需提前沟通

### Added

- feat: 新增组织机构(部门)，用户与组织机构为一对一的关系
- feat: 数据权限，利用 mybatis 拦截器对 sql 进行拦截约束，约束规则支持自定义，适用于大部分数据权限控制。
- feat: 角色新增 scopeType，暂时支持全部，本人，本部门，本人及子部门等几种范围类型
- feat: 新增短信发送 stater
- feat: excel导出支持自定义头信息
- feat: 新增 JacksonUtils，方便全局统一 objectMapper 配置

### Changed

- fix: 修复没有提供默认 profile，导致用户不指定 profile 时，全局异常处理无法正常初始化的问题
- refactor:  Lov 模块调整
- refactor: lovBody 和 lovSearch 关联属性由 lovId 更改为  keyword
- refactor: UserDetails 属性重构，抽象出用户资源(userResources)和用户属性(userAttributes)，默认将用户的角色和权限作为资源存入userResources. 可以重写UserInfoCoordinator类，来根据业务调整用户资源和用户属性
- refactor: kafka 消费者配置提供
- refactor: 返回体结构修改，属性 msg 修改为 message
- refactor: xss 和 monitor auth 过滤器提供开关，并调整了配置前缀
- refactor: 用户角色，角色权限的关联，由 role_id 修改为使用 role_code
- fix: 系统用户查询时组织机构ID为空不为null时导致的异常
- refactor: 字典附加属性，value值修改为object类型
- fix: 修复用户在容器初始化前使用缓存注解时，CacheLock未初始化导致的异常问题
- fix: 移除 hutool json 的使用（该工具类部分情况下可能导致栈溢出）
- refactor:  支持用户select数据查询接口使用 userTypes 进行多类型筛选，删除原先的地址栏占位符查询方式

### Dependency

- Bump spring-boot from 2.3.4 to 2.4.0

## [0.0.5] 2020-09-18

### Added

- Lov 模块
- 字典相关
  - feat: DictItemVO 新增 id 属性
  - feat: 字典项新增 attributes 属性，用于定制额外的非必须属性，如颜色等供前端使用

### Changed

- refactor: ApplicationContextUtil 更名为 SpringUtil

- refactor: LogUtil#isMultipart 去除只判断 POST 请求的限制

- 全局异常&异常通知

- fix: 修复异常通知 message 为 null 时导致的异常

- fix: 修复类校验失败时，无法正常返回错误信息的
  - feat: 异常通知添加 hostname 和 ip 信息
  - fix: 捕获空指针异常时，会导致异常通知空指针的问题
  - fix: 异常通知 cpu 占用过高问题
  - feat: 添加忽略指定异常类的配置
  - refactor: 优化钉钉通知的http请求方式
  - style: 通知信息中的英文冒号转为中文冒号
  - refactor: 除未知异常外，取消全局异常捕获时的异常打印，如需详细堆栈可以在异常处理类中进行处理

- feat: AbstractQueueThread#preProcessor 修改为 public，便于子类重写

- fix: 修复包装 RequestBody 导致，表单数据无法正常读取的bug

- fix: 修复在前台页面新建权限时无法指定主键 Id 的异常

- feat: extend-mybatis-plus 中批量插入方法，将生产的主键回填到实体中

- refactor: 登陆日志和操作日志分离

- fix: 修复用户登陆后将密文密码返回前台的安全隐患问题

- style: 代码生成器样式微调

### Dependency

- Bump spring-boot from 2.3.1 to 2.3.4
- Bump mybatis-plus from 3.3.2 to 3.4.0
- Bump hutool from 5.3.10 to 5.4.1
- Bump  spring-java-format from 0.0.22 to 0.0.25

## [0.0.4] 2020-08-14

### Added

- 新增 kafka stater 模块
- 新增 mybatis-extends 扩展，添加批量插入方法
- accesslog 提供 responseWrapper，方便记录响应数据
- swagger stater 新增 additionalModelPackage 属性，用于扫描一些额外的 swaggerModel
- 异常捕获新增对 MethodArgumentTypeMismatchException 的处理
- 新增 Security 是否开启禁止 iframe 嵌入的配置控制

### Changed

- AbstractQueueThread 提高默认的批处理大小
- 代码生成器移除加载动态数据源时指定的 driverClassName
- 移除 admin-core 默认引入的 swagger 依赖，现在用户可以在自己的项目中选择引入
- 移除 JacksonConfig#ObjectMapper 的 @Primary 注解，便于用户自定义
- 数据字典优化，支持批量请求，接口地址调整
- 调整前后端传输密码使用的 AES Padding mode 为 PKCS5Padding
- 修复因 TokenStore 与 cachePropertiesHolder 加载顺序导致的启动异常
- 修复 codegen 无法选择 master 之外的数据源进行代码生成的bug
- 当使用 DingTalk 异常通知时，会 @所有人
- 字典添加值类型字段，便于前端回显，以及后续校验控制

### Dependency

- swagger up to 1.5.21
- dynamic-datasource up to 3.2.0
- spring-boot-admin up to 2.2.4
- easyexcel up to 2.2.6

## [0.0.3] 2020-07-06

### Added

- 重构代码生成器

- 前端使用 ant-design-vue 重构，支持单体应用以及前后端分离两种部署方式
  - 多数据源支持，动态添加删除，生成时选择对应数据源进行代码生成
  - 代码生成结构调整，支持自定义代码生成结构
  - 支持在线模板编辑
  - 支持自定义模板属性，定制模板

- 提供 dingTalk-starter，简化 dingTalk 接入

- 提供 kafka 扩展，以及kafka流式处理扩展包

- 记录登陆登出日志

- 自动填充（逻辑删除标识），新建时增加对字段名为 `deleted` 且 类型为`Long`的属性填充，填充值为 0

- 超级管理员配置，可根据userid 或 username 指定当前项目的超级管理员（即最多可配置两个超级管理员），超级管理员默认拥有所有权限，不可删除，仅自己可以修改自己的信息
  如下配置：指定了 userId 为 1 或者 username 为 admin 的用户为超级管理员

```yaml
    ballcat:
        admin:
            rule: 
                userId: 1  
                username: admin
    ```

### Changed

- 访问日志忽略路径修改为可配置

- 角色新增类型属性，对于系统类型角色，不允许删除

- 更新逻辑删除不能使用 unique key 的问题，逻辑删除使用时间戳，未删除为0，删除则为删除的时间戳，实体类字段同一使用Long，数据库使用bigint。

- 配置文件添加如下配置：

```yaml
    mybatis-plus:
      global-config:
        db-config:
          logic-delete-value: "NOW()" # 逻辑已删除值(使用当前时间标识)
          logic-not-delete-value: 0 # 逻辑未删除值(默认为 0)
    ```

### Dependency

- mybatis-plus 版本升级至 3.3.2
- spring-boot 版本升级至 2.3.1.RELEASE
- spring-security-oauth2 升级至 2.3.8.RELEASE

## [0.0.2] 2020-06-04

### Added

- 更新系统配置表，重命名为 sys_config, 并调整包位置，并入sys模块下。

- 模块重构，调整部分common下的模块，修改放入starter

- 合并 simple-cache，后续直接引入`ballcat-spring-boot-starter-redis`模块，即可开启全局key前缀，以及缓存注解功能

- traceId跟踪，引入`ballcat-spring-boot-starter-log`，会自动为每个请求的日志上下文中注入TraceId

- operation_log、admin_access_log表新增字段 trace_id，类型char(24).

- logback-spring.xml 彩色日志模板中，加入`%clr([%X{traceId}]){faint}`，文件日志模板加入`[%X{traceId}]`，用于打印traceId

- 移除api_access_log表，以及相关代码

- 更新日志，追加追踪ID，操作类型

- core项目更新为自动装配，可以删除项目Application中的
  `@ServletComponentScan("com.hccake.ballcat.admin.oauth.filter")` 注解。

`@MapperScan("com.hccake.ballcat.**.mapper")`
  `@ComponentScan("com.hccake.ballcat.admin")`
  注解上的这两个包扫描也可去掉。

(๑′ᴗ‵๑) Lᵒᵛᵉᵧₒᵤ辰/ballcat

简介

发行版

贡献者

近期动态

(๑′ᴗ‵๑) Lᵒᵛᵉᵧₒᵤ辰/ballcat .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

(๑′ᴗ‵๑) Lᵒᵛᵉᵧₒᵤ辰/ballcat