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<String> 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<Object[]> 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 也提供了快速构建的方法。
相关项目
https://gitee.com/LeeFJ/foxnic
