Package org.hibernate.jdbc

package org.hibernate.jdbc

A small API allowing the client of a Hibernate session to interact directly with JDBC, using the same connection and transaction obtained by the session.

Work and ReturningWork define the notion of a unit of JDBC work that may be executed by the session at the request of the client. Execution of a unit of work may be requested by calling:

• SharedSessionContract.doWork(org.hibernate.jdbc.Work) or
• SharedSessionContract.doReturningWork(org.hibernate.jdbc.ReturningWork).

For example:

 session.doWork(connection -> {
     try ( PreparedStatement ps = connection.prepareStatement( " ... " ) ) {
         ps.execute();
     }
 });
 

The interface Expectation defines a contract for checking the results of a JDBC operation which executes user-written SQL:

• Expectation.RowCount is used to check returned row counts,
• Expectation.OutParameter is used to check out parameters of stored procedures, and
• user-written implementations of Expectation are also supported.

An Expectation class may be specified along with the user-written SQL using SQLInsert.verify(), SQLUpdate.verify(), or SQLDelete.verify().

See Also:

• Work
• ReturningWork
• Expectation

Related Packages

Package	Description
org.hibernate	This package defines the central Hibernate APIs, beginning with SessionFactory, which represents an instance of Hibernate at runtime and is the source of new instances of Session and StatelessSession, the most important APIs exposing persistence-related operations for entities.

Class	Description
AbstractReturningWork<T>	An abstract implementation of ReturningWork that accepts a WorkExecutor visitor for executing a discrete piece of work and returning a result.
AbstractWork	An abstract implementation of Work that accepts a WorkExecutor visitor for executing a discrete piece of work.
BatchedTooManyRowsAffectedException	Much like TooManyRowsAffectedException, indicates that more rows than what we were expecting were affected.
BatchFailedException	Indicates a failed batch entry (-3 return).
Expectation	Defines an expected DML operation outcome.
Expectation.None	No return code checking.
Expectation.OutParameter	Essentially identical to Expectation.RowCount except that the row count is obtained via an output parameter of a stored procedure.
Expectation.RowCount	Row count checking.
Expectations	Useful operations for dealing with Expectations.
Expectations.BasicExpectation	Deprecated. Use Expectation.RowCount, creating a custom subclass if necessary
Expectations.BasicParamExpectation	Deprecated. Use Expectation.OutParameter, creating a custom subclass if necessary
ReturningWork<T>	A discrete piece of work making use of a JDBC connection and returning a result.
TooManyRowsAffectedException	Indicates that more rows were affected then we were expecting to be.
Work	A discrete piece of work making use of a JDBC connection.
WorkExecutor<T>	A visitor used for executing a discrete piece of work encapsulated in a Work or ReturningWork instance.
WorkExecutorVisitable<T>	This interface provides a way to execute unrelated "work" objects using polymorphism.