it.eng.spago.dbaccess.sql
Class DataConnection

java.lang.Object
  extended by it.eng.spago.dbaccess.sql.DataConnection

public class DataConnection
extends java.lang.Object

DATE CONTRIBUTOR/DEVELOPER NOTE 13-12-2005 Boccalon/Grassi - Fixed the tracing of the exceptions in the constructor


Constructor Summary
DataConnection(java.sql.Connection connection, java.lang.String driverVersion, SQLMapper sqlMapper)
          Costruttore : Attenzione la connessione viene creata invocando setAutoCommit(true).
 
Method Summary
 void close()
          Questo metodo è utilizzato per chiudere la connessione
 void commitTransaction()
          Questo metodo è utilizzato per effettuare la commit delle operazioni effettuate durante una transazione sulla connessione.
 DataField createDataField(java.lang.String name, int type, java.lang.Object value)
          Crea un DataField associandolo all' SqlMapper della connessione.
 DataField createDataField(java.lang.String name, int type, java.lang.Object value, java.lang.String typeName)
          Crea un DataField associandolo all' SqlMapper della connessione.
 SQLCommand createDeleteCommand(java.lang.String commandString)
          Crea un SQLCommand di delete per la connessione dato il CommandString.
 SQLCommand createInsertCommand(java.lang.String commandString)
          Crea un SQLCommand di insert per la connessione dato il CommandString.
 SQLCommand createSelectCommand(java.lang.String commandString)
          Crea un SQLCommand di select per la connessione dato il CommandString.
 SQLCommand createSelectCommand(java.lang.String commandString, boolean scroll)
           
 SQLCommand createStoredProcedureCommand(java.lang.String commandString)
          Crea un SQLCommand per eseguire un stored procedure dato il CommandString.
 SQLCommand createUpdateCommand(java.lang.String commandString)
          Crea un SQLCommand di update per la connessione dato il CommandString.
 java.sql.Connection getInternalConnection()
          Metodo per ottenere la connessione .
 SQLMapper getSQLMapper()
          Questo metodo permette di recuperare l'oggetto che rappresenta la tipologia di Mapper associata a quella connessione
 int getTransactionIsolation()
          Metodo per ottenere il livello di isolamento associato al DataConnection.
 void initTransaction()
          Questo metodo è utilizzato per aprire una transazione sulla connessione.
 boolean isClosed()
           
 void rollBackTransaction()
          Questo metodo è utilizzato per eseguire il rollBack delle operazioni effettuate durante una transazione sulla connessione
 void setTransactionIsolation(int transactionIsolationLevel)
          Metodo per impostare il livello di isolamento associato al DataConnection.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

DataConnection

public DataConnection(java.sql.Connection connection,
                      java.lang.String driverVersion,
                      SQLMapper sqlMapper)
               throws EMFInternalError
Costruttore : Attenzione la connessione viene creata invocando setAutoCommit(true).

Parameters:
connection - - la connessione sql alla base dell'oggetto dataConnection
driverVersion - - la versione del driver utilizzato dalla connessione
sqlMapper - - la classe per il mappinf dei dataField
Throws:
EMFInternalError - - Se viene generato qualche errore durante l'inizializzazione della connessione
Method Detail

initTransaction

public void initTransaction()
                     throws EMFInternalError
Questo metodo è utilizzato per aprire una transazione sulla connessione.

Throws:
EMFInternalError - - Se viene generato qualche errore durante l'inizializzazzione della transazione
EMFInternalError

commitTransaction

public void commitTransaction()
                       throws EMFInternalError
Questo metodo è utilizzato per effettuare la commit delle operazioni effettuate durante una transazione sulla connessione.

Throws:
EMFInternalError - - Se viene generato qualche errore durante il commit della transazione
EMFInternalError

rollBackTransaction

public void rollBackTransaction()
                         throws EMFInternalError
Questo metodo è utilizzato per eseguire il rollBack delle operazioni effettuate durante una transazione sulla connessione

Throws:
EMFInternalError - - Se viene generato qualche errore durante il rollBack
EMFInternalError

close

public void close()
           throws EMFInternalError
