it.eng.spago.dbaccess.sql
Class DataConnection

java.lang.Object
  extended byit.eng.spago.dbaccess.sql.DataConnection

public class DataConnection
extends java.lang.Object

Questa Classe rappresenta una Connessione al DataBase ed è responsabile della :

  • gestione delle transazioni ( Di Default una dataConnection è auto commited )
  • creazione dei comandi da eseguire
  • creazione dei DataField ATTENZIONE: UNA VOLTA TERMINATO L'USO DELLA CONNESSIONE E' NECESSARIO RICHIAMARE ESPLICITAMENTE IL METODO close()


    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.
     DataField createDataField(java.lang.String name, int type, java.lang.String value)
              Crea un DataField associandolo all'SqlMapper della connessione.
     DataField createDataField(java.lang.String name, int type, java.lang.String 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.
     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.

    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.

    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.

    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.

    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.

    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.

    Returns:
    un oggetto di tipo DataField

    createDataField

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

    Returns:
    un oggetto di tipo DataField

    createDataField

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

    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.

    Throws:
    EMFInternalError

    getInternalConnection

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

    Returns:
    Connection la connessione attiva.