beetlSQL实践 (一) 基本配置

beetlSQL超过MyBatis的全功能Java DAO工具。BeetSql是一个全功能DAO工具， 同时具有Hibernate 优点 & Mybatis优点功能，适用于承认以SQL为中心，同时又需求工具能自动能生成大量常用的SQL的应用。

功能	说明
开发效率高	无需注解，自动使用大量内置SQL，轻易完成增删改查功能，节省50%的开发工作量。 数据模型支持Pojo，也支持Map/List这种快速模型，也支持混合模型。 SQL 模板基于Beetl实现，更容易写和调试，以及扩展。 可以针对单个表(或者视图）代码生成pojo类和sql模版，甚至是整个数据库。能减少代码编写工作量
易于维护	SQL 以更简洁的方式，Markdown方式集中管理，同时方便程序开发和数据库SQL调试。可以自动将sql文件映射为dao接口类。灵活直观的支持支持一对一，一对多，多对多关系映射而不引入复杂的OR Mapping概念和技术。具备Interceptor功能，可以调试，性能诊断SQL，以及扩展其他功能
支持主从数据库	内置支持主从数据库支持的开源工具
支持跨数据库平台	开发者所需工作减少到最小，目前跨数据库支持mysql,postgres,oracle,sqlserver,h2,sqllite,DB2.

由于现在大部分都已经通过maven来管理项目，本篇我们则5分钟搭建一个小项目，来体验一下beetlSQL。

1、maven依赖(beetlSQL以及mysql)

<dependency>
            <groupId>com.ibeetlgroupId>
            <artifactId>beetlsqlartifactId>
            <version>2.10.2version>
        dependency>
        <dependency>
            <groupId>com.ibeetlgroupId>
            <artifactId>beetlartifactId>
            <version>2.7.26version>
        dependency>

        <dependency>
            <groupId>mysqlgroupId>
            <artifactId>mysql-connector-javaartifactId>
            <version>5.1.32version>
        dependency>

2、创建一个Pojo类，与数据库对应

/**
 * @Author:XXX
 * @Description:
 * @Date: Create in 16:01 2018/1/22
 */
public class User extends TailBean{
    private Integer id ;
    private Integer age ;
    /**
     * 用户角色
     */
    private Integer roleId ;
    private String name ;
    /**
     * 用户名称
     */
    private String userName ;
    private Date createDate ;

3、代码实践

 public static void connectionBeet(String driver, String url, String userName, String password) {
        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 sqlManager = new SQLManager(mysql, loader, source, nc, new Interceptor[]{new DebugInterceptor()});

        //插入一条记录，主键ID自增
        /*User user=new User();
        user.setAge(19);
        user.setName("haha");
        sqlManager.insertTemplate(user);*/

        //根据主键查询唯一记录
        /*int id=2;
        user=sqlManager.unique(User.class,id);*/

        //根据主键更新，属性为null的不会更新
        /*User newUser=new User();
        newUser.setId(1);
        newUser.setAge(18);
        sqlManager.updateTemplateById(newUser);*/

        //根据字段值查询列表
        /*User queryUser = new User();
        queryUser.setAge(19);
        List users = sqlManager.template(queryUser);
        System.out.println(users.size());*/

        //使用.md文件实现功能（详情User.md文件）
        User queryUser2=new User();
        queryUser2.setAge(19);
        List users=sqlManager.select("user.select",User.class,queryUser2);
        System.out.println(users.size());

    }

public static void main(String[] args) {
        String driver = "com.mysql.jdbc.Driver";
        String url = "jdbc:mysql://XXX:5001/tmp?useUnicode=true&characterEncoding=utf-8";
        String userName = "root";
        String password = "XXX";
        connectionBeet(driver, url, userName, password);
    }

使用beetlSQL,我们可以简写好多SQL语句，比如上述实例中的实践，除了md文件实践以外，其他的都是自动生成SQL，很好用的api，可以直接查询官方文档使用。

对于.md文件的，如下：

select
===
select * from user where 1=1 
@if(!isEmpty(age)){
and age=#age#
@}
@if(!isEmpty(name)){
and name=#name#
@}

需求为：根据年龄和名字查询信息，如果不为空的话。
1. ===上面试sql语句的唯一标示，下边则是sql语句实现；
2. @和回车符都是定界符号；
3. #是占位符，两个#合成，会生成一个？号
4. isEmpty是beetl的一个函数，用来判断变量是否为空或者是否不存在.
5. 文件名约定为类名，但是和普通类名规范不同的是首字母小写。

这里要注意的一点是：主键需要通过注解来说明，如@AutoID，或者@AssignID等，但如果是自增主键，且属性是名字是id，则不需要注解，自动认为是自增主键。如果属性值为ID的话，则可以直接忽略。

4、常用定界符号

事先说明，一些定位符号的使用是可以自定义设计的，本篇，小编则主要说几个常用的符号。

表达式	举例
模糊查询	select * from user where name like #’%’+name+’%’#
逻辑表达式	user.gender==1?’女’:’男’# 支持 逻辑与，或，非，以及三元表达式

5、上述讲到beetlSQL支持主从数据库，留在下篇介绍。