Questo metodo è utilizzato per chiudere la connessione

Throws:
EMFInternalError - - Se viene generato qualche errore durante la chiusura della connessione
EMFInternalError

createInsertCommand

public SQLCommand createInsertCommand(java.lang.String commandString)
Crea un SQLCommand di insert per la connessione dato il CommandString.

Parameters:
commandString - - La stringa contenente il comando sql.
Returns:
un oggetto di tipo SQLCommand rappresentante il comando di insert.

createDeleteCommand

public SQLCommand createDeleteCommand(java.lang.String commandString)
Crea un SQLCommand di delete per la connessione dato il CommandString.

Parameters:
String - commandString - La stringa contenente il comando sql.
Returns:
un oggetto di tipo SQLCommand rappresentante il comando di delete .

createStoredProcedureCommand

public SQLCommand createStoredProcedureCommand(java.lang.String commandString)
Crea un SQLCommand per eseguire un stored procedure dato il CommandString.

Parameters:
String - commandString - La stringa contenente il comando sql.
Returns:
un oggetto di tipo SQLCommand rappresentante il comando per l'esecuzione di una stored procedure.

createUpdateCommand

public SQLCommand createUpdateCommand(java.lang.String commandString)
Crea un SQLCommand di update per la connessione dato il CommandString.

Parameters:
String - commandString - La stringa contenente il comando sql.
Returns:
un oggetto di tipo SQLCommand rappresentante il comando di update.

createSelectCommand

public SQLCommand createSelectCommand(java.lang.String commandString)
Crea un SQLCommand di select per la connessione dato il CommandString.

Parameters:
String - commandString - La stringa contenente il comando sql.
Returns:
un oggetto di tipo SQLCommand rappresentante il comando di select.

createSelectCommand

public SQLCommand createSelectCommand(java.lang.String commandString,
                                      boolean scroll)

createDataField

public DataField createDataField(java.lang.String name,
                                 int type,
                                 java.lang.Object value)
Crea un DataField associandolo all' SqlMapper della connessione.

Parameters:
String - name - La stringa contenente il comando sql.
int - type - il java.sql.Type del DataField.
Object - value - valore del DataField.
Returns:
un oggetto di tipo DataField

createDataField

public DataField createDataField(java.lang.String name,
                                 int type,
                                 java.lang.Object value,
                                 java.lang.String typeName)
Crea un DataField associandolo all' SqlMapper della connessione.

Parameters:
String - name - La stringa contenente il comando sql.
int - type - il java.sql.Type del DataField.
Object - value - valore del DataField.
String - typeName - fully-qualified name di un SQL structured type.
Returns:
un oggetto di tipo DataField

getSQLMapper

public SQLMapper getSQLMapper()
Questo metodo permette di recuperare l'oggetto che rappresenta la tipologia di Mapper associata a quella connessione

Returns:
l'oggetto di tipo SQLMapper associato alla connessione

getTransactionIsolation

public int getTransactionIsolation()
                            throws EMFInternalError
Metodo per ottenere il livello di isolamento associato al DataConnection.

Returns:
int il valore di una delle seguenti costanti :
  • TRANSACTION_READ_UNCOMMITTED
  • TRANSACTION_READ_COMMITTED
  • TRANSACTION_REPEATABLE_READ
  • TRANSACTION_SERIALIZABLE
    Throws:
    EMFInternalError

  • setTransactionIsolation

    public void setTransactionIsolation(int transactionIsolationLevel)
                                 throws EMFInternalError
    Metodo per impostare il livello di isolamento associato al DataConnection.

    Parameters:
    int - transactionIsolationLevel il valore di una delle seguenti costanti :
  • TRANSACTION_READ_UNCOMMITTED
  • TRANSACTION_READ_COMMITTED
  • TRANSACTION_REPEATABLE_READ
  • TRANSACTION_SERIALIZABLE
    Throws:
    EMFInternalError

  • getInternalConnection

    public java.sql.Connection getInternalConnection()
    Metodo per ottenere la connessione .

    Returns:
    Connection la connessione attiva.

    isClosed

    public boolean isClosed()