Open Source Repository

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



org/hibernate/impl/CriteriaImpl.java
//$Id: CriteriaImpl.java 9116 2006-01-23 21:21:01Z steveebersole $
package org.hibernate.impl;

import java.io.Serializable;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;

import org.hibernate.CacheMode;
import org.hibernate.Criteria;
import org.hibernate.FetchMode;
import org.hibernate.FlushMode;
import org.hibernate.HibernateException;
import org.hibernate.LockMode;
import org.hibernate.ScrollMode;
import org.hibernate.ScrollableResults;
import org.hibernate.criterion.Criterion;
import org.hibernate.criterion.NaturalIdentifier;
import org.hibernate.criterion.Order;
import org.hibernate.criterion.Projection;
import org.hibernate.engine.SessionImplementor;
import org.hibernate.transform.ResultTransformer;
import org.hibernate.util.StringHelper;

/**
 * Implementation of the <tt>Criteria</tt> interface
 @author Gavin King
 */
public class CriteriaImpl implements Criteria, Serializable {

  private final String entityOrClassName;
  private transient SessionImplementor session;
  private final String rootAlias;

  private List criterionEntries = new ArrayList();
  private List orderEntries = new ArrayList();
  private Projection projection;
  private Criteria projectionCriteria;

  private List subcriteriaList = new ArrayList();

  private Map fetchModes = new HashMap();
  private Map lockModes = new HashMap();

  private Integer maxResults;
  private Integer firstResult;
  private Integer timeout;
  private Integer fetchSize;

  private boolean cacheable;
  private String cacheRegion;
  private String comment;

  private FlushMode flushMode;
  private CacheMode cacheMode;
  private FlushMode sessionFlushMode;
  private CacheMode sessionCacheMode;
  
  private ResultTransformer resultTransformer = Criteria.ROOT_ENTITY;


