TgDao是一款基于Mybatis的编译期SQL生成器,利用注解来表达SQL,能根据你的方法签名生成对应的Mapper.xml文件。它能减少你日常开发中大量简单SQL的编写,由于它只是生成Mapper.xml文件,因此对于复杂的查询场景,你同样可以自己编写来完成一些工具所无法生成的SQL。
@Table(name = "T_User")
public class User {
@Id("id")
private int id;
private String username;
private int age;
}
上面的model定义了模型和数据库表的关系,看到下面这些方法的签名,聪明的你肯定能猜出每个方法的sql吧,这就是这个库要做的工作。
@DaoGen(model = User.class)
public interface UserDao {
@Select
@OrderBy("id desc")
List<User> queryUser(@Condition(criterion = Criterions.EQUAL, column = "username") String name,
@Condition(criterion = Criterions.GREATER, attach = Attach.OR) int age,
@Limit int limit, @OffSet int offset);
@Select
List<User> queryUser2(@Condition(criterion = Criterions.GREATER, column = "age") int min,
@Condition(criterion = Criterions.LESS, column = "age") int max);
@Select
List<User> queryUser3(@Condition(criterion = Criterions.EQUAL, column = "username") String name,
@Condition(attach = Attach.OR, column = "id", criterion = Criterions.IN) String[] ids);
@Insert(useGeneratedKeys = true, keyProperty = "id")
int insert(User user);
@BatchInsert(columns = "username,age")
int batchInsert(List<User> users);
@Update
@ModelConditions({
@ModelCondition(field = "id")
})
int update(User user);
@Delete
int delete(@Condition(criterion = Criterions.GREATER, column = "age") int min,
@Condition(criterion = Criterions.LESS, column = "age") int max);
}
引入如下依赖:
<dependency>
<groupId>com.github.twogoods</groupId>
<artifactId>tgdao-core</artifactId>
<version>0.1.0</version>
</dependency>
@Table
记录数据表的名字
@Id
记录主键信息
@Column
映射了表字段和属性的关系,如果表字段和类属性同名,那么可以省略这个注解
@Ingore
忽略这个类属性,没有哪个表字段与它关联
@Table(name = "T_User")
public class User {
@Id("id")
private int id;
private String username;
private String password;
private int age;
@Column("old_address")
private String oldAddress;
@Column("now_address")
private String nowAddress;
private int state;
@Column("created_at")
private Timestamp createdAt;
@Column("updated_at")
private Timestamp updatedAt;
@Ignore
private String remrk;
@Select
@OrderBy("id desc")
List<User> queryUser(@Condition(criterion = Criterions.EQUAL, column = "username") String name,
@Condition(criterion = Criterions.GREATER, attach = Attach.OR) int age,
@Condition(column = "id", criterion = Criterions.IN) String[] ids,
@Limit int limit, @OffSet int offset);
columns
:默认select *
可以配置columns("username,age")
选择部分字段;SqlMode
:有两个选择,SqlMode.SELECTIVE 和 SqlMode.COMMON,区别是selective会检查查询条件的字段是否为null来实现动态的查询,即<if test="name != null">username = #{name}</if>
关于selective: 出于mysql字段不为null这个基础,insert的字段是selective的;update set 语句是selective的而where里不是selective的;delete的where里不是selective的;select where 里可选。
criterion
:查询条件,=
,<
,>
,in
等,具体见Criterions
column
:与表字段的对应,若与字段名相同可不配置attach
:连接and
,or
, 默认是and
test
:selective下的判断表达式,即<if test="username != null">
里的test属性
@Limit
,@OffSet
为分页字段。
方法的参数不加任何注解一样会被当做查询条件,如下面两个函数效果是一样的:
@Select()
List<User> queryUser(Integer age);
@Select()
List<User> queryUser(@Condition(criterion = Criterions.EQUAL, column = "age") Integer age);
上面的例子在查询条件比较多时方法参数会比较多,我们可以把查询条件封装到一个类里,使用@ModelConditions
来注解查询条件,注意被@ModelConditions
只能有一个参数。
@Select
@Page
@ModelConditions({
@ModelCondition(field = "username", criterion = Criterions.EQUAL),
@ModelCondition(field = "minAge", column = "age", criterion = Criterions.GREATER),
@ModelCondition(field = "maxAge", column = "age", criterion = Criterions.LESS),
@ModelCondition(field = "ids", column = "id", criterion = Criterions.IN),
@ModelCondition(field = "idArr", column = "id", criterion = Criterions.IN, paramType = InType.ARRAY)
})
List<User> queryUser5(UserSearch userSearch);
field
:必填,查询条件中类对应的属性column
:对应的表字段paramType
:in 查询下才需要配置,数组为array
,List为collection
类型test
:selective下的判断表达式,即<if test="username != null">
里的test属性
@Page
只能用在ModelConditions下的查询,并且方法参数的那个类应该有offset
,limit
这两个属性。
查询参数里@Limit
,@OffSet
或查询model里@Page
的分页功能都比较原始,TgDao只是一款SQL生成器而已,因此你可以使用各种插件,或者与其他框架集成。对于分页,可以无缝与PageHelper整合。
@Select
List<User> queryUser2(@Condition(criterion = Criterions.GREATER, column = "age") int min,
@Condition(criterion = Criterions.LESS, column = "age") int max);
@Test
public void testQueryUser2() throws Exception {
PageHelper.offsetPage(1, 10);
List<User> users = mapper.queryUser2(12, 30);
PageInfo page = new PageInfo<>(users);
System.out.println(page.getTotal());
Assert.assertTrue(page.getList().size() > 0);
}
@Insert(useGeneratedKeys = true, keyProperty = "id")//获取自增id
int insert(User user);
@BatchInsert(columns = "username,age")//插入的列
int batchInsert(List<User> users);
BatchInsert
强烈建议写columns,因为生成的语句并不会过滤null字段,数据库中插入null易报错。
@Update(columns = "username,age")//选择更新某几个列
@ModelConditions({
@ModelCondition(field = "id")
})
int update(User user);
@Delete
int delete(@Condition(criterion = Criterions.GREATER, column = "age") int min,
@Condition(criterion = Criterions.LESS, column = "age") int max);
@Delete
@ModelConditions({
@ModelCondition(attach = Attach.AND, field = "minAge", column = "age", criterion = Criterions.GREATER),
@ModelCondition(attach = Attach.AND, field = "maxAge", column = "age", criterion = Criterions.LESS)
})
int delete2(UserSearch userSearch);
更多请看example
- 编译生成的XML文件与Mapper接口在同一个包下
- 只支持Java8和MySql
- 修改了源代码中方法的定义或者model里和数据表的映射关系,发现编译出来的xml却没有改变,这是增量编译的原因。你修改了一部分代码,还有一部分未修改的代码编译器就不做处理,这样无法得到这部分信息,所以TgDao无法生成最新版本的xml。解决方法是每次
mvn clean compile
先清除一下编译目录,更好的方案正在寻找... - Mybatis里我们经常会用到
@Param
来告诉Mybatis参数的名称,这是因为Java编译后的字节码把方法的参数信息给抹去了,在Java8中可以通过给javac 添加-parameters
参数来保留参数名字信息,这样mybatis会利用这个信息,这样就不需要加@Param
注解了。TgDao利用了这个特性,所以请加上-parameters
配置,各种构建工具都可以配置这个选项,贴出Maven的配置:
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.1</version>
<configuration>
<compilerArgs>
<arg>-parameters</arg>
</compilerArgs>
</configuration>
</plugin>
如果在运行时看到mybatis报错如:Parameter 'XXX' not found. Available parameters are...
你也可以手动加上@Param
注解
增量编译和annotation processors
https://issues.gradle.org/browse/GRADLE-3259
how to debug http://blog.jensdriller.com/how-to-debug-a-java-annotation-processor-using-intellij/