Author: steve.ebersole(a)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