public interface

CustomQuery

org.hibernate.loader.custom.CustomQuery
Known Indirect Subclasses

Class Overview

Extension point allowing any SQL query with named and positional parameters to be executed by Hibernate, returning managed entities, collections and simple scalar values.

Summary

Public Methods
abstract List getCustomQueryReturns()
A collection of descriptors describing the JDBC result set to be expected and how to map this result set.
abstract Map getNamedParameterBindPoints()
A map representing positions within the supplied query to which we need to bind named parameters.
abstract Set getQuerySpaces()
Any query spaces to apply to the query execution.
abstract String getSQL()
The SQL query string to be performed.

Public Methods

public abstract List getCustomQueryReturns ()

A collection of descriptors describing the JDBC result set to be expected and how to map this result set.

Returns
  • List of return descriptors.

public abstract Map getNamedParameterBindPoints ()

A map representing positions within the supplied query to which we need to bind named parameters.

Optional, may return null if no named parameters.

The structure of the returned map (if one) as follows:

  1. The keys into the map are the named parameter names
  2. The corresponding value is either an Integer if the parameter occurs only once in the query; or a List of Integers if the parameter occurs more than once

public abstract Set getQuerySpaces ()

Any query spaces to apply to the query execution. Query spaces are used in Hibernate's auto-flushing mechanism to determine which entities need to be checked for pending changes.

Returns
  • The query spaces

public abstract String getSQL ()

The SQL query string to be performed.

Returns
  • The SQL statement string.