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: 8354 $ $Date: 2009-07-13 17:22:43 (Tue, 28 Jul 2009) $

Author:

Ahmad Hassan, Ralf Joachim

Constructor Summary

SQLStatementInsert(SQLEngine engine, PersistenceFactory factory)
Constructor.

Method Summary

Object

executeStatement(Database database, Connection 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,
                                     Connection conn,
                                     Identity identity,
                                     ProposedEntity entity)
                              throws PersistenceException

Executes the SQL statement after preparing the PreparedStatement.

Parameters:

database - A particular Database instance.

conn - An Open JDBC connection.

identity - Identity of the object to insert.

entity -

Returns:

Identity

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.