SpringBoot中公共字段自動(dòng)填充的常用技巧
一、痛點(diǎn)分析:公共字段維護(hù)的三大困境
典型問(wèn)題場(chǎng)景
// 訂單創(chuàng)建邏輯
publicvoidcreateOrder(OrderDTO dto){
Order order = convertToEntity(dto);
// 手動(dòng)設(shè)置公共字段
order.setCreateTime(LocalDateTime.now());
order.setUpdateTime(LocalDateTime.now());
order.setCreateUser(getCurrentUser());
order.setUpdateUser(getCurrentUser());
orderMapper.insert(order);
}
// 訂單更新邏輯
publicvoidupdateOrder(OrderDTO dto){
Order order = convertToEntity(dto);
// 重復(fù)設(shè)置邏輯
order.setUpdateTime(LocalDateTime.now());
order.setUpdateUser(getCurrentUser());
orderMapper.updateById(order);
}
痛點(diǎn)總結(jié):
- 代碼重復(fù)率高(每個(gè)Service方法都要設(shè)置)
- 維護(hù)成本高(字段變更需修改多處)
- 容易遺漏(特別是更新操作)
二、基礎(chǔ)方案:MyBatis-Plus自動(dòng)填充
2.1 配置元對(duì)象處理器
@Slf4j
@Component
publicclassAutoFillHandlerimplementsMetaObjectHandler{
// 插入時(shí)自動(dòng)填充
@Override
publicvoidinsertFill(MetaObject metaObject){
this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now());
this.strictInsertFill(metaObject, "createUser", String.class, getCurrentUser());
this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
this.strictUpdateFill(metaObject, "updateUser", String.class, getCurrentUser());
}
// 更新時(shí)自動(dòng)填充
@Override
publicvoidupdateFill(MetaObject metaObject){
this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
this.strictUpdateFill(metaObject, "updateUser", String.class, getCurrentUser());
}
// 獲取當(dāng)前用戶(hù)(從安全上下文)
private String getCurrentUser(){
return Optional.ofNullable(SecurityContextHolder.getContext())
.map(SecurityContext::getAuthentication)
.map(Authentication::getName)
.orElse("system");
}
}
2.2 實(shí)體類(lèi)注解配置
@Data
publicclassBaseEntity{
@TableField(fill = FieldFill.INSERT)
private LocalDateTime createTime;
@TableField(fill = FieldFill.INSERT_UPDATE)
private LocalDateTime updateTime;
@TableField(fill = FieldFill.INSERT)
private String createUser;
@TableField(fill = FieldFill.INSERT_UPDATE)
private String updateUser;
}
// 訂單實(shí)體繼承基類(lèi)
publicclassOrderextendsBaseEntity{
// 業(yè)務(wù)字段...
}
三、進(jìn)階方案:AOP統(tǒng)一處理
3.1 自定義注解
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public@interface AutoFill {
OperationType value();
}
publicenum OperationType {
INSERT,
UPDATE
}
3.2 切面實(shí)現(xiàn)
@Aspect
@Component
@Slf4j
publicclassAutoFillAspect{
@Autowired
private ObjectMapper objectMapper;
@Around("@annotation(autoFill)")
public Object around(ProceedingJoinPoint pjp, AutoFill autoFill)throws Throwable {
Object[] args = pjp.getArgs();
for (Object arg : args) {
if (arg instanceof BaseEntity) {
fillFields((BaseEntity) arg, autoFill.value());
}
}
return pjp.proceed(args);
}
privatevoidfillFields(BaseEntity entity, OperationType type){
String currentUser = getCurrentUser();
LocalDateTime now = LocalDateTime.now();
if (type == OperationType.INSERT) {
entity.setCreateTime(now);
entity.setCreateUser(currentUser);
}
entity.setUpdateTime(now);
entity.setUpdateUser(currentUser);
}
// 獲取當(dāng)前用戶(hù)(支持多線(xiàn)程環(huán)境)
private String getCurrentUser(){
return Optional.ofNullable(RequestContextHolder.getRequestAttributes())
.map(attrs -> (ServletRequestAttributes) attrs)
.map(ServletRequestAttributes::getRequest)
.map(req -> req.getHeader("X-User-Id"))
.orElse("system");
}
}
四、生產(chǎn)環(huán)境最佳實(shí)踐
4.1 多數(shù)據(jù)源適配
@Configuration
publicclassDataSourceConfig{
@Bean
@ConfigurationProperties("spring.datasource.master")
public DataSource masterDataSource(){
return DataSourceBuilder.create().build();
}
@Bean
public MetaObjectHandler metaObjectHandler(){
returnnew MultiDataSourceAutoFillHandler();
}
}
publicclassMultiDataSourceAutoFillHandlerextendsMetaObjectHandler{
// 根據(jù)當(dāng)前數(shù)據(jù)源動(dòng)態(tài)處理
}
4.2 分布式ID生成
publicclassSnowflakeIdGenerator{
// 實(shí)現(xiàn)分布式ID生成
}
// 在自動(dòng)填充中集成
@Override
publicvoidinsertFill(MetaObject metaObject){
this.strictInsertFill(metaObject, "id", String.class,
idGenerator.nextId());
}
五、避坑指南:五大常見(jiàn)問(wèn)題
5.1 空指針異常防護(hù)
// 使用Optional處理可能為空的情況
private String safeGetUser(){
return Optional.ofNullable(SecurityContextHolder.getContext())
.map(SecurityContext::getAuthentication)
.map(Authentication::getPrincipal)
.map(principal -> {
if (principal instanceof UserDetails) {
return ((UserDetails) principal).getUsername();
}
return principal.toString();
})
.orElse("system");
}
5.2 字段覆蓋問(wèn)題
// 在實(shí)體類(lèi)中使用@TableField策略 @TableField(fill = FieldFill.INSERT, updateStrategy = FieldStrategy.NEVER) private String createUser;
六、性能優(yōu)化方案
6.1 緩存當(dāng)前用戶(hù)信息
publicclassUserContextHolder{
privatestaticfinal ThreadLocal<String> userHolder = new ThreadLocal<>();
publicstaticvoidsetUser(String user){
userHolder.set(user);
}
publicstatic String getUser(){
return userHolder.get();
}
publicstaticvoidclear(){
userHolder.remove();
}
}
// 在攔截器中設(shè)置
publicclassUserInterceptorimplementsHandlerInterceptor{
@Override
publicbooleanpreHandle(HttpServletRequest request,
HttpServletResponse response,
Object handler){
UserContextHolder.setUser(request.getHeader("X-User-Id"));
returntrue;
}
}
6.2 批量操作優(yōu)化
@Transactional
publicvoidbatchInsert(List<Order> orders){
// 提前獲取公共字段值
String user = getCurrentUser();
LocalDateTime now = LocalDateTime.now();
orders.forEach(order -> {
order.setCreateTime(now);
order.setCreateUser(user);
order.setUpdateTime(now);
order.setUpdateUser(user);
});
orderMapper.batchInsert(orders);
}
七、監(jiān)控與審計(jì)
7.1 審計(jì)日志集成
@EntityListeners(AuditingEntityListener.class)
publicclassBaseEntity{
@CreatedBy
private String createUser;
@LastModifiedBy
private String updateUser;
@CreatedDate
private LocalDateTime createTime;
@LastModifiedDate
private LocalDateTime updateTime;
}
7.2 操作日志追蹤
@Aspect
@Component
publicclassOperationLogAspect{
@AfterReturning("@annotation(autoFill)")
publicvoidlogOperation(AutoFill autoFill){
LogEntry log = new LogEntry();
log.setOperator(getCurrentUser());
log.setOperationType(autoFill.value().name());
logService.save(log);
}
}
結(jié)語(yǔ): 通過(guò)本文的六種方案組合使用,我們?cè)谏a(chǎn)環(huán)境中實(shí)現(xiàn)了:
- 公共字段維護(hù)代碼量減少90%
- 相關(guān)Bug率下降75%
- 新功能開(kāi)發(fā)效率提升40%
最佳實(shí)踐清單:
- 基礎(chǔ)字段使用MyBatis-Plus自動(dòng)填充
- 復(fù)雜場(chǎng)景結(jié)合AOP處理
- 分布式環(huán)境集成唯一ID生成
- 重要操作添加審計(jì)日志
- 定期檢查字段填充策略
未來(lái)展望: 隨著Spring Data JPA的演進(jìn),未來(lái)可以探索與Reactive編程的結(jié)合,實(shí)現(xiàn)全鏈路的非阻塞式自動(dòng)填充。
到此這篇關(guān)于SpringBoot中公共字段自動(dòng)填充的常用技巧的文章就介紹到這了,更多相關(guān)SpringBoot公共字段自動(dòng)填充內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
SpringBoot如何訪(fǎng)問(wèn)html和js等靜態(tài)資源配置
這篇文章主要介紹了SpringBoot如何訪(fǎng)問(wèn)html和js等靜態(tài)資源配置,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2022-03-03
RedisTemplate中opsForValue和opsForList方法的使用詳解
這篇文章主要介紹了RedisTemplate中opsForValue和opsForList方法的使用詳解,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2021-08-08
阿里云部署SpringBoot項(xiàng)目啟動(dòng)后被殺進(jìn)程的問(wèn)題解析
這篇文章主要介紹了阿里云部署SpringBoot項(xiàng)目啟動(dòng)后被殺進(jìn)程的問(wèn)題,本文給大家分享問(wèn)題原因所在及解決步驟,需要的朋友可以參考下2023-09-09
關(guān)于LinkedList集合對(duì)元素進(jìn)行增查刪操作
LinkedList集合內(nèi)部包含有兩個(gè)Node類(lèi)型的first和last屬性維護(hù)一個(gè)雙向循環(huán)鏈表,在鏈表中的每一個(gè)元素都使用引用的方式來(lái)記住它的前一個(gè)元素和后一個(gè)元素,從而可以將所有的元素彼此連接起來(lái),需要的朋友可以參考下2023-04-04
SpringBoot讀取資源目錄中JSON文件的方法實(shí)例
最近做項(xiàng)目遇到需要將json類(lèi)型的配置文件引用到項(xiàng)目中,已經(jīng)將讀取json文件的方法封裝成工具類(lèi),下面這篇文章主要給大家介紹了關(guān)于SpringBoot讀取資源目錄中JSON文件的相關(guān)資料,需要的朋友可以參考下2023-04-04
SpringBoot+隨機(jī)鹽值+雙重MD5實(shí)現(xiàn)加密登錄
數(shù)據(jù)加密在很多項(xiàng)目上都可以用到,大部分都會(huì)采用MD5進(jìn)行加密,本文主要介紹了SpringBoot+隨機(jī)鹽值+雙重MD5實(shí)現(xiàn)加密登錄,具有一定的參考價(jià)值,感興趣的可以了解一下2024-02-02
Java中if語(yǔ)句return用法和有無(wú)括號(hào)的區(qū)別
本文主要介紹了Java中if語(yǔ)句return用法和有無(wú)括號(hào)的區(qū)別,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2023-12-12
分布式醫(yī)療掛號(hào)系統(tǒng)SpringCache與Redis為數(shù)據(jù)字典添加緩存
這篇文章主要為大家介紹了分布式醫(yī)療掛號(hào)系統(tǒng)SpringCache與Redis為數(shù)據(jù)字典添加緩存,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2022-04-04

