[hibernate-commits] Hibernate SVN: r15750 - core/branches/SQL_GEN_REDESIGN/src/main/antlr/hql.

[hibernate-commits at lists.jboss.org]

Author: steve.ebersole at jboss.com
Date: 2009-01-06 16:55:41 -0500 (Tue, 06 Jan 2009)
New Revision: 15750

Modified:
   core/branches/SQL_GEN_REDESIGN/src/main/antlr/hql/normalize.g
Log:
HHH-2407 : HQL translation rework ->
HHH-3687 : parse (phase1)
HHH-3688 : normalize (phase2)

Modified: core/branches/SQL_GEN_REDESIGN/src/main/antlr/hql/normalize.g
===================================================================
--- core/branches/SQL_GEN_REDESIGN/src/main/antlr/hql/normalize.g	2009-01-06 20:49:20 UTC (rev 15749)
+++ core/branches/SQL_GEN_REDESIGN/src/main/antlr/hql/normalize.g	2009-01-06 21:55:41 UTC (rev 15750)
@@ -39,25 +39,16 @@
 }
 
 /**
- * An Antlr tree parser for "resolving" or "normalizing" an HQL syntax AST.  This
- * parser provides the vast majority of the semantic analysis of the HQL AST.
+ * An Antlr tree parser for "normalizing" an HQL syntax AST.  This parser provides the vast majority of the semantic
+ * analysis of the HQL AST.
  * <p/>
- * Both "resolving" and "normalizing" here seek a single goal of building a
- * dis-ambiguated, generic query AST.
- * <p/>
- * The act of resolving is essentially the process of simplifying complex node
- * structures into atomic components based on contextual information (aka, the
- * current parser state).  The main thrust of this process is breaking down
- * dot-structures (a series of DOT INDET pairs) into <ul>
- * <li>a series of "implicit" join structures injected into the from clause tree</li>
- * <li>a simple structure representing the "meaning" of the "leaf" of said dot-structure</li>
+ * The notion of "normalizing" seeks to build an AST that is:<ul>
+ * <li>dis-ambiguated</li>
+ * <li>a unified representation for different ways to express the same "idea"</li>
  * </ul>
  * <p/>
- * The act of normalizing essentially refers to the process of dis-ambiguating
- * node structures based on their context and creating a unified AST
- * representation for different ways to express the same "idea".  An example of this
- * is normalizing implicit join dot-structures into a structure akin to its explicit
- * join corollary.
+ * The main thrust of this normalization is normalizing "property path structures" into joins and subqueries as
+ * needed for implicit joins and index operations.
  *
  * @author Joshua Davis
  * @author Steve Ebersole