JDBC快速开发工具包fastjdbc使用介绍

介绍一个开源的jdbc操作工具类fastjdbc,一个基于SpringBoot框架开发的jdbc快速开发工具包
它实际上是对spring框架提供的NamedJdbcTemplate类的二次封装,提供一种基于注解方式的API配置方式去操作sql,而不是调用NamedJdbcTemplate的方法去传递sql语句。

安装


        
            com.github.paganini2008.springdessert
            fastjdbc-spring-boot-starter
            2.0.3
        

(以最新版为准)

快速开始


下面举几个例子,看看fastjdbc-spring-boot-starter是怎么使用的

@Dao
public interface UserDao {

    @Insert("insert into tb_user(username,password,age) values (:username,:password,:age)")
    int saveUser(@Example User user);

    @Update("update tb_user set username=:username, password=:password where id=:id")
    int updateUser(@Example User user);

    @Update("delete from tb_user where id=:id")
    int deleteUser(@Arg("id") int id);
    
    @Batch("insert into tb_user(username,password,age) values (:username,:password,:age)")
    int batchSaveUser(@Args List userList);

    @Get("select * from tb_user where id=:id")
    User getById(@Arg int id);
    
    @Query("select * from tb_user order by create_time desc")
    List> queryUser();

    @Query("select * from tb_user where 1=1 @sql order by create_time desc")
    List> queryUserByCondition(@Sql String whereCondition, @Example Map queryExample);

    @Select("select * from tb_user order by create_time desc")
    ResultSetSlice selectUser();

}

API很简单,但需要的注意事项:

  1. @Insert 返回的是主键ID, 可以是int或long类型的
  2. @Update 返回的是受影响的行数,它可以执行insert, update, delete 语句
  3. @Batch 返回的也是受影响的行数
  4. @Get 可以返回对象也可以返回单个值(包装类型或基础类型),设置属性javaType=true即可
  5. @Example 参数可以是Pojo对象也可以是Map, @Arg表示一个参数,@Args表示多个参数,用于批处理
  6. @Query 返回列表,其中@Sql表示是动态sql, 比如你可以根据查询条件动态拼装sql
  7. @Query和@Select很像,@Query,是不分页的,@Select既支持分页,又支持列表,返回ResultSetSlice对象,这个对象异常强大,有兴趣的朋友可以研究一下
  8. sql语句的写法和Spring框架中NamedParameterJdbcTemplate的写法一致,实质上还是通过它来执行sql语句的
    (API具体用法可以参考源码)

最后,在你Spring Boot应用中,在你自己的Configuration类上中加入Dao扫描器即可,比如:

@DaoScan(basePackages = "com.yourcompany.project.base.dao")
@Configuration(proxyBeanMethods = false)
public class YourConfiguration {

}

git地址:https://github.com/paganini20...

你可能感兴趣的:(JDBC快速开发工具包fastjdbc使用介绍)