  // Constructors ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  public CriteriaImpl(String entityOrClassName, SessionImplementor session) {
    this(entityOrClassName, ROOT_ALIAS, session);
  }

  public CriteriaImpl(String entityOrClassName, String alias, SessionImplementor session) {
    this.session = session;
    this.entityOrClassName = entityOrClassName;
    this.cacheable = false;
    this.rootAlias = alias;
  }

  public String toString() {
    return "CriteriaImpl(" +
      entityOrClassName + ":" +
      (rootAlias==null "" : rootAlias+
      subcriteriaList.toString() +
      criterionEntries.toString() +
      projection==null "" : projection.toString() ) +
      ')';
  }


  // State ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  public SessionImplementor getSession() {
    return session;
  }

  public void setSession(SessionImplementor session) {
    this.session = session;
  }

  public String getEntityOrClassName() {
    return entityOrClassName;
  }

  public Map getLockModes() {
    return lockModes;
  }

  public Criteria getProjectionCriteria() {
    return projectionCriteria;
  }

  public Iterator iterateSubcriteria() {
    return subcriteriaList.iterator();
  }

  public Iterator iterateExpressionEntries() {
    return criterionEntries.iterator();
  }

  public Iterator iterateOrderings() {
    return orderEntries.iterator();
  }

  public Criteria add(Criteria criteriaInst, Criterion expression) {
    criterionEntries.addnew CriterionEntry(expression, criteriaInst) );
    return this;
  }


  // Criteria impl ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  public String getAlias() {
    return rootAlias;
  }

  public Projection getProjection() {
    return projection;
  }

  public Criteria setProjection(Projection projection) {
    this.projection = projection;
    this.projectionCriteria = this;
    setResultTransformerPROJECTION );
    return this;
  }

  public Criteria add(Criterion expression) {
    addthis, expression );
    return this;
  }

  public Criteria addOrder(Order ordering) {
    orderEntries.addnew OrderEntryordering, this ) );
    return this;
  }

  public FetchMode getFetchMode(String path) {
    return (FetchModefetchModes.get(path);
  }

  public Criteria setFetchMode(String associationPath, FetchMode mode) {
    fetchModes.putassociationPath, mode );
    return this;
  }

  public Criteria setLockMode(LockMode lockMode) {
    return setLockModegetAlias(), lockMode );
  }

  public Criteria setLockMode(String alias, LockMode lockMode) {
    lockModes.putalias, lockMode );
    return this;
  }

  public Criteria createAlias(String associationPath, String alias) {
    return createAliasassociationPath, alias, INNER_JOIN );
  }

  public Criteria createAlias(String associationPath, String alias, int joinType) {
    new Subcriteriathis, associationPath, alias, joinType );
    return this;
  }

  public Criteria createCriteria(String associationPath) {
    return createCriteriaassociationPath, INNER_JOIN );
  }

  public Criteria createCriteria(String associationPath, int joinType) {
    return new Subcriteriathis, associationPath, joinType );
  }

  public Criteria createCriteria(String associationPath, String alias) {
    return createCriteriaassociationPath, alias, INNER_JOIN );
  }

  public Criteria createCriteria(String associationPath, String alias, int joinType) {
    return new Subcriteriathis, associationPath, alias, joinType );
  }

  public ResultTransformer getResultTransformer() {
    return resultTransformer;
  }

  public Criteria setResultTransformer(ResultTransformer tupleMapper) {
    this.resultTransformer = tupleMapper;
    return this;
  }

  public Integer getMaxResults() {
    return maxResults;
  }

  public Criteria setMaxResults(int maxResults) {
    this.maxResults = new Integer(maxResults);
    return this;
  }

  public Integer getFirstResult() {
    return firstResult;
  }

  public Criteria setFirstResult(int firstResult) {
    this.firstResult = new Integer(firstResult);
    return this;
  }

  public Integer getFetchSize() {
    return fetchSize;
  }

  public Criteria setFetchSize(int fetchSize) {
    this.fetchSize = new Integer(fetchSize);
    return this;
  }

  public Integer getTimeout() {
    return timeout;
  }

  public Criteria setTimeout(int timeout) {
    this.timeout = new Integer(timeout);
    return this;
  }

  public boolean getCacheable() {
    return this.cacheable;
  }

  public Criteria setCacheable(boolean cacheable) {
    this.cacheable = cacheable;
    return this;
  }

  public String getCacheRegion() {
    return this.cacheRegion;
  }

  public Criteria setCacheRegion(String cacheRegion) {
    this.cacheRegion = cacheRegion.trim();
    return this;
  }

  public String getComment() {
    return comment;
  }

  public Criteria setComment(String comment) {
    this.comment = comment;
    return this;
  }

  public Criteria setFlushMode(FlushMode flushMode) {
    this.flushMode = flushMode;
    return this;
  }

  public Criteria setCacheMode(CacheMode cacheMode) {
    this.cacheMode = cacheMode;
    return this;
  }

  public List list() throws HibernateException {
    before();
    try {
      return session.listthis );
    }
    finally {
      after();
    }
  }
  
  public ScrollableResults scroll() {
    return scrollScrollMode.SCROLL_INSENSITIVE );
  }

  public ScrollableResults scroll(ScrollMode scrollMode) {
    before();
    try {
      return session.scroll(this, scrollMode);
    }
    finally {
      after();
    }
  }

  public Object uniqueResult() throws HibernateException {
    return AbstractQueryImpl.uniqueElementlist() );
  }

  protected void before() {
    if flushMode != null ) {
      sessionFlushMode = getSession().getFlushMode();
      getSession().setFlushModeflushMode );
    }
    if cacheMode != null ) {
      sessionCacheMode = getSession().getCacheMode();
      getSession().setCacheModecacheMode );
    }
  }
  
  protected void after() {
    if sessionFlushMode != null ) {
      getSession().setFlushModesessionFlushMode );
      sessionFlushMode = null;
    }
    if sessionCacheMode != null ) {
      getSession().setCacheModesessionCacheMode );
      sessionCacheMode = null;
    }
  }
  
  public boolean isLookupByNaturalKey() {
    if projection != null ) {
      return false;
    }
    if subcriteriaList.size() ) {
      return false;
    }
    if criterionEntries.size() != ) {
      return false;
    }
    CriterionEntry ce = (CriterionEntrycriterionEntries.get(0);
    return ce.getCriterion() instanceof NaturalIdentifier;
  }


  // Inner classes ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  public final class Subcriteria implements Criteria, Serializable {

    private String alias;
    private String path;
    private Criteria parent;
    private LockMode lockMode;
    private int joinType;


    // Constructors ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

    private Subcriteria(Criteria parent, String path, String alias, int joinType) {
      this.alias = alias;
      this.path = path;
      this.parent = parent;
      this.joinType = joinType;
      CriteriaImpl.this.subcriteriaList.add(this);
    }

    private Subcriteria(Criteria parent, String path, int joinType) {
      thisparent, path, null, joinType );
    }

    public String toString() {
      return "Subcriteria(" +
        path + ":" +
        (alias==null "" : alias+
        ')';
    }


    // State ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

    public String getAlias() {
      return alias;
    }

    public void setAlias(String alias) {
      this.alias = alias;
    }

    public String getPath() {
      return path;
    }

    public Criteria getParent() {
      return parent;
    }

    public LockMode getLockMode() {
      return lockMode;
    }

    public Criteria setLockMode(LockMode lockMode) {
      this.lockMode = lockMode;
      return this;
    }

    public int getJoinType() {
      return joinType;
    }


    // Criteria impl ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

    public Criteria add(Criterion expression) {
      CriteriaImpl.this.add(this, expression);
      return this;
    }

    public Criteria addOrder(Order order) {
      CriteriaImpl.this.orderEntries.addnew OrderEntry(order, this) );
      return this;
    }

    public Criteria createAlias(String associationPath, String alias) {
      return createAliasassociationPath, alias, INNER_JOIN );
    }

    public Criteria createAlias(String associationPath, String alias, int joinTypethrows HibernateException {
      new Subcriteriathis, associationPath, alias, joinType );
      return this;
    }

    public Criteria createCriteria(String associationPath) {
      return createCriteriaassociationPath, INNER_JOIN );
    }

    public Criteria createCriteria(String associationPath, int joinTypethrows HibernateException {
      return new SubcriteriaSubcriteria.this, associationPath, joinType );
    }

    public Criteria createCriteria(String associationPath, String alias) {
      return createCriteriaassociationPath, alias, INNER_JOIN );
    }

    public Criteria createCriteria(String associationPath, String alias, int joinTypethrows HibernateException {
      return new SubcriteriaSubcriteria.this, associationPath, alias, joinType );
    }

    public Criteria setCacheable(boolean cacheable) {
      CriteriaImpl.this.setCacheable(cacheable);
      return this;
    }

    public Criteria setCacheRegion(String cacheRegion) {
      CriteriaImpl.this.setCacheRegion(cacheRegion);
      return this;
    }

    public List list() throws HibernateException {
      return CriteriaImpl.this.list();
    }

    public ScrollableResults scroll() throws HibernateException {
      return CriteriaImpl.this.scroll();
    }

    public ScrollableResults scroll(ScrollMode scrollModethrows HibernateException {
      return CriteriaImpl.this.scroll(scrollMode);
    }

    public Object uniqueResult() throws HibernateException {
      return CriteriaImpl.this.uniqueResult();
    }

    public Criteria setFetchMode(String associationPath, FetchMode mode)
      throws HibernateException {
      CriteriaImpl.this.setFetchModeStringHelper.qualify(path, associationPath), mode);
      return this;
    }

    public Criteria setFlushMode(FlushMode flushMode) {
      CriteriaImpl.this.setFlushMode(flushMode);
      return this;
    }

    public Criteria setCacheMode(CacheMode cacheMode) {
      CriteriaImpl.this.setCacheMode(cacheMode);
      return this;
    }

    public Criteria setFirstResult(int firstResult) {
      CriteriaImpl.this.setFirstResult(firstResult);
      return this;
    }

    public Criteria setMaxResults(int maxResults) {
      CriteriaImpl.this.setMaxResults(maxResults);
      return this;
    }

    public Criteria setTimeout(int timeout) {
      CriteriaImpl.this.setTimeout(timeout);
      return this;
    }

    public Criteria setFetchSize(int fetchSize) {
      CriteriaImpl.this.setFetchSize(fetchSize);
      return this;
    }

    public Criteria setLockMode(String alias, LockMode lockMode) {
      CriteriaImpl.this.setLockMode(alias, lockMode);
      return this;
    }

    public Criteria setResultTransformer(ResultTransformer resultProcessor) {
      CriteriaImpl.this.setResultTransformer(resultProcessor);
      return this;
    }

    public Criteria setComment(String comment) {
      CriteriaImpl.this.setComment(comment);
      return this;
    }

    public Criteria setProjection(Projection projection) {
      CriteriaImpl.this.projection = projection;
      CriteriaImpl.this.projectionCriteria = this;
      setResultTransformer(PROJECTION);
      return this;
    }
  }

  public static final class CriterionEntry implements Serializable {
    private final Criterion criterion;
    private final Criteria criteria;

    private CriterionEntry(Criterion criterion, Criteria criteria) {
      this.criteria = criteria;
      this.criterion = criterion;
    }

    public Criterion getCriterion() {
      return criterion;
    }

    public Criteria getCriteria() {
      return criteria;
    }

    public String toString() {
      return criterion.toString();
    }
  }

  public static final class OrderEntry implements Serializable {
    private final Order order;
    private final Criteria criteria;

    private OrderEntry(Order order, Criteria criteria) {
      this.criteria = criteria;
      this.order = order;
    }

    public Order getOrder() {
      return order;
    }

    public Criteria getCriteria() {
      return criteria;
    }

    public String toString() {
      return order.toString();
    }
  }
}