Foxnic-SQL (3) —— 条件表达式(ConditionExpr)

条件表达式

条件表达式 ConditionExpr 的作用就是完成查询条件的拼装。ConditionExpr 支持自由拼装和指定字段的拼装。自由拼装类似 Expr 的使用方式，并不进行语义或语法的校验。指定字段的拼装，略微严格一点，它会进行简单的字段和值忽略的校验。

本文中的示例代码均可在 https://gitee.com/LeeFJ/foxnic-samples 项目中找到。

以下是示例代码：

/**
* 1、基础条件表达式
* */
public static void demo1(Integer valid, Integer age, Date createDate, String keyword) {

    // 1、自由条件表达式
    ConditionExpr conditionExpr1 = new ConditionExpr("valid=?", valid);
    // 加入条件，并用 and 连接
    conditionExpr1.and("age>?", age);
    // 加入条件，并用 or 连接，当参数都为 null 时，语句不接入
    conditionExpr1.orIf("(create_date>? and name=?)", createDate,keyword);
    // 指定语句开通的关键字
    conditionExpr1.startWithWhere();
    System.out.println("conditionExpr1 = "+conditionExpr1.getSQL());

    // 2、指定操作符的条件表达式
    ConditionExpr conditionExpr2 = new ConditionExpr();
    // 指定字段与条件操作符并字段判断是否忽略改条件
    conditionExpr2.andLike("name", keyword);
    // 指定字段与条件操作符，
    conditionExpr2.andGreaterThan("age", age);
    // 指定语句开通的关键字
    conditionExpr2.startWithSpace();
    System.out.println("conditionExpr2 = "+conditionExpr2.getSQL());

}

由于 ConditionExpr 通常是作为 SQL 语句中的一部分，有时需要 AND 开头，有时又需要用 WHERE 开头，所以需要用 startWithXXX 方法指定其语句的开头关键字。

值忽略

值忽略是指开发人员在拼接语句时会使用的条件判断。大多数情况下是，当接口没有传入值时，条件不加到SQL语句中。但有时候也需要忽略非 null 的值。例如前端传入固定值 all 表示全部选项，此时需要判断值是all时，条件不被连入SQL语句。
以下是示例代码：

/**
* 2、值忽略
* */
public static void demo2(Integer valid, Integer age, Date createDate, String keyword) {

    // 默认忽略 null
    ConditionExpr conditionExpr1 = new ConditionExpr("valid=?", valid);
    conditionExpr1.andIf("age>?",age);
    conditionExpr1.andIf("name like ?","%"+keyword+"%");
    conditionExpr1.andLike("name",keyword);
    System.out.println("conditionExpr1 = "+conditionExpr1.getSQL());

    // 指定忽略的值
    ConditionExpr conditionExpr2 = new ConditionExpr();
    conditionExpr2.ignore(null,"null","any","all").andEquals("name",keyword);
    System.out.println("conditionExpr2 = "+conditionExpr2.getSQL());

}

子类与变体

ConditionExpr 继承自 ConditionExpression ，同样继承 ConditionExpression 类的还包括：SelectWhere、DeleteWhere、UpdateWhere、Having等，这些对象作为其它高级语句的自语句存在，在之后的 Select 语句、Update语句、Delete语句中将会使用到。

In语句

In语句是where条件中一个非常重要的子句，但是直接使用String构建又比较繁琐，Foxnic-SQL中使用 In 这个表达式构建 in 语句。示例如下：

 /**
 * In 语句
 * */
public static void demoIn1(Integer valid) {

    // 1、快速指定值
    ConditionExpr conditionExpr1 = new ConditionExpr("valid=?", valid);
    // 快速构建 in 语句
    In in1=new In("id",1,2,4);
    conditionExpr1.and(in1);
    System.out.println("conditionExpr1 = "+conditionExpr1.getSQL());
    // 输出：conditionExpr1 = AND valid= 1 AND id IN ( 1 , 2 , 4 )

    // 2、传入 List
    List els= Arrays.asList("apple","duck","cat");
    In in2=new In("id",els);
    // 把 in 转换成条件表达式
    ConditionExpr conditionExpr2=in2.toConditionExpr();
    conditionExpr2.and("valid=?",valid);
    System.out.println("conditionExpr2 = "+conditionExpr2.getSQL());
    // 输出：conditionExpr2 = AND id IN ( 'apple' , 'duck' , 'cat' ) AND valid= 1

    // 3、多字段的 In 语句构建
    List els1= new ArrayList<>();
    for (int i = 0; i < 4 ; i++) {
        els1.add(new Object[]{i, IDGenerator.getRandomString(6)});
    }
    In in3=new In(new String[]{"id","code"},els1);
    // 把 in 转换成条件表达式
    ConditionExpr conditionExpr3=in3.toConditionExpr();
    System.out.println("conditionExpr3 = "+conditionExpr3.getSQL());
    // 输出：conditionExpr3 = AND ( id , code ) IN ( ( 0 , '5oJ8Vu' ) , ( 1 , 'xx00J*' ) , ( 2 , 'Bhc7@W' ) , ( 3 , '=Wdx&9' ) )
}

小结：

本节主要讲解了条件表达式 ConditionExpr 的概念和它的基本用法。另外 In 语句是我们在拼接 Where 条件时经常会用到的一个语句，Foxnic-SQL 也提供了快速构建的方法。

Foxnic-SQL (3) —— 条件表达式(ConditionExpr)