Package com.pugwoo.dbhelper.sql

Class WhereSQLForNamedParam

java.lang.Object

com.pugwoo.dbhelper.sql.WhereSQLForNamedParam

public class WhereSQLForNamedParam
extends Object

辅助构造where子句及后续子句的工具，用于命名参数

Constructor Summary

Constructors

Constructor	Description
WhereSQLForNamedParam()	空的WhereSQL
WhereSQLForNamedParam(String condition)	使用条件进行初始化，条件即例如 a=:param 这样的表达式，也可以是 a=:param1 or b=:param2 这样的表达式。 当表达式是or表达式时，工具会自动加上括号。
WhereSQLForNamedParam(String condition, Map<String,?> paramMap)	使用条件进行初始化，条件即例如 a=:param 这样的表达式，也可以是 a=:param1 or b=:param2 这样的表达式。 当表达式是or表达式时，工具会自动加上括号。

Method Summary

Modifier and Type	Method	Description
WhereSQLForNamedParam	addGroupBy(String... groupByColumn)
WhereSQLForNamedParam	addGroupByWithParam(String groupColumn, Map<String,?> paramMap)
WhereSQLForNamedParam	addOrderBy(String... orderByColumn)
WhereSQLForNamedParam	addOrderByWithParam(String orderColumn, Map<String,?> paramMap)
WhereSQLForNamedParam	and(WhereSQLForNamedParam whereSQL)	功能同addAnd，注意：只会读取参数whereSQL的条件和参数，因此需要注意whereSQL里【不能】存在order/group by/limit等子句
WhereSQLForNamedParam	and(String condition)
WhereSQLForNamedParam	and(String condition, Map<String,?> param)
WhereSQLForNamedParam	andIf(boolean ifTrue, WhereSQLForNamedParam whereSQL)
WhereSQLForNamedParam	andIf(boolean ifTrue, String condition)
WhereSQLForNamedParam	andIf(boolean ifTrue, String condition, Map<String,?> param)
WhereSQLForNamedParam	copy()	复制出一个新的WhereSQL对象，两个对象独立
Map<String,Object>	getParams()	获得参数列表
String	getSQL()	获得从where开始的SQL子句
String	getSQLForWhereAppend()	获得用于where开始的SQL子句，用于追加到一个已有的where sql中，所以如果有where时，会以and开头，并且where条件会自动加上括号
WhereSQLForNamedParam	having(String having)
WhereSQLForNamedParam	having(String having, Map<String,?> paramMap)	多次调用时，会覆盖前一次调用设置的值。不需要加HAVING关键字。
WhereSQLForNamedParam	limit(Integer limit)
WhereSQLForNamedParam	limit(Integer offset, Integer limit)
WhereSQLForNamedParam	limit(Long limit)
WhereSQLForNamedParam	limit(Long offset, Long limit)
WhereSQLForNamedParam	not()
WhereSQLForNamedParam	notIf(boolean ifTrue)
WhereSQLForNamedParam	or(WhereSQLForNamedParam whereSQL)	功能同addOr，注意：只会读取参数whereSQL的条件和参数，因此需要注意whereSQL里【不能】存在order/group by/limit等子句
WhereSQLForNamedParam	or(String condition, Map<String,?> param)
WhereSQLForNamedParam	orIf(boolean ifTrue, WhereSQLForNamedParam whereSQL)
WhereSQLForNamedParam	orIf(boolean ifTrue, String condition, Map<String,?> param)
WhereSQLForNamedParam	resetGroupBy()
WhereSQLForNamedParam	resetOrderBy()
String	toString()	等价于getSQL()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

WhereSQLForNamedParam

public WhereSQLForNamedParam()

空的WhereSQL

WhereSQLForNamedParam

public WhereSQLForNamedParam(String condition)

使用条件进行初始化，条件即例如 a=:param 这样的表达式，也可以是 a=:param1 or b=:param2 这样的表达式。
当表达式是or表达式时，工具会自动加上括号。

Parameters:

condition - 例如 a=:param 或 a=:param1 or b=:param2，不用加上括号，工具会自动处理

WhereSQLForNamedParam

public WhereSQLForNamedParam(String condition,
 Map<String,?> paramMap)

使用条件进行初始化，条件即例如 a=:param 这样的表达式，也可以是 a=:param1 or b=:param2 这样的表达式。
当表达式是or表达式时，工具会自动加上括号。

Parameters:

condition - 例如 a=:param 或 a=:param1 or b=:param2，不用加上括号，工具会自动处理

paramMap - 参数

Method Details

copy

public WhereSQLForNamedParam copy()

复制出一个新的WhereSQL对象，两个对象独立

getSQL

public String getSQL()

获得从where开始的SQL子句

toString

public String toString()

等价于getSQL()

Overrides:

toString in class Object

getSQLForWhereAppend

public String getSQLForWhereAppend()

获得用于where开始的SQL子句，用于追加到一个已有的where sql中，所以如果有where时，会以and开头，并且where条件会自动加上括号

getParams

public Map<String,Object> getParams()

获得参数列表

not

public WhereSQLForNamedParam not()

notIf

public WhereSQLForNamedParam notIf(boolean ifTrue)

and

public WhereSQLForNamedParam and(String condition)

andIf

public WhereSQLForNamedParam andIf(boolean ifTrue,
 String condition)

and

public WhereSQLForNamedParam and(String condition,
 Map<String,?> param)

andIf

public WhereSQLForNamedParam andIf(boolean ifTrue,
 String condition,
 Map<String,?> param)

and

public WhereSQLForNamedParam and(WhereSQLForNamedParam whereSQL)

功能同addAnd，注意：只会读取参数whereSQL的条件和参数，因此需要注意whereSQL里【不能】存在order/group by/limit等子句

andIf

public WhereSQLForNamedParam andIf(boolean ifTrue,
 WhereSQLForNamedParam whereSQL)

or

public WhereSQLForNamedParam or(String condition,
 Map<String,?> param)

orIf

public WhereSQLForNamedParam orIf(boolean ifTrue,
 String condition,
 Map<String,?> param)

or

public WhereSQLForNamedParam or(WhereSQLForNamedParam whereSQL)

功能同addOr，注意：只会读取参数whereSQL的条件和参数，因此需要注意whereSQL里【不能】存在order/group by/limit等子句

orIf

public WhereSQLForNamedParam orIf(boolean ifTrue,
 WhereSQLForNamedParam whereSQL)

addGroupByWithParam

public WhereSQLForNamedParam addGroupByWithParam(String groupColumn,
 Map<String,?> paramMap)

addGroupBy

public WhereSQLForNamedParam addGroupBy(String... groupByColumn)

resetGroupBy

public WhereSQLForNamedParam resetGroupBy()

having

public WhereSQLForNamedParam having(String having)

having

public WhereSQLForNamedParam having(String having,
 Map<String,?> paramMap)

多次调用时，会覆盖前一次调用设置的值。不需要加HAVING关键字。

addOrderByWithParam

public WhereSQLForNamedParam addOrderByWithParam(String orderColumn,
 Map<String,?> paramMap)

addOrderBy

public WhereSQLForNamedParam addOrderBy(String... orderByColumn)

resetOrderBy

public WhereSQLForNamedParam resetOrderBy()

limit

public WhereSQLForNamedParam limit(Integer limit)

limit

public WhereSQLForNamedParam limit(Integer offset,
 Integer limit)

limit

public WhereSQLForNamedParam limit(Long limit)

limit

public WhereSQLForNamedParam limit(Long offset,
 Long limit)