/*
 * 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.stat;

import java.io.Serializable;

Query statistics (HQL and SQL)

Note that for a cached query, the cache miss is equals to the db count
Author:
Gavin King, Steve Ebersole/**
 * Query statistics (HQL and SQL)
 * <p/>
 * Note that for a cached query, the cache miss is equals to the db count
 *
 * @author Gavin King
 * @author Steve Ebersole
 */
public interface QueryStatistics extends Serializable {
	
How many times has this query been executed?
/**
	 * How many times has this query been executed?
	 */
	long getExecutionCount();

	
How many ResultSet rows have been processed for this query ?
/**
	 * How many ResultSet rows have been processed for this query ?
	 */
	long getExecutionRowCount();

	
What is the average amount time taken to execute this query?
/**
	 * What is the average amount time taken to execute this query?
	 */
	long getExecutionAvgTime();

	
What is the max amount time taken to execute this query?
/**
	 * What is the max amount time taken to execute this query?
	 */
	long getExecutionMaxTime();

	
What is the min amount time taken to execute this query?
/**
	 * What is the min amount time taken to execute this query?
	 */
	long getExecutionMinTime();

	
How long, cumulatively, have all executions of this query taken?
/**
	 * How long, cumulatively, have all executions of this query taken?
	 */
	long getExecutionTotalTime();

	double getExecutionAvgTimeAsDouble();

	
The number of cache hits for this query.
API Note:
Note that a query can be saved into different
regions at different times.  This value represents the
sum total across all of those regions/**
	 * The number of cache hits for this query.
	 *
	 * @apiNote Note that a query can be saved into different
	 * regions at different times.  This value represents the
	 * sum total across all of those regions
	 */
	long getCacheHitCount();

	
The number of cache misses for this query
API Note:
Note that a query can be saved into different
regions at different times.  This value represents the
sum total across all of those regions/**
	 * The number of cache misses for this query
	 *
	 * @apiNote Note that a query can be saved into different
	 * regions at different times.  This value represents the
	 * sum total across all of those regions
	 */
	long getCacheMissCount();

	
The number of cache puts for this query
API Note:
Note that a query can be saved into different
regions at different times.  This value represents the
sum total across all of those regions/**
	 * The number of cache puts for this query
	 *
	 * @apiNote Note that a query can be saved into different
	 * regions at different times.  This value represents the
	 * sum total across all of those regions
	 */
	long getCachePutCount();
}