SpringBoot>21 - 集成BeetlSQL做持久层框架

简介:

常见的持久层框架有MyBatis、Spring Data Jpa,BeetlSQL同样也是一款优秀的持久层框架。本章基于 springboot2.0 集成BeetlSQL。

官网地址: http://ibeetl.com/

Beetl: 功能齐全、性能超高、语法简单的模板引擎,而BeetlSQL基于Beetl实现,本章不涉及到Beetl的语法,请到官网学习。

BeetlSQL优势: (来自官网)

构建项目:

1、pom依赖:

    
        org.springframework.boot
        spring-boot-starter-parent
        2.0.1.RELEASE
    

    
        UTF-8
        UTF-8
        1.8
    

    
        
        
            org.springframework.boot
            spring-boot-starter-web
        
        
        
            org.springframework.boot
            spring-boot-starter-test
            
            test
        
        
        
            mysql
            mysql-connector-java
            runtime
        
        
            org.springframework.boot
            spring-boot-starter-jdbc
        
        
        
            com.ibeetl
            beetl-framework-starter
            1.1.63.RELEASE
        
        
        
            com.alibaba
            fastjson
            1.2.31
        

        
            io.springfox
            springfox-swagger2
            2.2.2
        
        
            io.springfox
            springfox-swagger-ui
            2.2.2
        
        
        
            org.projectlombok
            lombok
            1.16.18
        
    

2、properties 配置文件:

###### WEB 路径 端口 ######
server.servlet.path=/
server.port=8080

################### beetsql配置 ########################
# 默认是true,即向控制台输出执行时候的sql,参数,执行时间,以及执行的位置,每次修改sql文件的时候,自动检测sql文件修改
beetl-beetlsql.dev=true
# sql 文件的位置
beetlsql.sqlPath=/sql
beetlsql.basePackage=com.coolron
# 默认是org.beetl.sql.core.UnderlinedNameConversion,能将下划线分割的数据库命名风格转化为java驼峰命名风格,
#还有常用的DefaultNameConversion,数据库命名完全和Java命名一直,以及JPA2NameConversion,兼容JPA命名
#beetlsql.nameConversion=DefaultNameConversion
beetlsql.daoSuffix=Dao
beetlsql.dbStyle=org.beetl.sql.core.db.MySqlStyle

################### mysql数据库连接配置 #################
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/springbootdb?useSSL=false&useUnicode=true&characterEncoding=utf8
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

3、beetlsql 配置类(本章暂只配数据库连接信息):

/**
 * @Description: 数据库配置
 */
@Configuration
public class DataSourceConfig {
    /**
     * BeetlSQL 官方推荐配置
     * 使用的是 Hikari 连接池  springboot2.0 默认支持
     */
    @Bean(name="datasource")
    public DataSource datasource(Environment env) {
        HikariDataSource ds = new HikariDataSource();
        ds.setJdbcUrl(env.getProperty("spring.datasource.url"));
        ds.setUsername(env.getProperty("spring.datasource.username"));
        ds.setPassword(env.getProperty("spring.datasource.password"));
        ds.setDriverClassName(env.getProperty("spring.datasource.driver-class-name"));
        return ds;
    }
  /*  @Bean(name = "datasource")
    public DataSource dataSource(Environment env) {
        String url = env.getProperty("spring.datasource.url");
        String userName = env.getProperty("spring.datasource.username");
        String password = env.getProperty("spring.datasource.password");
        return DataSourceBuilder.create().url(url).username(userName).password(password).build();
    }*/
}

4、新建测试类

/**
 * @Description: 测试 BeetlSQL 内置API
 */
public class BeetlSqlTest {

