SQL查询构造器

sqlHelper：SQL查询构造器

搞了几年的PHP开发，接触到好些PHP框架，数据库模型这块，发现CodeIgniter框架的语法非常 通俗易懂，也容易记。

最近在学习Java，接触到JFinal框架，使用起来也非常简单，有点脚本语言的味道，但是模型这块，打算让它更好玩一些。

于是，想到把CodeIgniter框架的这套模型语法搬到JFinal框架上来，这样就可以节省手写SQL字符串的时间。

核心文件

主要用到2个类文件：

(1) SqlHelper.java : 专门用来拼接SQL字符串的，最终输出完整的SQL语句；

(2) DbHelper.java : 继承了SqlHelper类，简单封装了JFinal框架执行SQL语句的API，让自己有执行SQL语句的能力；

语法如下

• 查询
• 搜索
• 模糊搜索
• 排序
• 分页与计数
• 查询条件组
• 插入数据
• 更新数据
• 删除数据
• 链式方法
• 查询构造器缓存
• 重置查询构造器
• 对JFinal DB API 简单封装
• 对JFinal Model API 简单封装

查询^[1]

下面的方法用来构建 SELECT 语句。

select("title,content,date")

该方法用于编写查询语句中的 SELECT 子句：

List list = DbHelper.create()
        .select("title,content,date")
        .findAll("mytable");
// 执行： SELECT `title`, `content`, `date`
// FROM `mytable`

注意：如果你要查询表的所有列，可以不用写这个函数，SqlHelper 会自动查询所有列（SELECT *）。

select() 方法的第二个参数可选，如果设置为 FALSE，SqlHelper 将不保护你的 表名和字段名，这在当你编写复合查询语句时很有用，不会破坏你编写的语句。

List list = DbHelper.create()
        .select("(SELECT SUM(payments.amount) FROM payments WHERE payments.invoice_id=4) AS amount_paid", false)
        .findAll("mytable");
// 执行：SELECT (SELECT SUM(payments.amount) FROM payments 
// WHERE payments.invoice_id=4) AS amount_paid
// FROM `mytable`

selectMax()

该方法用于编写查询语句中的 SELECT MAX(field) 部分，你可以使用第二个参数（可选）重命名结果字段。

List list = DbHelper.create()
      .selectMax("age")
      .findAll("members");
// 执行：SELECT MAX(`age`) AS `age`
// FROM `members`

List list = DbHelper.create()
      .selectMax("age", "member_age")
      .findAll("members");
// 执行：SELECT MAX(`age`) AS `member_age`
// FROM `members`

selectMin()

该方法用于编写查询语句中的 SELECT MIN(field) 部分，和 selectMax() 方法一样， 你可以使用第二个参数（可选）重命名结果字段。

List list = DbHelper.create()
        .selectMin("age")
        .findAll("members");
// 执行：SELECT MIN(`age`) AS `age`
// FROM `members`

selectAvg()

该方法用于编写查询语句中的 SELECT AVG(field) 部分，和 selectMax() 方法一样， 你可以使用第二个参数（可选）重命名结果字段。

List list = DbHelper.create()
        .selectAvg("age")
        .findAll("members");
// 执行：SELECT MIN(`age`) AS `age`
// FROM `members`

selectSum()

该方法用于编写查询语句中的 SELECT SUM(field) 部分，和 selectMax() 方法一样， 你可以使用第二个参数（可选）重命名结果字段。

List list = DbHelper.create()
        .selectSum("age")
        .findAll("members");
// 执行：SELECT SUM(`age`) AS `age`
// FROM `members`

from()

该方法用于编写查询语句中的 FROM 子句：

List list = DbHelper.create()
        .select("title, content, date")
        .from("mytable")
        .findAll();
// 执行：SELECT `title`, `content`, `date`
// FROM `mytable`

注意：查询中的 FROM 部分可以在方法 findAll() 中指定，所以，你可以 选择任意一种你喜欢的方式。

