mybatis plus CU自動填充 和 軟刪除自動填充的實現(xiàn)方法
說明
CU 是 CRUD 中的創(chuàng)建和修改
本文實現(xiàn)以下需求效果
- 創(chuàng)建數(shù)據(jù)時自動填充
createTime
- 更新數(shù)據(jù)時自動填充
updateTime
(每次修改都自動填充新的updateTime
值) - 軟刪除數(shù)據(jù)時自動填充
deleteUserId
和deleteTime
創(chuàng)建
實體類
為實體類(DO)的 createTime
字段配置以下 Annotation,代表標記在插入(insert into)時自動填充字段值
@TableField(fill = FieldFill.INSERT) private Date createTime;
實現(xiàn) MetaObjectHandler
如果實體(DO)中配置了上面的注解,就會執(zhí)行這個 handler。這里在 insert 時自動填充 createTime
字段的值
public class MybatisPlusMetaObjectHandler implements MetaObjectHandler { private static final String createTime = "createTime"; @Override public void insertFill(MetaObject metaObject) { this.strictInsertFill(metaObject, createTime, Date::new, Date.class); // 關于 is_delete 字段,這里不提供默認值,因為官方推薦設置數(shù)據(jù)庫中列的默認值 } @Override public void updateFill(MetaObject metaObject) {} }
配置
注入 IOC 容器。
在 MybatisPlusMetaObjectHandler
類上配置 @Configuration
注解也可以達到同樣目的。
@Configuration public class MybatisPlusConfig { @Bean public MybatisPlusMetaObjectHandler mybatisPlusCommonDateFieldValueFillHandler(){ return new MybatisPlusMetaObjectHandler(); } }
更新
實體類
在實體類(DO)上配置注解
@TableField(fill = FieldFill.UPDATE) private Date updateTime;
實現(xiàn) MetaObjectHandler
如果實體(DO)中配置了上面的注解,就會執(zhí)行這個 handler。這里在 update 時自動填充 updateTime
字段的值
特別注意,這里需要重寫 strictFillStrategy
方法,因為默認的行為不會按照預期執(zhí)行(每次更新數(shù)據(jù)時都更新 updateTime
)
public class MybatisPlusMetaObjectHandler implements MetaObjectHandler { private static final String updateTime = "updateTime"; @Override public void insertFill(MetaObject metaObject) {} @Override public void updateFill(MetaObject metaObject) { this.strictUpdateFill(metaObject, updateTime, Date::new, Date.class); } /** * 嚴格模式填充策略,默認有值不覆蓋,如果提供的值為null也不填充 * * @param metaObject metaObject meta object parameter * @param fieldName java bean property name * @param fieldVal java bean property value of Supplier * @return this * @since 3.3.0 */ @Override public MetaObjectHandler strictFillStrategy(MetaObject metaObject, String fieldName, Supplier<?> fieldVal) { // 但當自動填充字段為 updateTime 時,始終更新它 if (fieldName.equals(updateTime)) { Object obj = fieldVal.get(); metaObject.setValue(fieldName, obj); } else if (metaObject.getValue(fieldName) == null) { // 這個 if 是源碼中的 Object obj = fieldVal.get(); if (Objects.nonNull(obj)) { metaObject.setValue(fieldName, obj); } } return this; } }
配置
參考創(chuàng)建章節(jié)中的配置,如果已經(jīng)配置了就不需要再配置了
軟刪除
配置 application.yml
mybatis-plus: global-config: db-config: logic-delete-field: is_delete # 邏輯刪除屬性名稱(為數(shù)據(jù)庫中的字段名稱) logic-delete-value: 1 # 代表已刪除的值 logic-not-delete-value: 0 # 代表未刪除的值
實體類
在實體類(DO)中對以下字段配置注解。
標識 isDelete
字段作為邏輯刪除的標識,然后有兩個需要自動填充值的字段。
/** * 邏輯刪除標識 * * \@TableLogic\ 注解標記邏輯刪除屬性 */ @TableLogic private Boolean isDelete; @TableField(fill = FieldFill.UPDATE) private Integer deleteUserId; @TableField(fill = FieldFill.UPDATE) private Date deleteTime;
重寫 DefaultSqlInjector
如果需要在軟刪除時自動填充其他字段的值,才需要重寫這個 DefaultSqlInjector
,否則忽略本小節(jié)。
這里配置了邏輯刪除時填充其他字段值的 SqlInjector
public class MybatisPlusSqlInjector extends DefaultSqlInjector { @Override public List<AbstractMethod> getMethodList(Class<?> mapperClass) { final List<AbstractMethod> methods = super.getMethodList(mapperClass); methods.add(new LogicDeleteByIdWithFill()); return methods; } }
實現(xiàn) MetaObjectHandler
由于 mybatis plus 的 @TableField
注解枚舉字段 fill
的值沒有我們想要的 Delete
,所以 Update
和 Delete
實際上都是走的 updateFill
函數(shù),在函數(shù)內(nèi)部我們需要區(qū)分出到底是更新還是軟刪除,才能繼續(xù)下一步即自動填充不同行為下字段的值
public class MybatisPlusMetaObjectHandler implements MetaObjectHandler { private static final String deleteUserId = "deleteUserId"; private static final String updateTime = "updateTime"; private static final String deleteTime = "deleteTime"; @Override public void insertFill(MetaObject metaObject) {} @Override public void updateFill(MetaObject metaObject) { // 有這兩個字段并且也已經(jīng) deleteUserId 有值(外面必須為實體類設置 deleteUserId 字段的值),deleteTime 外面不給值 if (metaObject.hasGetter(deleteUserId) && metaObject.hasGetter(deleteTime) && !ObjectUtil.isNull(metaObject.getValue(deleteUserId)) && ObjectUtil.isNull(metaObject.getValue(deleteTime))) { this.strictUpdateFill(metaObject, deleteUserId, () -> (Integer) metaObject.getValue(deleteUserId), Integer.class); this.strictUpdateFill(metaObject, deleteTime, Date::new, Date.class); } else { this.strictUpdateFill(metaObject, updateTime, Date::new, Date.class); } } /** * 嚴格模式填充策略,默認有值不覆蓋,如果提供的值為null也不填充 * * @param metaObject metaObject meta object parameter * @param fieldName java bean property name * @param fieldVal java bean property value of Supplier * @return this * @since 3.3.0 */ @Override public MetaObjectHandler strictFillStrategy(MetaObject metaObject, String fieldName, Supplier<?> fieldVal) { // 但當自動填充字段為 updateTime 時,始終更新它 if (fieldName.equals(updateTime)) { Object obj = fieldVal.get(); metaObject.setValue(fieldName, obj); } else if (metaObject.getValue(fieldName) == null) { // 這個 if 是源碼中的 Object obj = fieldVal.get(); if (Objects.nonNull(obj)) { metaObject.setValue(fieldName, obj); } } return this; } }
配置(注入到 IOC)
我們需要將上面寫的 MybatisPlusSqlInjector
注入 IOC 容器。
同樣的,這兩個 Bean 的配置,與在 MybatisPlusSqlInjector
和 MybatisPlusMetaObjectHandler
上配置 @Configuration
注解的效果一樣。
@Configuration public class MybatisPlusConfig { @Bean public MybatisPlusSqlInjector mybatisPlusSqlInjector(){ return new MybatisPlusSqlInjector(); } @Bean public MybatisPlusMetaObjectHandler mybatisPlusCommonDateFieldValueFillHandler(){ return new MybatisPlusMetaObjectHandler(); } }
創(chuàng)建 MyBaseRepository
我這里將 Mapper
稱為 Repository
。因為我用到了 MapStruct
庫,個人感覺它更適合被稱為 Mapper
。
我們需要自己定義一個 MyBaseMapper 繼承自 BaseMapper(mybatis plus 的),然后添加一個如下的方法簽名,必須跟下面示例代碼一樣,因為我猜測內(nèi)部是通過反射來調用的這個函數(shù),所以方法簽名必須一致,否則無法被 mybatis plus 庫調用哦。
public interface MyBaseMapper<Entity> extends BaseMapper<Entity> { /** * 邏輯刪除填充其他字段的值 * * @param entity 要刪除的實體對象 * @return 受影響記錄數(shù)量 */ int deleteByIdWithFill(Entity entity); }
我們原來的 Repository
繼承自 mybatis plus 的 BaseMapper
,現(xiàn)在我們需要修改為繼承自上面新寫的 MyBaseMapper
。
創(chuàng)建 MyBaseService
因為我希望 XXXService
中也有 deleteByIdWithFill
函數(shù),所以這里我還自定義了 Service 的基類,如果不需要的話可以忽略本小節(jié)。
自定義的 MyBaseService
繼承自 mybatis plus 的 IService<>
接口,然后添加如下方法簽名,注意方法簽名中的返回值是 boolean
而不是 int
,因為寫 Service 需要方便外部使用。
public interface MyBaseService<Entity> extends IService<Entity> { /** * 邏輯刪除填充其他字段的值 * * @param entity 要刪除的實體對象 * @return 受影響記錄數(shù)量 */ boolean deleteByIdWithFill(Entity entity); }
然后我們寫一個 MyBaseService
的實現(xiàn)類。
注意這里我們需要繼承自 mybatis plus 的 ServiceImpl
實現(xiàn),減少我們自己實現(xiàn)的代碼量,同時還需要實現(xiàn)我們的 MyBaseService
接口,然后內(nèi)部寫的巴巴適適的😋
public class MyBaseServiceImpl<EntityRepository extends MyBaseMapper<Entity>, Entity> extends ServiceImpl<EntityRepository, Entity> implements MyBaseService<Entity> { /** * 邏輯刪除填充其他字段的值 * * @param entity 要刪除的實體對象 * @return 受影響記錄數(shù)量 */ @Override public boolean deleteByIdWithFill(Entity entity) { return SqlHelper.retBool(getBaseMapper().deleteByIdWithFill(entity)); } }
最后,原來的 XXXService
修改為繼承自新寫的 MyBaseService
,XXXServiceImpl
修改為繼承自新寫的 MyBaseServiceImpl
public interface TestService extends MyBaseService<Test> {} @Service public class TestServiceImpl extends MyBaseServiceImpl<TestRepository, Test> implements TestService{}
食用🍜
在 Controller
中的使用方法
@PostMapping("delete") public ResponseEntity<?> delete(@Valid @NotNull(message = CommonRule.error.whenParamNull) @RequestBody TestTestDeleteBodyVo body) { final Test test = testService.getById(body.getId()); if (test == null) { return ResponseEntity.ok().build(); } test.setDeleteUserId(StpUtil.getLoginIdAsInt()); // 必須在軟刪之前設置 deleteUserId 字段的值 testService.deleteByIdWithFill(test); // 軟刪除必須是這樣刪除 return ResponseEntity.ok().build(); }
到此這篇關于mybatis plus CU自動填充 和 軟刪除自動填充的文章就介紹到這了,更多相關mybatis plus自動填充內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家!
相關文章
解決spring cloud zuul與nginx的域名轉發(fā)問題
這篇文章主要介紹了spring cloud zuul與nginx的域名轉發(fā)問題,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教2021-07-07Java面試題之HashMap 的 hash 方法原理是什么
那天,小二去蔚來面試,面試官老王一上來就問他:HashMap 的 hash 方法的原理是什么?當時就把裸面的小二給蚌埠住了,這篇文章將詳細解答該題目2021-11-11Java微信二次開發(fā)(一) Java微信請求驗證功能
這篇文章主要為大家詳細介紹了Java微信二次開發(fā)第一篇,Java微信請求驗證功能,具有一定的參考價值,感興趣的小伙伴們可以參考一下2017-04-04