summerDao是summer框架中的一个数据库操作工具,项目地址:http://git.oschina.net/xiwa/summer。
怎么比mybatis更强大,怎么比beetlsql更简单,如何无需映射配置,看看它是如何使用的就知道了~
单表orm操作
单表orm准备步骤
1、 在App.java中配置自动生成实体类存放目录
2、在App.java中配置生成实体类规则
系统提供了2种映射规则:
DefaultBeanMapperRule-和表字段名保持一致
UnderlinedBeanMapperRule-将下划线风格的字段名称转换为驼峰风格的bean属性名
3、添加自动生成实体类代码
系统提供了mysql数据库的数据类型映射规则,其它数据库请自行添加。
4、执行AppTool启动自动实体生成(不关闭,一旦有脚本更新或添加就会生成对应的实体类文件)
5、使用数据库工具生成Bean_create.sql建表脚本放在resources对应模块db目录
如,生成Address_create.sql放在resources/summer/sample/area/db目录,此时可以看到在对应包summer.sample.area.db中已经生成了Address.java文件。
单表orm关系映射是依靠Bean_create.sql来完成的,生成好实体类后请不要删除。
一、单表orm查询:list(Class elementType, Object... args)
elementType
要返回的实体类型。
args
查询条件,可以是任意多个bean或ConditionEntity对象。
二、单表orm分页查询
和普通查询一样,只需要在访问时带上page或pageSize参数即可,如:area/getAddresses.json?page=1
注:同一个请求中同时只能存在一个查询需要分页,其它查询不需要分页的要使用all。
三、单表orm排序查询:list(Class elementType, OrderBy orderBy, Object... args)
elementType
要返回的实体类型。
orderBy
排序信息,可链式调用。
args
查询条件,可以是任意多个bean或ConditionEntity对象。
四、单表orm查询所有:all(Class elementType, Object... args)
同list方法,但不支持分页查询
五、单表orm取单条记录:get(Class type, Object... args)
type
要返回的实体类型。
args
查询条件,可以是任意多个bean或ConditionEntity对象。
六、单表orm新增:int insert(T bean)
七、单表orm按主键更新:int update(T bean)
八、单表orm按条件更新:int update(T bean, ConditionEntity condition)
九、单表orm按主键删除:int delete(T bean)
十、单表orm按条件删除:int delete(Class type, ConditionEntity condition)
根据sqlId增删改查
1.sql配置文件,文件名:sql-名称.xml
sql配置文件中必须包含query、insert、update、delete四个节点,分别放置不同语义的sql。
2.sql语句格式
一、根据sqlId查单条记录:T get(String sql, Class type, Object... args)
sql
sqlId或完整sql语句。
type
要返回的实体类型。
args
查询条件,可以是任意多个bean或ConditionEntity对象。
二、根据sqlId查询:list(String sql, Class elementType, Object... args)
sql同上,支持自动分页查询。当需要分页查询时,只需要在访问时带上page或pageSize参数即可,如:area/getAddresses.json?page=1
注:同一个请求中同时只能存在一个查询需要分页,其它查询不需要分页的要使用all。
sql
sqlId或完整sql语句。
elementType
要返回集合中的实体类型。
args
查询条件,可以是任意多个bean或ConditionEntity对象。
三、根据sqlId分页查询:page(String sql, Class elementType, int pageSize, int page, Object... args)
sql同上,专门的分页查询。
sql
sqlId或完整sql语句。
elementType
要返回集合中的实体类型。
pageSize
分页大小。
page
当前页码。
args
查询条件,可以是任意多个bean或ConditionEntity对象。
四、根据sqlId强制查询所有:all(String sql, Class elementType, Object... args)
同list方法,但不支持分页查询,强制查询所有。
五、根据sqlId组合查询
为一个sql节点添加多个子sql,并设置子sql的name属性,代码中根据业务场景使用"+"连接父sqlId和子sql的name作为一个完全的sql执行。
sql配置 代码
六、根据sqlId级联查询
1.一对一级联查询
创建实体类:Address.java、City.java、AddressVo.java
sql配置,使用子sql标签,写上要级联查询的sql,并设置prop为对应级联的属性名。
使用"sqlId<-prop"作为sqlId进行查询。
2.一对多级联查询
创建实体类:Address.java、City.java、CityVo.java
sql配置,使用子sql标签,写上要级联查询的sql,并设置prop为对应级联的属性名。
使用"sqlId<-prop"作为sqlId进行查询。
七、根据sqlId新增、修改、删除:int update(String sql, Object... args)
新增、修改、删除都使用update方法