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

import java.lang.annotation.Repeatable;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;

import static java.lang.annotation.ElementType.PACKAGE;
import static java.lang.annotation.ElementType.TYPE;
import static java.lang.annotation.RetentionPolicy.RUNTIME;

Extends NamedNativeQuery with Hibernate features. 
Author:
Emmanuel Bernard
See Also:
SQLQuery/**
 * Extends {@link javax.persistence.NamedNativeQuery} with Hibernate features.
 *
 * @author Emmanuel Bernard
 *
 * @see org.hibernate.SQLQuery
 */
@Target({TYPE, PACKAGE})
@Retention(RUNTIME)
@Repeatable(NamedNativeQueries.class)
public @interface NamedNativeQuery {
	
The name.  It is a named query after all :)
/**
	 * The name.  It is a named query after all :)
	 */
	String name();

	
The SQL query string.
/**
	 * The SQL query string.
	 */
	String query();

	
The result Class. Should not be used in conjunction with resultSetMapping() /**
	 * The result Class.  Should not be used in conjunction with {@link #resultSetMapping()}
	 */
	Class resultClass() default void.class;

	
The name of a SQLResultSetMapping to use. Should not be used in conjunction with resultClass(). /**
	 * The name of a SQLResultSetMapping to use.  Should not be used in conjunction with {@link #resultClass()}.
	 */
	String resultSetMapping() default "";

	
The flush mode for the query.
/**
	 * The flush mode for the query.
	 */
	FlushModeType flushMode() default FlushModeType.PERSISTENCE_CONTEXT;

	
Whether the query (results) is cacheable or not. Default is false, that is not cacheable. /**
	 * Whether the query (results) is cacheable or not.  Default is {@code false}, that is not cacheable.
	 */
	boolean cacheable() default false;

	
If the query results are cacheable, name the query cache region to use.
/**
	 * If the query results are cacheable, name the query cache region to use.
	 */
	String cacheRegion() default "";

	
The number of rows fetched by the JDBC Driver per trip.
/**
	 * The number of rows fetched by the JDBC Driver per trip.
	 */
	int fetchSize() default -1;

	
The query timeout (in seconds).  Default is no timeout.
/**
	 * The query timeout (in seconds).  Default is no timeout.
	 */
	int timeout() default -1;

	
Does the SQL (query()) represent a call to a procedure/function? /**
	 * Does the SQL ({@link #query()}) represent a call to a procedure/function?
	 */
	boolean callable() default false;

	
A comment added to the SQL query.  Useful when engaging with DBA.
/**
	 * A comment added to the SQL query.  Useful when engaging with DBA.
	 */
	String comment() default "";

	
The cache mode used for this query.  This refers to entities/collections returned from the query.
/**
	 * The cache mode used for this query.  This refers to entities/collections returned from the query.
	 */
	CacheModeType cacheMode() default CacheModeType.NORMAL;

	
Whether the results should be read-only. Default is false. /**
	 * Whether the results should be read-only.  Default is {@code false}.
	 */
	boolean readOnly() default false;
}