join()

该方法用于编写查询语句中的 JOIN 子句：

List list = DbHelper.create()
        .select("*")
        .from("blogs")
        .join("comments", "comments.id=blogs.id")
        .findAll();
// 执行：SELECT *
// FROM blogs
// JOIN comments ON comments.id=blogs.id

如果你的查询中有多个连接，你可以多次调用这个方法。

你可以传入第三个参数指定连接的类型，有这样几种选择：left，right，outer，inner，left outer 和 right outer 。

List list = DbHelper.create()
        .select("*")
        .from("blogs")
        .join("comments", "comments.id=blogs.id", "left")
        .findAll();
// 执行：SELECT *
// FROM `blogs`
// LEFT JOIN `comments` ON `comments`.`id`=`blogs`.`id`

搜索^[2]

where()

该方法提供了4中方式让你编写查询语句中的 WHERE 子句：

注意：所有的数据将会自动转义，生成安全的查询语句。

1. 简单的 key/value 方式：

List list = DbHelper.create()
       .where("name", "温建宝")
       .findAll("mytable");
// 执行：SELECT *
// FROM `mytable`
// WHERE `name` = '温建宝'

注意自动为你加上了等号。

如果你多次调用该方法，那么多个 WHERE 条件将会使用 AND 连接起来：

List list = DbHelper.create()
        .where("name", "温建宝")
        .where("title", "Java入门教程")
        .where("status", 1)
        .findAll("mytable");
// 执行：SELECT *
// FROM `mytable`
// WHERE `name` = '温建宝'
// AND `title` = 'Java入门教程'
// AND `status` = 1

2. 自定义 key/value 方式：

为了控制比较，你可以在第一个参数中包含一个比较运算符：

List list = DbHelper.create()
        .where("name !=", "温建宝")
        .where("id <", 18)
        .findAll("mytable");
// 执行：SELECT *
// FROM `mytable`
// WHERE `name` != '温建宝'
// AND `id` < 18

3. 关联Map方式：

Map where = new LinkedHashMap<>();
where.put("name", "温建宝");
where.put("id", 18);
where.put("status", 2);

List list = DbHelper.create()
        .where(where)
        .findAll("mytable");
// 执行：SELECT *
// FROM `mytable`
// WHERE `name` = '温建宝'
// AND `id` = 18
// AND `status` = 2

你也可以在这个方法里包含你自己的比较运算符：

Map where = new LinkedHashMap<>();
where.put("name !=", "温建宝");
where.put("id <", 18);
where.put("date >", "2019-03-09 12:45:03");

List list = DbHelper.create()
        .where(where)
        .findAll("mytable");
// 执行：SELECT *
// FROM `mytable`
// WHERE `name` != '温建宝'
// AND `id` < 18
// AND `date` > '2019-03-09 12:45:03'

4. 自定义字符串：

你可以完全手工编写 WHERE 子句：

String where = "name='温建宝' AND status=2 OR status=3";
List list = DbHelper.create()
        .where(where)
        .findAll("mytable");
// 执行：
// SELECT *
// FROM `mytable`
// WHERE `name` = '温建宝' AND `status` = 2 OR `status` = 3

注意：where() 方法有一个可选的第三个参数，如果设置为 false，sqlHelper 将不保护你的表名和字段名。

List list = DbHelper.create()
        .where("mytable.name", "温建宝", false)
        .findAll("mytable");
// 执行：SELECT *
// FROM `mytable`
// WHERE mytable.name = 温建宝

orWhere()

这个方法和上面的方法一样，只是多个 WHERE 条件之间使用 OR 进行连接：

List list = DbHelper.create()
        .where("name !=", "温建宝")
        .orWhere("id >", 18)
        .findAll("mytable");
// 执行：SELECT *
// FROM `mytable`
// WHERE `name` != '温建宝'
// OR `id` > 18

whereIn()

该方法用于生成 WHERE IN 子句，多个子句之间使用 AND 连接

List