Query (Java SDK API Reference for AWS PaaS)

类型参数:

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`	`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对象
  - 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 - 取记录集条数

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

方法概要

方法详细资料

connection

getConnection

sql

countSql

addQuery

orderBy

asc

desc

count

list

detail

listPage