org.castor.cpa.persistence.sql.engine
Class SQLStatementUpdate

java.lang.Object
  org.castor.cpa.persistence.sql.engine.SQLStatementUpdate

public final class SQLStatementUpdate
extends Object

SQLStatementStore class that makes use of Update class hierarchy to generate sql query structure. It provides parameter binding support to the prepared statement and then executes it.

Version:

$Revision: 9026 $ $Date: 2011-08-09 00:23:03 +0200 (Di, 09 Aug 2011) $

Author:

Assaf Arkin, Thomas Yip, Bruce Snyder, Werner Guttmann, Ralf Joachim, Ahmad Hassan, Dennis Butterstein

Constructor Summary

SQLStatementUpdate(SQLEngine engine)
Constructor.

Method Summary

Object

executeStatement(CastorConnection conn, Identity identity, ProposedEntity newentity, ProposedEntity oldentity) Stores the identity to the database using JDBC Connection.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SQLStatementUpdate

public SQLStatementUpdate(SQLEngine engine)

Constructor.

Parameters:

engine - SQL engine for all persistence operations at entities of the type this class is responsible for. Holds all required information of the entity type.

Method Detail

executeStatement

public Object executeStatement(CastorConnection conn,
                               Identity identity,
                               ProposedEntity newentity,
                               ProposedEntity oldentity)
                        throws PersistenceException

Stores the identity to the database using JDBC Connection.

Parameters:

conn - CastorConnection holding connection and PersistenceFactory to be used to create statement.

identity - Identity of the object to update.

newentity - Entity holding the new values to set with update.

oldentity - Entity holding the old values to check for concurrent modifications.

Returns:

Always returns null.

Throws:

PersistenceException - If failed to update object in database. This could happen if a database access error occurs, type of one of the values to bind is ambiguous, identity or column size mismatch or object to be updated does not exist.