Open Source Repository

Home /hibernate/hibernate-3.2.4.ga | Repository Home



org/hibernate/hql/ast/tree/SelectClause.java
// $Id: SelectClause.java 10528 2006-09-25 15:14:10Z epbernard $
package org.hibernate.hql.ast.tree;

import java.lang.reflect.Constructor;
import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;

import org.hibernate.hql.antlr.SqlTokenTypes;
import org.hibernate.hql.ast.util.ASTAppender;
import org.hibernate.hql.ast.util.ASTIterator;
import org.hibernate.hql.ast.util.ASTPrinter;
import org.hibernate.hql.ast.QuerySyntaxException;
import org.hibernate.type.Type;
import org.hibernate.QueryException;

import antlr.SemanticException;
import antlr.collections.AST;

/**
 * Represents the list of expressions in a SELECT clause.
 *
 @author josh Sep 21, 2004 7:53:55 AM
 */
public class SelectClause extends SelectExpressionList {

  private boolean prepared = false;
  private boolean scalarSelect;

  private List fromElementsForLoad = new ArrayList();
  //private Type[] sqlResultTypes;
  private Type[] queryReturnTypes;
  private String[][] columnNames;
  private ConstructorNode constructorNode;
  private List collectionFromElements;
  private String[] aliases;

  /**
   * Does this SelectClause represent a scalar query
   *
   @return True if this is a scalara select clause; false otherwise.
   */
  public boolean isScalarSelect() {
    return scalarSelect;
  }

  public boolean isDistinct() {
    return getFirstChild() != null && getFirstChild().getType() == SqlTokenTypes.DISTINCT;
  }

  /**
   * FromElements which need to be accounted for in the load phase (either for return or for fetch).
   *
   @return List of appropriate FromElements.
   */
  public List getFromElementsForLoad() {
    return fromElementsForLoad;
  }

  /*
   * The types represented in the SQL result set.
   *
   * @return The types represented in the SQL result set.
   */
  /*public Type[] getSqlResultTypes() {
    return sqlResultTypes;
  }*/

  /**
   * The types actually being returned from this query at the "object level".
   *
   @return The query return types.
   */
  public Type[] getQueryReturnTypes() {
    return queryReturnTypes;
  }
  
  /**
   * The HQL aliases, or generated aliases
   */
  public String[] getQueryReturnAliases() {
    return aliases;
  }

  /**
   * The column alias names being used in the generated SQL.
   *
   @return The SQL column aliases.
   */
  public String[][] getColumnNames() {
    return columnNames;
  }

  /**
   * The constructor to use for dynamic instantiation queries.
   *
   @return The appropriate Constructor reference, or null if not a
   *         dynamic instantiation query.
   */
  public Constructor getConstructor() {
    return constructorNode == null null : constructorNode.getConstructor();
  }
  
  public boolean isMap() {
    return constructorNode == null false : constructorNode.isMap();
  }
  
  public boolean isList() {
    return constructorNode == null false : constructorNode.isList();
  }
  
  /**
   * Prepares an explicitly defined select clause.
   *
   @param fromClause The from clause linked to this select clause.
   @throws SemanticException
   */
  public void initializeExplicitSelectClause(FromClause fromClausethrows SemanticException {
    if prepared ) {
      throw new IllegalStateException"SelectClause was already prepared!" );
    }

    //explicit = true;  // This is an explict Select.
    //ArrayList sqlResultTypeList = new ArrayList();
    ArrayList queryReturnTypeList = new ArrayList();

    // First, collect all of the select expressions.
    // NOTE: This must be done *before* invoking setScalarColumnText() because setScalarColumnText()
    // changes the AST!!!
    SelectExpression[] selectExpressions = collectSelectExpressions();
    
