QueryTranslator (Hibernate JavaDocs)

All Known Subinterfaces:

FilterTranslator

All Known Implementing Classes:

QueryTranslatorImpl, QueryTranslatorImpl
```
public interface QueryTranslator
```
Defines the contract of an HQL->SQL translator.

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`ERROR_CANNOT_DETERMINE_TYPE`
`static String`	`ERROR_CANNOT_FETCH_WITH_ITERATE`
`static String`	`ERROR_CANNOT_FORMAT_LITERAL`
`static String`	`ERROR_NAMED_PARAMETER_DOES_NOT_APPEAR`

Method Summary

Methods
Modifier and Type	Method and Description
`List<String>`	`collectSqlStrings()`
`void`	`compile(Map replacements, boolean shallow)` Compile a "normal" query.
`boolean`	`containsCollectionFetches()` Does the translated query contain collection fetches?
`int`	`executeUpdate(QueryParameters queryParameters, SessionImplementor session)` Perform a bulk update/delete operation given the underlying query definition.
`String[][]`	`getColumnNames()` Returns the column names in the generated SQL.
`Class`	`getDynamicInstantiationResultType()`
`Map`	`getEnabledFilters()` Returns the filters enabled for this query translator.
`ParameterTranslations`	`getParameterTranslations()` Return information about any parameters encountered during translation.
`String`	`getQueryIdentifier()` Retrieve the query identifier for this translator.
`Set<Serializable>`	`getQuerySpaces()` Returns the set of query spaces (table names) that the query refers to.
`String`	`getQueryString()` Returns the HQL string processed by the translator.
`String[]`	`getReturnAliases()` Returns an array of HQL aliases
`Type[]`	`getReturnTypes()` Returns an array of Types represented in the query result.
`String`	`getSQLString()` Returns the SQL string generated by the translator.
`boolean`	`isManipulationStatement()`
`Iterator`	`iterate(QueryParameters queryParameters, EventSource session)` Perform an iterate operation given the underlying query definition.
`List`	`list(SessionImplementor session, QueryParameters queryParameters)` Perform a list operation given the underlying query definition.
`ScrollableResults`	`scroll(QueryParameters queryParameters, SessionImplementor session)` Perform a scroll operation given the underlying query definition.
`void`	`validateScrollability()` Validate the scrollability of the translated query.

- Field Detail
  - ERROR_CANNOT_FETCH_WITH_ITERATE
```
static final String ERROR_CANNOT_FETCH_WITH_ITERATE
```
    See Also:
    Constant Field Values
  - ERROR_NAMED_PARAMETER_DOES_NOT_APPEAR
```
static final String ERROR_NAMED_PARAMETER_DOES_NOT_APPEAR
```
    See Also:
    Constant Field Values
  - ERROR_CANNOT_DETERMINE_TYPE
```
static final String ERROR_CANNOT_DETERMINE_TYPE
```
    See Also:
    Constant Field Values
  - ERROR_CANNOT_FORMAT_LITERAL
```
static final String ERROR_CANNOT_FORMAT_LITERAL
```
    See Also:
    Constant Field Values
- Method Detail
  - compile
```
void compile(Map replacements,
           boolean shallow)
             throws QueryException,
                    MappingException
```
    Compile a "normal" query. This method may be called multiple times. Subsequent invocations are no-ops.
    
    Parameters:
    replacements - Defined query substitutions.
    shallow - Does this represent a shallow (scalar or entity-id) select?
    
    Throws:
    
    QueryException - There was a problem parsing the query string.
    
    MappingException - There was a problem querying defined mappings.
  - list
```
List list(SessionImplementor session,
        QueryParameters queryParameters)
          throws HibernateException
```
    Perform a list operation given the underlying query definition.
    
    Parameters:
    session - The session owning this query.
    queryParameters - The query bind parameters.
    
    Returns:
    The query list results.
    
    Throws:
    
    HibernateException
  - iterate
```
Iterator iterate(QueryParameters queryParameters,
               EventSource session)
                 throws HibernateException
```
    Perform an iterate operation given the underlying query definition.
    
    Parameters:
    queryParameters - The query bind parameters.
    session - The session owning this query.
    
    Returns:
    An iterator over the query results.
    
    Throws:
    
    HibernateException
  - scroll
```
ScrollableResults scroll(QueryParameters queryParameters,
                       SessionImplementor session)
                         throws HibernateException
```
    Perform a scroll operation given the underlying query definition.
    
    Parameters:
    queryParameters - The query bind parameters.
    session - The session owning this query.
    
    Returns:
    The ScrollableResults wrapper around the query results.
    
    Throws:
    
    HibernateException
  - executeUpdate
```
int executeUpdate(QueryParameters queryParameters,
                SessionImplementor session)
                  throws HibernateException
```
    Perform a bulk update/delete operation given the underlying query definition.
    
    Parameters:
    queryParameters - The query bind parameters.
    session - The session owning this query.
    
    Returns:
    The number of entities updated or deleted.
    
    Throws:
    
    HibernateException
  - getQuerySpaces
```
Set<Serializable> getQuerySpaces()
```
    Returns the set of query spaces (table names) that the query refers to.
    
    Returns:
    A set of query spaces (table names).
  - getQueryIdentifier
```
String getQueryIdentifier()
```
    Retrieve the query identifier for this translator. The query identifier is used in states collection.
    
    Returns:
    the identifier
  - getSQLString
```
String getSQLString()
```
    Returns the SQL string generated by the translator.
    
    Returns:
    the SQL string generated by the translator.
  - collectSqlStrings
```
List<String> collectSqlStrings()
```
  - getQueryString
```
String getQueryString()
```
    Returns the HQL string processed by the translator.
    
    Returns:
    the HQL string processed by the translator.
  - getEnabledFilters
```
Map getEnabledFilters()
```
    Returns the filters enabled for this query translator.
    
    Returns:
    Filters enabled for this query execution.
  - getReturnTypes
```
Type[] getReturnTypes()
```
    Returns an array of Types represented in the query result.
    
    Returns:
    Query return types.
  - getReturnAliases
```
String[] getReturnAliases()
```
    Returns an array of HQL aliases
  - getColumnNames
```
String[][] getColumnNames()
```
    Returns the column names in the generated SQL.
    
    Returns:
    the column names in the generated SQL.
  - getParameterTranslations
```
ParameterTranslations getParameterTranslations()
```
    Return information about any parameters encountered during translation.
    
    Returns:
    The parameter information.
  - validateScrollability
```
void validateScrollability()
                           throws HibernateException
```
    Validate the scrollability of the translated query.
    
    Throws:
    
    HibernateException
  - containsCollectionFetches
```
boolean containsCollectionFetches()
```
    Does the translated query contain collection fetches?
    
    Returns:
    true if the query does contain collection fetched; false otherwise.
  - isManipulationStatement
```
boolean isManipulationStatement()
```
  - getDynamicInstantiationResultType
```
Class getDynamicInstantiationResultType()
```

Interface QueryTranslator

Field Summary

Method Summary

Field Detail

ERROR_CANNOT_FETCH_WITH_ITERATE

ERROR_NAMED_PARAMETER_DOES_NOT_APPEAR

ERROR_CANNOT_DETERMINE_TYPE

ERROR_CANNOT_FORMAT_LITERAL

Method Detail

compile

list

iterate

scroll

executeUpdate

getQuerySpaces

getQueryIdentifier

getSQLString

collectSqlStrings

getQueryString

getEnabledFilters

getReturnTypes

getReturnAliases

getColumnNames

getParameterTranslations

validateScrollability

containsCollectionFetches

isManipulationStatement

getDynamicInstantiationResultType