com.actionsoft.bpms.commons.query

接口 Query<Q extends Query<?,?>,M>

类型参数:

Q - 具体的查询实现类

M - 结果集属性对象(Model)

所有已知子接口:

BOQueryAPI, HistoryTaskQueryAPI, ProcessQueryAPI, TaskQueryAPI

public interface Query<Q extends Query<?,?>,M>

基本查询接口

方法概要

限定符和类型	方法和说明
Q	addQuery(java.lang.String fieldName, java.lang.Object value) 增加查询参数 注意，fieldName后面使用空格隔开运算符，如'ID ='、'TITLE like'。
Q	addQuerySqlWhere(java.lang.String sqlWhere, java.util.Map<java.lang.String,java.lang.Object> params) 主要解决 多个or条件，值又不能拼sql的情况
Q	asc() 在调用orderBy(xxx)之后调用，该方法根据已指定的orderBy字段追加一个完整的order by XXX ASC sql子句
Q	connection(java.sql.Connection connection) 为Query提供一种事务的机制，在事务中如果用到查询，则需要进行设置Connection，否则不需要
long	count() 执行查询，返回结果集总数
Q	countSql(java.lang.String countSelectClause) 执行一个自定义的count sql，注意该sql返回记录必须能够正确识别成该Query的Model对象
Q	desc() 在调用orderBy(xxx)之后调用，该方法根据已指定的orderBy字段追加一个完整的order by XXX DESC sql子句
M	detail() 返回一个对象。
java.sql.Connection	getConnection() 获得当前数据库连接对象
java.util.List<M>	list() 执行查询，返回结果集
java.util.List<M>	listPage(int firstRow, int rowCount) 执行查询，返回指定分页的结果集
Q	orderBy(java.lang.String fieldName) 排序
Q	sql(java.lang.String selectClause) 执行一个自定义的sql，注意该sql返回记录必须能够正确识别成该Query的Model对象

方法详细资料

connection

Q connection(java.sql.Connection connection)

为Query提供一种事务的机制，在事务中如果用到查询，则需要进行设置Connection，否则不需要

参数:

connection - 数据库连接

getConnection

java.sql.Connection getConnection()

获得当前数据库连接对象

sql

Q sql(java.lang.String selectClause)

执行一个自定义的sql，注意该sql返回记录必须能够正确识别成该Query的Model对象

参数:

selectClause - sql语句

countSql

Q countSql(java.lang.String countSelectClause)

执行一个自定义的count sql，注意该sql返回记录必须能够正确识别成该Query的Model对象

参数:

selectClause - sql语句

addQuery

Q addQuery(java.lang.String fieldName,
           java.lang.Object value)

增加查询参数

注意，fieldName后面使用空格隔开运算符，如'ID ='、'TITLE like'。如果匹配is not null这类非值比较，fieldName使用'字段名 IS NOT NULL'，value设置为null

参数:

fieldName - 字段名

value - 值

返回:

Query对象

addQuerySqlWhere

Q addQuerySqlWhere(java.lang.String sqlWhere,
                   java.util.Map<java.lang.String,java.lang.Object> params)

主要解决 多个or条件，值又不能拼sql的情况

参数:

sqlWhere - 条件片段 A=:A OR B=:B

params - params.put("A",new Date()) params.put("B",1)

返回:

orderBy

Q orderBy(java.lang.String fieldName)

排序

参数:

fieldName - 字段名

asc

Q asc()

在调用orderBy(xxx)之后调用，该方法根据已指定的orderBy字段追加一个完整的order by XXX ASC sql子句

desc

Q desc()

在调用orderBy(xxx)之后调用，该方法根据已指定的orderBy字段追加一个完整的order by XXX DESC sql子句

count

long count()

执行查询，返回结果集总数

list

java.util.List<M> list()

执行查询，返回结果集

detail

M detail()

返回一个对象。如果记录是多条返回第1条记录对象，如果没有记录返回null

listPage

java.util.List<M> listPage(int firstRow,
                           int rowCount)

执行查询，返回指定分页的结果集

参数:

firstRow - 首记录（>=0）

rowCount - 取记录集条数