同步操作将从 Dave-Harris/hibatis 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
——从Mybatis到Hibernate、Spring data JPA,再到QueryDSL,用过了这些框架后,对各种框架的毛病已不胜其烦。在看到Mybatis Plus这样的框架后,突发奇想,不如自己使用mybatis 定制一个数据库持久层框架,实现SQL语句的自动生成。
一个Mybatis增强工具包。新增了5种SQL语句自动生成注解:ExecuteInsert
, ExecuteSelect
, ExecuteCount
, ExecuteUpdate
, ExecuteDelete
。
实现了增删改查语句自动生成。
自动按需关联表。自动收集实体类中声明的关联表、以及方法签名中的参数注解声明的关联表,根据查询参数引用到的关联表、及查询结果视图中 用到的关联表,自动对用到的表进行Join。支持左连接,内连接,右连接。
查询结果支持视图,类似于Jackson Json中的JsonView,可在ExecuteSelect注解中声明查询结果的视图。生成的语句会根据查询结果视图中的字段引用 的表,自动进行Join。如果视图中包含1对1、1对多的关联属性,自动通过二次查询设置属性值。
支持拦截器对Mapper中方法的参数进行修改,以及添加额外的过滤条件和插入值(或更新值)。
支持默认过滤条件、默认插入值(或更新值)、默认排序。具体参考ExecuteInsert
等语句自动生成注解。
MybatisGenerator在监听到ContextRefreshedEvent事件后,在所有已注入的扩展了BaseMapper或EmptyMapper的Mapper中查找使用ExecuteInsert等 注解标注的方法,生成动态SqlSource,注册MappedStatement。
ExecuteInsert方法严格限定只能声明1个参数,可以是单个实例,也可以是集合类型(List或数组)。参数类型可以是实体类型、Map类型及任意的java bean类型。生成插入语句时 根据实体类字段名查找参数中的同名字段进行插入。
插入实体类实例:
@ExecuteInsert
int insert(Entity entity);
插入数组:
@ExecuteInsert
int insertArray(T[] array);
插入列表(使用默认插入值):
@ExecuteInsert(columnValue = {@ColumnValue(field = "updateTime", placeholder = "now()"),
@ColumnValue(field = "createTime", placeholder = "now()")})
int insertList(List<User> users);
使用查询类:
@ExecuteSelect
List<T> selectList(Object query);
查询条数
@ExecuteCount
long selectCount(Object query);
使用Map查询条件
@ExecuteSelect
List<User> searchByCondition(@FilterParam Map<String, Object> condition, @Limit int limit);
查询1条:
@ExecuteSelect(selectOne = true)
T selectOne(Object query);
使用ID查询:
@ExecuteSelect(view = "detail")
User getById(@IdParam long id);
@ExecuteSelect(view = "detail")
List<User> getByIds(@IdParam List<Long> ids);
使用默认参数:
@ExecuteSelect(filter = {@Filter(field = "type", placeholder = "1", conflict = ConflictAction.discard)})
List<User> selectByType(@FilterParam(field = "type") Integer type);
使用关联表字段查询:
@ExecuteSelect(orderBy = "id desc")
List<User> search(@FilterParam(field = "type") int type,
@FilterParam(table = "car", column = "license", type = FilterType.preMatch, join = @Join(table = "car",
joinColumns = @JoinColumn(column = "driver_id", referTable = "user", referColumn = "id"))) String license);
根据ID更新:
@ExecuteUpdate(columnValue = @ColumnValue(field = "updateTime", placeholder = "now()"))
int changeName(@IdParam long id, @ValueParam("name") String name);
@ExecuteUpdate(columnValue = @ColumnValue(field = "updateTime", placeholder = "now()"))
int changeNames(@IdParam List<Long> id, @ValueParam("name") String name);
使用查询类:
@ExecuteUpdate
int updateByCondition(@FilterParam Object condition, @ValueParam Object val);
使用查询参数:
@ExecuteDelete(filter = @Filter(field = "type", placeholder = "1"))
int deleteByCompanyName(@FilterParam(field = "companyName", type = FilterType.preMatch) String companyName);
使用查询类:
@ExecuteDelete
int deleteByCondition(Object condition);
使用ID:
@ExecuteDelete
int deleteByIds(@IdParam List<IdType> keys);
类似于Spring Data JPA,BaseMapper、EmptyMapper的类型参数声明了实体类类型,主键类型。多字段组合主键的实体类,只需将多个主键字段使用@Id标注即可,Mapper中的主键类型参数 可以是包含的所有主键字段的Java bean或Map<String, Object>类型。实体类中的字段可以引用其它表中的列,引用的表必须在@Entity类中声明。
实体类可以包含1对1、1对多字段,分别使用HasOne
,HasMany
标注,支持映射结果视图参数。HasOne
支持排序参数及强制返回1条。HasMany
支持排序参数及指定返回条数。
可以将所有支持的过滤字段使用一个查询类来声明。过滤字段可以引用其它表,如果过滤字段引用了其它表,且实体类@Entity注解没有声明该表,必须在查询类使用Query标注声明该表关联条件。
过滤字段可以使用@Filter注解指定过滤条件运算符(=, >, <, in
等),也可指定对应的实体类字段或数据表中列名,或者声明忽略本字段。查询类可以声明分页及排序的字段或get方法。
分页使用@Limit、@Offset注解,排序使用@Sort注解。
Mapper方法参数可以使用@FilterParam, @IdParam, @ValueParam进行标注。FilterParam标明查询参数或查询bean。IdParam标明id过滤参数,当实体类使用组合主键时,参数应当是
java bean或Map类型,如果参数类型是List或数组,自动使用in
过滤类型。ValueParam标明参数是需要更新的字段值,可以是单个字段(需要标明field属性或column属性)或java bean。
ExecuteSelect
、ExecuteCount
、ExecuteUpdate
、ExecuteDelete
可以指定默认过滤条件,ExecuteInsert
、ExecuteUpdate
可以指定指定数据表列的默认插入(更新)值。
ExecuteSelect
可以指定默认排序。
ExecuteInsert
, ExecuteSelect
, ExecuteCount
, ExecuteUpdate
, ExecuteDelete
均可指定拦截器。拦截器必须是当前Mapper接口的静态方法名或默认方法名,接收1个参数,参数类型为:
InterceptorContext。
同时,可以指定一个全局的拦截器,拦截器必须是GeneratorInterceptor的实例。全局拦截器只有方法没有指定拦截器时有效,不过可以通过静态方法MybatisGenerator.intercept来调用全局拦截器。 全局拦截器必须通过静态方法MybatisGenerator.setDefaultInterceptor(GeneratorInterceptor defaultInterceptor)指定。
query.setSort("createTime desc, id asc")
query.setSort("$[companyName] desc")
query.setSort("$(car).create_time desc")
@Filter, @FilterParam, @ColumnValue, @ValueParam均可指定placeholder。placeholder用于过滤条件运算符右侧或插入值或更新值。可以有以下形式:
1
,(true)
,'男'
。如果字面常量是1个有效的java标识符或属性,应当使用圆括号包围,防止自动加上#{}
,如前面(true)
,如果没有圆括号,会解析成#{true}
。#{$@} + INTERVAL 1 DAY
。$@
自动替换成当前参数或参数字段。$[amount] + 1
。$[amount]
自动替换为实体类中amount
字段对应的表、列名。解析后形式类似于:t0.amount + 1
。$(product).amount + 1
。$(product)
自动替换为表名。解析后形式类似于:t0.amount + 1
。HasOne和HasMany字段必须是关联的实体类类型或实体类的集合类(数组或List)。HasOne和HasMany标注必须指定过滤条件(filter属性)。
且过滤条件必须指定placeholder,placeholder可以是当前实体类的其它字段,也可以是常量。如果placeholder是一个表达式,引用实体类中的字段时,
使用$[fieldName]
格式或$(tableName).columnName
或$(tableName.tableAlias).columnName
。表名及表别名组合必须是当前实体类对
应的表或@Entity注解声明的关联表。
在实现多态表自Join时,需要表别名,通常表别名保持为空字符串即可。如user表中包含员工和老板时,查询王老板的员工时,需要用到自Join。
方法参数、默认值、拦截器三者都可以生成过滤条件。这些过滤条件引用的数据表字段重复时,根据ConflictAction类型按照以下规则进行:
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。