/*
 * Hibernate, Relational Persistence for Idiomatic Java
 *
 * Copyright (c) 2008, 2013, Red Hat Inc. or third-party contributors as
 * indicated by the @author tags or express copyright attribution
 * statements applied by the authors.  All third-party contributions are
 * distributed under license by Red Hat Inc.
 *
 * This copyrighted material is made available to anyone wishing to use, modify,
 * copy, or redistribute it subject to the terms and conditions of the GNU
 * Lesser General Public License, as published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
 * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License
 * for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this distribution; if not, write to:
 * Free Software Foundation, Inc.
 * 51 Franklin Street, Fifth Floor
 * Boston, MA  02110-1301  USA
 */
package org.hibernate.engine.query.spi.sql;

import java.util.Map;

import org.hibernate.LockMode;

Represents a return defined as part of a native sql query which names a collection role in the form {className}.{collectionRole}; it is used in defining a custom sql query for loading an entity's collection in non-fetching scenarios (i.e., loading the collection itself as the "root" of the result).
Author:Steve Ebersole
/** * Represents a return defined as part of a native sql query which * names a collection role in the form {className}.{collectionRole}; it * is used in defining a custom sql query for loading an entity's * collection in non-fetching scenarios (i.e., loading the collection * itself as the "root" of the result). * * @author Steve Ebersole */
public class NativeSQLQueryCollectionReturn extends NativeSQLQueryNonScalarReturn { private final String ownerEntityName; private final String ownerProperty; private final int hashCode;
Construct a native-sql return representing a collection initializer
Params:
  • alias – The result alias
  • ownerEntityName – The entity-name of the entity owning the collection to be initialized.
  • ownerProperty – The property name (on the owner) which represents the collection to be initialized.
  • propertyResults – Any user-supplied column->property mappings
  • lockMode – The lock mode to apply to the collection.
/** * Construct a native-sql return representing a collection initializer * * @param alias The result alias * @param ownerEntityName The entity-name of the entity owning the collection * to be initialized. * @param ownerProperty The property name (on the owner) which represents * the collection to be initialized. * @param propertyResults Any user-supplied column->property mappings * @param lockMode The lock mode to apply to the collection. */
@SuppressWarnings("unchecked") public NativeSQLQueryCollectionReturn( String alias, String ownerEntityName, String ownerProperty, Map propertyResults, LockMode lockMode) { super( alias, propertyResults, lockMode ); this.ownerEntityName = ownerEntityName; this.ownerProperty = ownerProperty; this.hashCode = determineHashCode(); } private int determineHashCode() { int result = super.hashCode(); result = 31 * result + ( ownerEntityName != null ? ownerEntityName.hashCode() : 0 ); result = 31 * result + ( ownerProperty != null ? ownerProperty.hashCode() : 0 ); return result; }
Returns the class owning the collection.
Returns:The class owning the collection.
/** * Returns the class owning the collection. * * @return The class owning the collection. */
public String getOwnerEntityName() { return ownerEntityName; }
Returns the name of the property representing the collection from the getOwnerEntityName.
Returns:The name of the property representing the collection on the owner class.
/** * Returns the name of the property representing the collection from the {@link #getOwnerEntityName}. * * @return The name of the property representing the collection on the owner class. */
public String getOwnerProperty() { return ownerProperty; } @Override @SuppressWarnings("RedundantIfStatement") public boolean equals(Object o) { if ( this == o ) { return true; } if ( o == null || getClass() != o.getClass() ) { return false; } if ( !super.equals( o ) ) { return false; } final NativeSQLQueryCollectionReturn that = (NativeSQLQueryCollectionReturn) o; if ( ownerEntityName != null ? !ownerEntityName.equals( that.ownerEntityName ) : that.ownerEntityName != null ) { return false; } if ( ownerProperty != null ? !ownerProperty.equals( that.ownerProperty ) : that.ownerProperty != null ) { return false; } return true; } @Override public int hashCode() { return hashCode; } }