NativeQuery (Camunda Platform Javadocs 7.16.18-ee)

All Known Subinterfaces:

NativeExecutionQuery, NativeHistoricActivityInstanceQuery, NativeHistoricCaseActivityInstanceQuery, NativeHistoricCaseInstanceQuery, NativeHistoricDecisionInstanceQuery, NativeHistoricProcessInstanceQuery, NativeHistoricTaskInstanceQuery, NativeHistoricVariableInstanceQuery, NativeProcessInstanceQuery, NativeTaskQuery, NativeUserQuery

All Known Implementing Classes:

AbstractNativeQuery, NativeExecutionQueryImpl, NativeHistoricActivityInstanceQueryImpl, NativeHistoricCaseActivityInstanceQueryImpl, NativeHistoricCaseInstanceQueryImpl, NativeHistoricProcessInstanceQueryImpl, NativeHistoricTaskInstanceQueryImpl, NativeHistoricVariableInstanceQueryImpl, NativeHistoryDecisionInstanceQueryImpl, NativeProcessInstanceQueryImpl, NativeTaskQueryImpl, NativeUserQueryImpl
```
public interface NativeQuery<T extends NativeQuery<?,?>,U>
```
Describes basic methods for doing native queries

Author:

Bernd Ruecker (camunda)

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`long`	`count()`	Executes the query and returns the number of results
`java.util.List<U>`	`list()`	Executes the query and get a list of entities as the result.
`java.util.List<U>`	`listPage(int firstResult, int maxResults)`	Executes the query and get a list of entities as the result.
`T`	`parameter(java.lang.String name, java.lang.Object value)`	Add parameter to be replaced in query for index, e.g.
`U`	`singleResult()`	Executes the query and returns the resulting entity or null if no entity matches the query criteria.
`T`	`sql(java.lang.String selectClause)`	Hand in the SQL statement you want to execute.

- Method Detail
  - sql
```
T sql(java.lang.String selectClause)
```
    Hand in the SQL statement you want to execute. BEWARE: if you need a count you have to hand in a count() statement yourself, otherwise the result will be treated as lost of Activiti entities. If you need paging you have to insert the pagination code yourself. We skipped doing this for you as this is done really different on some databases (especially MS-SQL / DB2)
  - parameter
```
T parameter(java.lang.String name,
            java.lang.Object value)
```
    Add parameter to be replaced in query for index, e.g. :param1, :myParam, ...
  - count
```
long count()
```
    Executes the query and returns the number of results
  - singleResult
```
U singleResult()
```
    Executes the query and returns the resulting entity or null if no entity matches the query criteria.
    
    Throws:
    
    ProcessEngineException - when the query results in more than one entities.
  - list
```
java.util.List<U> list()
```
    Executes the query and get a list of entities as the result.
  - listPage
```
java.util.List<U> listPage(int firstResult,
                           int maxResults)
```
    Executes the query and get a list of entities as the result.