http://hibernate.org: Hibernate's core ORM functionality (Hibernate.org) 
/*
 * Hibernate, Relational Persistence for Idiomatic Java
 *
 * License: GNU Lesser General Public License (LGPL), version 2.1 or later.
 * See the lgpl.txt file in the root directory or <http://www.gnu.org/licenses/lgpl-2.1.html>.
 */
package org.hibernate.result;

/**
 * Defines support for dealing with database results, accounting for mixed result sets and update counts hiding the
 * complexity (IMO) of how this is exposed in the JDBC API.
 *
 * {@link Result} represents the overall group of results.
 *
 * {@link Return} represents the mixed individual outcomes, which might be either a {@link ResultSetReturn} or
 * a {@link UpdateCountReturn}.
 *
 * <code>
 *     Result result = ...;
 *     while ( result.hasMoreReturns() ) {
 *         final Return rtn = result.getNextReturn();
 *         if ( rtn.isResultSet() ) {
 *             handleResultSetReturn( (ResultSetReturn) rtn );
 *         }
 *         else {
 *             handleUpdateCountReturn( (UpdateCountReturn) rtn );
 *         }
 *     }
 * </code>
 */