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

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

public class SQLStatementInsert
extends Object

SQLStatementCreate class that makes use of KeyGenerators methods to build sql insert statement and execute them.

Version:

$Revision: 8994 $ $Date: 2011-08-02 01:40:59 +0200 (Di, 02 Aug 2011) $

Author:

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

Constructor Summary

SQLStatementInsert(SQLEngine engine, PersistenceFactory factory)
Constructor.

Method Summary

Object

executeStatement(Database database, CastorConnection conn, Identity identity, ProposedEntity entity) Executes the SQL statement after preparing the PreparedStatement.

Methods inherited from class java.lang.Object

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

Constructor Detail

SQLStatementInsert

public SQLStatementInsert(SQLEngine engine,
                          PersistenceFactory factory)
                   throws MappingException

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.

factory - Persistence factory for the database engine the entity is persisted in. Used to format the SQL statement.

Throws:

MappingException - If fails to get the Key Generator instance.

Method Detail

executeStatement

public final Object executeStatement(Database database,
                                     CastorConnection conn,
                                     Identity identity,
                                     ProposedEntity entity)
                              throws PersistenceException

Executes the SQL statement after preparing the PreparedStatement.

Parameters:

database - A particular Database instance.

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

identity - Identity of the object to insert.

entity - Entity holding the values to insert.

Returns:

Identity of the entity inserted.

Throws:

PersistenceException - If failed to insert record into database. This could happen if a database access error occurs, If identity size mismatches, unable to retrieve Identity, If provided Identity is null, If Extended engine is null.