    for int i = 0; i < selectExpressions.length; i++ ) {
      SelectExpression expr = selectExpressions[i];

      if expr.isConstructor() ) {
        constructorNode = ConstructorNode expr;
        List constructorArgumentTypeList = constructorNode.getConstructorArgumentTypeList();
        //sqlResultTypeList.addAll( constructorArgumentTypeList );
        queryReturnTypeList.addAllconstructorArgumentTypeList );
        scalarSelect = true;
      }
      else {
        Type type = expr.getDataType();
        if type == null ) {
          throw new IllegalStateException"No data type for node: " + expr.getClass().getName() " "
              new ASTPrinterSqlTokenTypes.class ).showAsString( ( AST expr, "" ) );
        }
        //sqlResultTypeList.add( type );

        // If the data type is not an association type, it could not have been in the FROM clause.
        if expr.isScalar() ) {
          scalarSelect = true;
        }

        if isReturnableEntityexpr ) ) {
          fromElementsForLoad.addexpr.getFromElement() );
        }

        // Always add the type to the return type list.
        queryReturnTypeList.addtype );
      }
    }

    //init the aliases, after initing the constructornode
    initAliases(selectExpressions);

    if !getWalker().isShallowQuery() ) {
      // add the fetched entities
      List fromElements = fromClause.getProjectionList();
  
      ASTAppender appender = new ASTAppendergetASTFactory()this );  // Get ready to start adding nodes.
      int size = fromElements.size();
  
      Iterator iterator = fromElements.iterator();
      for int k = 0; iterator.hasNext(); k++ ) {
        FromElement fromElement = FromElement iterator.next();
  
        if fromElement.isFetch() ) {
          FromElement origin = null;
          if fromElement.getRealOrigin() == null ) {
            // work around that crazy issue where the tree contains
            // "empty" FromElements (no text); afaict, this is caused
            // by FromElementFactory.createCollectionJoin()
            if fromElement.getOrigin() == null ) {
              throw new QueryException"Unable to determine origin of join fetch [" + fromElement.getDisplayText() "]" );
            }
            else {
              origin = fromElement.getOrigin();
            }
          }
          else {
            origin = fromElement.getRealOrigin();
          }
          if !fromElementsForLoad.containsorigin ) ) {
            throw new QueryException(
                "query specified join fetching, but the owner " +
                "of the fetched association was not present in the select list " +
                "[" + fromElement.getDisplayText() "]"
            );
          }
          Type type = fromElement.getSelectType();
          addCollectionFromElementfromElement );
          if type != null ) {
            boolean collectionOfElements = fromElement.isCollectionOfValuesOrComponents();
            if !collectionOfElements ) {
              // Add the type to the list of returned sqlResultTypes.
              fromElement.setIncludeSubclassestrue );
              fromElementsForLoad.addfromElement );
              //sqlResultTypeList.add( type );
              // Generate the select expression.
              String text = fromElement.renderIdentifierSelectsize, k );
              SelectExpressionImpl generatedExpr = SelectExpressionImpl appender.appendSqlTokenTypes.SELECT_EXPR, text, false );
              if generatedExpr != null ) {
                generatedExpr.setFromElementfromElement );
              }
            }
          }
        }
      }
  
      // generate id select fragment and then property select fragment for
      // each expression, just like generateSelectFragments().
      renderNonScalarSelectscollectSelectExpressions(), fromClause );
    }

    if scalarSelect || getWalker().isShallowQuery() ) {
      // If there are any scalars (non-entities) selected, render the select column aliases.
      renderScalarSelectsselectExpressions, fromClause );
    }

    finishInitialization/*sqlResultTypeList,*/ queryReturnTypeList );
  }

  private void finishInitialization(/*ArrayList sqlResultTypeList,*/ ArrayList queryReturnTypeList) {
    //sqlResultTypes = ( Type[] ) sqlResultTypeList.toArray( new Type[sqlResultTypeList.size()] );
    queryReturnTypes = Type[] ) queryReturnTypeList.toArraynew Type[queryReturnTypeList.size()] );
    initializeColumnNames();
    prepared = true;
  }

  private void initializeColumnNames() {
    // Generate an 2d array of column names, the first dimension is parallel with the
    // return types array.  The second dimension is the list of column names for each
    // type.

    // todo: we should really just collect these from the various SelectExpressions, rather than regenerating here
    columnNames = getSessionFactoryHelper().generateColumnNamesqueryReturnTypes );
  }

  /**
   * Prepares a derived (i.e., not explicitly defined in the query) select clause.
   *
   @param fromClause The from clause to which this select clause is linked.
   */
  public void initializeDerivedSelectClause(FromClause fromClausethrows SemanticException {
    if prepared ) {
      throw new IllegalStateException"SelectClause was already prepared!" );
    }

    //Used to be tested by the TCK but the test is no longer here
