FileDocCategorySizeDatePackage
ConnectionReleaseMode.javaAPI DocHibernate 3.2.52497Fri Oct 14 15:28:18 BST 2005org.hibernate

ConnectionReleaseMode

public class ConnectionReleaseMode extends Object implements Serializable
Defines the various policies by which Hibernate might release its underlying JDBC connection.
author
Steve Ebersole

Fields Summary
public static final ConnectionReleaseMode
AFTER_STATEMENT
Indicates that JDBC connection should be aggressively released after each SQL statement is executed. In this mode, the application must explicitly close all iterators and scrollable results. This mode may only be used with a JTA datasource.
public static final ConnectionReleaseMode
AFTER_TRANSACTION
Indicates that JDBC connections should be released after each transaction ends (works with both JTA-registered synch and HibernateTransaction API). This mode may not be used with an application server JTA datasource.

This is the default mode starting in 3.1; was previously {@link #ON_CLOSE}.

public static final ConnectionReleaseMode
ON_CLOSE
Indicates that connections should only be released when the Session is explicitly closed or disconnected; this is the legacy (Hibernate2 and pre-3.1) behavior.
private String
name
Constructors Summary
private ConnectionReleaseMode(String name)


	   
		this.name = name;
	
Methods Summary
public static org.hibernate.ConnectionReleaseModeparse(java.lang.String modeName)
Determine the correct ConnectionReleaseMode instance based on the given name.

param
modeName The release mode name.
return
The appropriate ConnectionReleaseMode instance
throws
HibernateException Indicates the modeName param did not match any known modes.

		if ( AFTER_STATEMENT.name.equals( modeName ) ) {
			return AFTER_STATEMENT;
		}
		else if ( AFTER_TRANSACTION.name.equals( modeName ) ) {
			return AFTER_TRANSACTION;
		}
		else if ( ON_CLOSE.name.equals( modeName ) ) {
			return ON_CLOSE;
		}
		throw new HibernateException( "could not determine appropriate connection release mode [" + modeName + "]" );
	
private java.lang.ObjectreadResolve()

		return parse( name );
	
public java.lang.StringtoString()
Override of Object.toString(). Returns the release mode name.

return
The release mode name.

		return name;