Package org.hibernate.hql.spi
Interface QueryTranslator
-
- All Known Subinterfaces:
FilterTranslator
public interface QueryTranslatorDefines the contract of an HQL->SQL translator.
-
-
Field Summary
Fields Modifier and Type Field Description static StringERROR_CANNOT_DETERMINE_TYPEstatic StringERROR_CANNOT_FETCH_WITH_ITERATEstatic StringERROR_CANNOT_FORMAT_LITERALstatic StringERROR_LEGACY_ORDINAL_PARAMS_NO_LONGER_SUPPORTEDstatic StringERROR_NAMED_PARAMETER_DOES_NOT_APPEARstatic StringERROR_ORDINAL_PARAMETER_DOES_NOT_APPEAR
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description List<String>collectSqlStrings()voidcompile(Map replacements, boolean shallow)Compile a "normal" query.booleancontainsCollectionFetches()Does the translated query contain collection fetches?intexecuteUpdate(QueryParameters queryParameters, SharedSessionContractImplementor session)Perform a bulk update/delete operation given the underlying query definition.String[][]getColumnNames()Returns the column names in the generated SQL.ClassgetDynamicInstantiationResultType()MapgetEnabledFilters()Returns the filters enabled for this query translator.ParameterTranslationsgetParameterTranslations()Return information about any parameters encountered during translation.default List<String>getPrimaryFromClauseTables()StringgetQueryIdentifier()Retrieve the query identifier for this translator.Set<Serializable>getQuerySpaces()Returns the set of query spaces (table names) that the query refers to.StringgetQueryString()Returns the HQL string processed by the translator.String[]getReturnAliases()Returns an array of HQL aliasesType[]getReturnTypes()Returns an array of Types represented in the query result.StringgetSQLString()Returns the SQL string generated by the translator.booleanisManipulationStatement()default booleanisUpdateStatement()Iteratoriterate(QueryParameters queryParameters, EventSource session)Perform an iterate operation given the underlying query definition.Listlist(SharedSessionContractImplementor session, QueryParameters queryParameters)Perform a list operation given the underlying query definition.ScrollableResultsImplementorscroll(QueryParameters queryParameters, SharedSessionContractImplementor session)Perform a scroll operation given the underlying query definition.voidvalidateScrollability()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_ORDINAL_PARAMETER_DOES_NOT_APPEAR
static final String ERROR_ORDINAL_PARAMETER_DOES_NOT_APPEAR
- See Also:
- Constant Field Values
-
ERROR_LEGACY_ORDINAL_PARAMS_NO_LONGER_SUPPORTED
static final String ERROR_LEGACY_ORDINAL_PARAMS_NO_LONGER_SUPPORTED
- 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(SharedSessionContractImplementor 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
ScrollableResultsImplementor scroll(QueryParameters queryParameters, SharedSessionContractImplementor 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, SharedSessionContractImplementor 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.
-
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 HibernateExceptionValidate 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()
-
isUpdateStatement
default boolean isUpdateStatement()
-
getDynamicInstantiationResultType
Class getDynamicInstantiationResultType()
-
-