//    if ( getSessionFactoryHelper().isStrictJPAQLComplianceEnabled()  && !getWalker().isSubQuery() ) {
//      // NOTE : the isSubQuery() bit is a temporary hack...
//      throw new QuerySyntaxException( "JPA-QL compliance requires select clause" );
//    }
    List fromElements = fromClause.getProjectionList();

    ASTAppender appender = new ASTAppendergetASTFactory()this );  // Get ready to start adding nodes.
    int size = fromElements.size();
    ArrayList sqlResultTypeList = new ArrayListsize );
    ArrayList queryReturnTypeList = new ArrayListsize );

    Iterator iterator = fromElements.iterator();
    for int k = 0; iterator.hasNext(); k++ ) {
      FromElement fromElement = FromElement iterator.next();
      Type type = fromElement.getSelectType();

      addCollectionFromElementfromElement );

      if type != null ) {
        boolean collectionOfElements = fromElement.isCollectionOfValuesOrComponents();
        if !collectionOfElements ) {
          if !fromElement.isFetch() ) {
            // Add the type to the list of returned sqlResultTypes.
            queryReturnTypeList.addtype );
          }
          fromElementsForLoad.addfromElement );
          sqlResultTypeList.addtype );
          // Generate the select expression.
          String text = fromElement.renderIdentifierSelectsize, k );
          SelectExpressionImpl generatedExpr = SelectExpressionImpl appender.appendSqlTokenTypes.SELECT_EXPR, text, false );
          if generatedExpr != null ) {
            generatedExpr.setFromElementfromElement );
          }
        }
      }
    }

    // Get all the select expressions (that we just generated) and render the select.
    SelectExpression[] selectExpressions = collectSelectExpressions();

    if getWalker().isShallowQuery() ) {
      renderScalarSelectsselectExpressions, fromClause );
    }
    else {
      renderNonScalarSelectsselectExpressions, fromClause );
    }
    finishInitialization/*sqlResultTypeList,*/ queryReturnTypeList );
  }
  
  public static boolean VERSION2_SQL = false;

  private void addCollectionFromElement(FromElement fromElement) {
    if fromElement.isFetch() ) {
      if fromElement.isCollectionJoin() || fromElement.getQueryableCollection() != null ) {
        String suffix;
        if (collectionFromElements==null) {
          collectionFromElements = new ArrayList();
          suffix = VERSION2_SQL ? "__" "0__";
        }
        else {
          suffix = Integer.toStringcollectionFromElements.size() ) "__";
        }
        collectionFromElements.addfromElement );
        fromElement.setCollectionSuffixsuffix );
      }
    }
  }

  protected AST getFirstSelectExpression() {
    AST n = getFirstChild();
    // Skip 'DISTINCT' and 'ALL', so we return the first expression node.
    while n != null && n.getType() == SqlTokenTypes.DISTINCT || n.getType() == SqlTokenTypes.ALL ) ) {
      n = n.getNextSibling();
    }
    return n;
  }

  private boolean isReturnableEntity(SelectExpression selectExpressionthrows SemanticException {
    FromElement fromElement = selectExpression.getFromElement();
    boolean isFetchOrValueCollection = fromElement != null && 
        fromElement.isFetch() || fromElement.isCollectionOfValuesOrComponents() )
    if isFetchOrValueCollection ) {
      return false;
    }
    else {
      return selectExpression.isReturnableEntity();
    }
  }

  private void renderScalarSelects(SelectExpression[] se, FromClause currentFromClausethrows SemanticException {
    if !currentFromClause.isSubQuery() ) {
      for int i = 0; i < se.length; i++ ) {
        SelectExpression expr = se[i];
        expr.setScalarColumnText);  // Create SQL_TOKEN nodes for the columns.
      }
    }
  }
  
  private void initAliases(SelectExpression[] selectExpressions) {
    if (constructorNode==null) {
      aliases = new String[selectExpressions.length];
      for int i=0; i<selectExpressions.length; i++ ) {
        String alias = selectExpressions[i].getAlias();
        aliases[i= alias==null ? Integer.toString(i: alias;
      }
    }
    else {
      aliases = constructorNode.getAliases();
    }
  }

  private void renderNonScalarSelects(SelectExpression[] selectExpressions, FromClause currentFromClause
  throws SemanticException {
    ASTAppender appender = new ASTAppendergetASTFactory()this );
    final int size = selectExpressions.length;
    int nonscalarSize = 0;
    for int i = 0; i < size; i++ ) {
      if !selectExpressions[i].isScalar() ) nonscalarSize++;
    }

    int j = 0;
    for int i = 0; i < size; i++ ) {
      if !selectExpressions[i].isScalar() ) {
        SelectExpression expr = selectExpressions[i];
        FromElement fromElement = expr.getFromElement();
        if fromElement != null ) {
          renderNonScalarIdentifiersfromElement, nonscalarSize, j, expr, appender );
          j++;
        }
      }
    }

    if !currentFromClause.isSubQuery() ) {
      // Generate the property select tokens.
      int k = 0;
      for int i = 0; i < size; i++ ) {
        if !selectExpressions[i].isScalar() ) {
          FromElement fromElement = selectExpressions[i].getFromElement();
          if fromElement != null ) {
            renderNonScalarPropertiesappender, fromElement, nonscalarSize, k );
            k++;
          }
        }
      }
    }
  }

  private void renderNonScalarIdentifiers(FromElement fromElement, int nonscalarSize, int j, SelectExpression expr, ASTAppender appender) {
    String text = fromElement.renderIdentifierSelectnonscalarSize, j );
    if !fromElement.getFromClause().isSubQuery() ) {
      if !scalarSelect && !getWalker().isShallowQuery() ) {
        //TODO: is this a bit ugly?
        expr.setTexttext );
      }
      else {
        appender.appendSqlTokenTypes.SQL_TOKEN, text, false );
      }
    }
  }

  private void renderNonScalarProperties(ASTAppender appender, FromElement fromElement, int nonscalarSize, int k) {
    String text = fromElement.renderPropertySelectnonscalarSize, k );
    appender.appendSqlTokenTypes.SQL_TOKEN, text, false );
    if fromElement.getQueryableCollection() != null && fromElement.isFetch() ) {
      text = fromElement.renderCollectionSelectFragmentnonscalarSize, k );
      appender.appendSqlTokenTypes.SQL_TOKEN, text, false );
    }
    // Look through the FromElement's children to find any collections of values that should be fetched...
    ASTIterator iter = new ASTIteratorfromElement );
    while iter.hasNext() ) {
      FromElement child = FromElement iter.next();
      if child.isCollectionOfValuesOrComponents() && child.isFetch() ) {
        // Need a better way to define the suffixes here...
        text = child.renderValueCollectionSelectFragmentnonscalarSize, nonscalarSize + k );
        appender.appendSqlTokenTypes.SQL_TOKEN, text, false );
      }
    }
  }

  public List getCollectionFromElements() {
    return collectionFromElements;
  }
}