    public static void main(String[] args) {
        String driver = "com.mysql.jdbc.Driver";
        String url = "jdbc:mysql://127.0.0.1:3306/springbootdb?useSSL=false&useUnicode=true&characterEncoding=utf8";
        String userName = "root";
        String password = "root";

        ConnectionSource source = ConnectionSourceHelper.getSimple(driver, url, userName, password);
        DBStyle mysql = new MySqlStyle();
        // sql语句放在classpagth的/sql 目录下
        SQLLoader loader = new ClasspathLoader("/sql");
        // 数据库命名跟java命名一样,所以采用DefaultNameConversion,还有一个是UnderlinedNameConversion,下划线风格的,
        UnderlinedNameConversion nc = new  UnderlinedNameConversion();

        /**
         * 创建一个SQLManager,DebugInterceptor 不是必须的,但可以通过它查看sql执行情况
         * SQLManager 是系统的核心,他提供了所有的dao方法。获得SQLManager,可以直接构造SQLManager
         */
        SQLManager sqlManager = new SQLManager(mysql,loader,source,nc,new Interceptor[]{new DebugInterceptor()});
         /*
         sqlManager 内置api 用于生产 pojo 和 SQL
         */
         /*
        genPojoCodeToConsole(String table), 根据表名生成pojo类,输出到控制台.
        genPojoCode(String table,String pkg,String srcPath,GenConfig config) 根据表名,包名,生成路径,还有配置,生成pojo代码
        genPojoCode(String table,String pkg,GenConfig config) 同上,生成路径自动是项目src路径,或者src/main/java (如果是maven工程)
        genPojoCode(String table,String pkg),同上,采用默认的生成配置

         genSQLTemplateToConsole(String table),生成查询,条件,更新sql模板,输出到控制台。
        genSQLFile(String table), 同上,但输出到工程,成为一个sql模版,sql模版文件的位置在src目录下,或者src/main/resources(如果是maven)工程.
        genALL(String pkg,GenConfig config,GenFilter filter) 生成所有的pojo代码和sql模版,
        genBuiltInSqlToConsole(Class z) 根据类来生成内置的增删改查sql语句,并打印到控制台
        */
        try {
            //sql.genPojoCodeToConsole("userRole"); 快速生成,显示到控制台
            // 或者直接生成java文件
            // config 类用来配置生成喜好,目前支持生成pojo是否继承某个基类, 是否用BigDecimal代替Double,是否采用Date而不是Timestamp来表示日期,是否是直接输出到控制台而不是文件等
            //GenConfig config = new GenConfig();
            //config.preferBigDecimal(true);
            // 是否继承某个类
            //config.setBaseClass("com.coolron.test.User");
            //sqlManager.genPojoCode("user","com.coolron.test",config);

            // 生产 实体类
            //sqlManager.genPojoCodeToConsole("user");
            // 生成 SQL
            sqlManager.genSQLTemplateToConsole("user");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

运行main方法 可以在控制台输出实体类、SQL,拷贝到对应文件即可。

5、新建controller、service、dao层。
分别使用 BaseMapper、Query查询器、sqlId 做一个示例

5.1、新建controller

@RestController
@RequestMapping(value = "/user")
public class UserController {
    @Autowired
    private UserService userService;
    /**
     * 使用 BaseMapper 查询
     * @param id
     * @return
     */
    @GetMapping(value = "/getUserInfo/{id}")
    public User getUserInfo(@PathVariable Integer id) {
        return userService.getUserInfo(id);
    }
    /**
     * 使用Query 查询器查询   单表操作建议使用
     * @param keyword
     * @return
     */
    @GetMapping(value = "/getUserListQuery")
    public List getUserListQuery(@RequestParam(value = "keyword", required = false) String keyword) {
        return userService.getUserListQuery(keyword);
    }
    /**
     * 使用 sqlId 查询
     */
    @GetMapping(value = "/getUserListSqlId")
    public List getUserListSqlId(@RequestParam(value = "keyword", required = false) String keyword) {
        return userService.getUserListSqlId(keyword);
    }
    @GetMapping(value = "/getUserListPageQuery")
    public PageQuery getUserListPageQuery(@RequestParam(value = "pageNumber", required = false,defaultValue = "1") int pageNumber,
                                          @RequestParam(value = "pageSize", required = false, defaultValue = "10") int pageSize,
                                          @RequestParam(value = "name", required = false) String name) {

        // 构造不一定要这样 可参看PageQuery构造器
        PageQuery query = new PageQuery(pageNumber, pageSize);
        //query.setPageSize(5);
        // 过滤条件
        Map paras = new HashMap(1);
        paras.put("name", name);
        query.setParas(paras);

        System.out.println(query.getTotalPage());
        System.out.println(query.getTotalRow());
        System.out.println(query.getPageNumber());
        List list = query.getList();

        return userService.getUserListPageQuery(query);
    }
}

5.2、service

@Service
public class UserServiceImpl implements UserService {
    @Autowired
    private UserDao userDao;
    @Autowired
    SQLManager sqlManager;
    /**
     * 使用 BaseMapper 查询
     */
    @Override
    public User getUserInfo(Integer id){
        return userDao.unique(id);
    }
    /**
     * Query查询器
     *  针对单表进行操作 建议使用
     */
    @Override
    public List getUserListQuery(String keyword) {
//        Query query = sqlManager.query(User.class);
//        List list = query.andBetween("id", 1, 1640)
//                .andLike("name", "%t%")
//                .andIsNotNull("create_time")
//                .orderBy("id desc").select();
        Query query = sqlManager.query(User.class);
        List list = query.andLike("name", "%"+ keyword + "%")
                .orderBy("id desc").select();
        return list;
    }
    /**
     * 使用 sqlId 查询
     */
    @Override
    public List getUserListSqlId(String keyword) {
        return userDao.selectUserByName(keyword);
    }
    /**
     * PageQuery
     */
    @Override
    public PageQuery getUserListPageQuery(PageQuery query) {
        userDao.getUserListPageQuery(query);
        return query;
    }
}

5.3、dao

/**
 * BaseMapper包含了内置的常用 CRUD
 */
// 通过@SqlResource 注解来指定Mapper对应的sql文件 user.md 文件
// @SqlResource("ron.user")  多级目录
@SqlResource("user")
public interface UserDao extends BaseMapper {
    // JDK 1.8 可不加@Param  但java编译的时候开启-parameters选项
    List selectUserByName(@Param("name") String name);
    void getUserListPageQuery(PageQuery query);
}

5.4、在resources下创建sql文件夹,新建user.md文件用于存放SQL。
user.md 新建几个简单的查询

select
===
* @ 和回车符号是定界符号,可以在里面写beetl语句。
* isEmpty是beetl的一个函数,用来判断变量是否为空或者是否不存在
* "#" 是占位符号
* 文件名约定为类名,首字母小写
select * from user where 1=1
@if(!isEmpty(age)){
and age = #age#
@}
@if(!isEmpty(name)){
and name = #name#
@}

getUserListPageQuery
===
    select  
    @pageTag(){
        a.*
    @}  
    FROM  user a
    where  #use("condition")#
  
selectUserByName
===
* 根据name获user
    select * from user where name= #name#

sample
===
* 注释

    select #use("cols")# from user  where  #use("condition")#

cols
===
    id,age,name,description,cityId

updateSample
===
    id=#id#,age=#age#,name=#name#,description=#description#,cityId=#cityid#

condition
===
    1 = 2  
    @if(!isEmpty(id)){
     and id=#id#
    @}
    @if(!isEmpty(age)){
     and age=#age#
    @}
    @if(!isEmpty(name)){
     and name like #'%'+name+'%'#
    @}
    @if(!isEmpty(description)){
     and description=#description#
    @}
    @if(!isEmpty(cityid)){
     and cityId=#cityid#
    @}

6、测试
可以在控制台看到SQL语句执行信息

6.1、BaseMapper 测试:localhost:8080/user/getUserInfo/1 获取到数据。

┏━━━━━ Debug [user._gen_selectById] ━━━
┣ SQL:   select * from `springbootdb`.`user` where `id` = ?
┣ 参数:    [1]
┣ 位置:    com.coolron.user.service.impl.UserServiceImpl.getUserInfo(UserServiceImpl.java:30)
┣ 时间:    25ms
┣ 结果:    [com.coolron.user.domain.User@3067b8b6]
┗━━━━━ Debug [user._gen_selectById] ━━━

6.2、Query 查询器测试:localhost:8080/user/getUserListQuery?keyword=r

┏━━━━━ Debug [native.SELECT * FROM `springbootdb`.`user` WHERE `...] ━━━
┣ SQL:   SELECT * FROM `springbootdb`.`user` WHERE `name` LIKE ? ORDER BY id desc 
┣ 参数:    [%r%]
┣ 位置:    org.beetl.sql.core.query.Query.selectByType(Query.java:137)
┣ 时间:    4ms
┣ 结果:    [1]
┗━━━━━ Debug [native.SELECT * FROM `springbootdb`.`user` WHERE `...] ━━━

6.3、sqlId测试,即在user.md中定义的。
接口:localhost:8080/user/getUserListPageQuery?name=r 分页查询,返回PageQuery对象。

┏━━━━━ Debug [user.getUserListPageQuery] ━━━
┣ SQL:    select count(1) FROM user a where 1 = 2 and name like ? 
┣ 参数:    [%r%]
┣ 位置:    com.coolron.user.service.impl.UserServiceImpl.getUserListPageQuery(UserServiceImpl.java:60)
┣ 时间:    4ms
┣ 结果:    [1]
┗━━━━━ Debug [user.getUserListPageQuery] ━━━

至此,基本的baseMapper、Query查询器、sqlid三种方式的查询完成。

总结:
1、BeetlSQL 的 basemapper、query查询器是封装好的,其核心是SQLManager。
2、sqlId查询需指定写SQL语句,其SQL模板是基于Beetl语法的。
3、sqlId的方式在Dao层使用@SqlResource("user")指定SQL文件的位置,注意本文中此注解指定路径时没有指定/sql 文件夹,是其在配置文件中指定了。
4、实体类、SQL语句的生成可在测试类中查看相关API。

代码地址:
https://gitee.com/cpla026/beetlsql/tree/master/springboot-beetlsql

个人学习分享
更多 springboot、springcloud、docker 文章关注微信公众号吧:

A罗恩和Java

你可能感兴趣的:(SpringBoot>21 - 集成BeetlSQL做持久层框架)