Package org.hibernate.query.hql

Package defining support for HQL, including JPQL as a subset of HQL.

Concerns handled by subpackages include:

• query language transformation via ANTLR, and
• query execution via an instance of Query.

Translation of HQL to SQL involves the following steps:

• First, the ANTLR-generated tokenizer and parser work in series to parse the text of the query and produce an AST.
• Next, SemanticQueryBuilder translates the AST into an instance of the SQM (Semantic Query Model) defined in org.hibernate.query.sqm.
• Next, StandardSqmTranslator transforms the SQM tree and produces a SQL AST, an instance of the syntax tree defined by org.hibernate.sql.ast.tree.
• Finally, a SQL dialect-specific implementation of SqlAstTranslator produces an executable SQL statement.

See Also:

HqlTranslator, SqmQueryImplementor, NamedSqmQueryMemento

Interface Summary

Interface	Description
HqlLogging
HqlTranslator	Main entry point into building semantic queries.
LiteralConsumer	Pluggable contract for consuming literals encountered in an HQL query.

Exception Summary

Exception	Description
HqlInterpretationException	Base of exception hierarchy for exceptions stemming from producing SQM AST trees