ssbm.db.mapping
Class MovimentazioneFinanziariaMapper

java.lang.Object
  extended by ssbm.db.mapping.DataMapper
      extended by ssbm.db.mapping.MovimentazioneFinanziariaMapper

public class MovimentazioneFinanziariaMapper
extends DataMapper

Questa classe gestisce il data mapping tra l’entità MovimentazioneFinanziaria e le tavole del database in cui sono storicizzati i dati degli esemplari di tale entità.

Author:
Salvatore Piccione

Field Summary
private static Entities ENTITY
          Il nome dell'entità gestita da questo data mapper.
 
Fields inherited from class ssbm.db.mapping.DataMapper
INVALID_ID
 
Constructor Summary
MovimentazioneFinanziariaMapper()
          Costruisce un'istanza connessa al database dell'applicazione.
 
Method Summary
 int delete(long[] elencoID, java.lang.String username)
          Elimina i dati delle movimentazioni finanziarie relative all'utente identificato dallo username passato come parametro e identificate dagli ID riportati nell'array passato come parametro.
 MovimentazioneFinanziaria[] get(MovimentazioneFinanziaria.IdentificatoreElenco id)
          Recupera dal database i dati di un elenco di movimentazioni finanziarie e li usa per costruire un array di istanze di MovimentazioneFinanziaria.
 MovimentazioneFinanziaria get(MovimentazioneFinanziaria.IdentificatoreUnivoco id)
          Recupera dal database i dati di una movimentazione finanziaria e li usa per costruire un'istanza di MovimentazioneFinanziaria.
 java.lang.String[] getElencoTipi(MovimentazioneFinanziaria.Natura natura)
          Recupera dal database i nomi dei tipi di movimentazione finanziaria aventi come natura quella indicata nel parametro
private  long getIDcontroparte(java.lang.String statement, java.lang.String controparte)
          Recupera l'ID che identifica la tupla in cui è memorizzata la controparte di una movimentazione finanziaria.
private  long getIDtipo(java.lang.String statement, java.lang.String tipo, MovimentazioneFinanziaria.Natura natura)
          Recupera l'ID che identifica la tupla in cui è memorizzato il tipo di una movimentazione finanziaria.
private  long getIDutente(java.lang.String statement, java.lang.String username)
          Recupera l'ID che identifica la tupla in cui sono memorizzati i dati dell'utente identificato dallo username passato come parametro.
 int insert(MovimentazioneFinanziaria mov)
          Inserisce nel database i dati contenuti nell'istanza di MovimentazioneFinanziaria passato come parametro.
 int update(MovimentazioneFinanziaria mov)
          Aggiorna i dati memorizzati nel database in base a quelli contenuti nell'istanza di MovimentazioneFinanziaria passata come parametro.
 
Methods inherited from class ssbm.db.mapping.DataMapper
endMapping, finalize, getDatabaseConnector, getLastInsertID
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

ENTITY

private static final Entities ENTITY
Il nome dell'entità gestita da questo data mapper.

Constructor Detail

MovimentazioneFinanziariaMapper

public MovimentazioneFinanziariaMapper()
                                throws DatabaseException
Costruisce un'istanza connessa al database dell'applicazione.

Throws:
DatabaseException - nel caso si verifichino errori durante la connessione al database dell'applicazione.
Method Detail

get

public MovimentazioneFinanziaria get(MovimentazioneFinanziaria.IdentificatoreUnivoco id)
                              throws DatabaseException
Recupera dal database i dati di una movimentazione finanziaria e li usa per costruire un'istanza di MovimentazioneFinanziaria.
I dati sono selezionati sulla base dei parametri contenuti nell'istanza di MovimentazioneFinanziaria.IdentificatoreUnivoco passata come parametro.

Parameters:
id - l'istanza di MovimentazioneFinanziaria.IdentificatoreUnivoco contenente i parametri per selezionare i dati della movimentazione finanziaria da restituire.
Returns:
l'istanza di MovimentazioneFinanziaria popolata con i dati recuperati in base ai parametri riportati in id oppure null se non è stato recuperato alcun dato.
Throws:
DatabaseException - nel caso si verifichino errori nel recupero dei dati dal database.

get

public MovimentazioneFinanziaria[] get(MovimentazioneFinanziaria.IdentificatoreElenco id)
                                throws DatabaseException
Recupera dal database i dati di un elenco di movimentazioni finanziarie e li usa per costruire un array di istanze di MovimentazioneFinanziaria.
I dati sono selezionati sulla base dei parametri contenuti nell'istanza di MovimentazioneFinanziaria.IdentificatoreElenco passata come parametro.

Parameters:
id - l'istanza di MovimentazioneFinanziaria.IdentificatoreElenco contenente i parametri per selezionare i dati delle movimentazioni finanziarie da restituire.
Returns:
il vettore di istanze di MovimentazioneFinanziaria popolato con i dati recuperati in base ai parametri riportati in id oppure null se non è stato recuperato alcun dato.
Throws:
DatabaseException - nel caso si verifichino errori nel recupero dei dati dal database.

delete

public int delete(long[] elencoID,
                  java.lang.String username)
           throws DatabaseException
Elimina i dati delle movimentazioni finanziarie relative all'utente identificato dallo username passato come parametro e identificate dagli ID riportati nell'array passato come parametro.

Parameters:
elencoID - l'elenco degli ID delle tuple contenenti i dati delle movimentazioni finanziarie da eliminare.
username - lo username che identifica l'utente al quale si riferiscono le movimentazioni da eliminare.
Returns:
il numero di tuple eliminate.
Throws:
DatabaseException - nel caso si verifichino errori nell'eliminazione dei dati dal database.

update

public int update(MovimentazioneFinanziaria mov)
           throws DatabaseException,
                  DomainException
Aggiorna i dati memorizzati nel database in base a quelli contenuti nell'istanza di MovimentazioneFinanziaria passata come parametro.

Parameters:
mov - l'istanza di MovimentazioneFinanziaria contenente i dati aggiornati e l'ID della tupla corrispondente alla movimentazione finanziaria da aggiornare.
Returns:
il numero di tuple aggiornate.
Throws:
DatabaseException - nel caso si verifichino errori nella connessione al database durante l'esecuzione dell'aggiornamento.
DomainException - nel caso in cui i dati aggiornati non consentano di referenziare delle tuple.
See Also:
DomainException.MISSED_REFERENCE_UPDATE_ERROR

insert

public int insert(MovimentazioneFinanziaria mov)
           throws DatabaseException,
                  DomainException
Inserisce nel database i dati contenuti nell'istanza di MovimentazioneFinanziaria passato come parametro.

Parameters:
mov - l'istanza di MovimentazioneFinanziaria contenente i dati da storicizzare.
Returns:
il numero di tuple inserite.
Throws:
DatabaseException - nel caso si verifichino errori nella connessione al database durante l'esecuzione dell'aggiornamento.
DomainException - nel caso in cui i dati non consentano di referenziare delle tuple.
See Also:
DomainException.MISSED_REFERENCE_INS_ERROR

getIDtipo

private long getIDtipo(java.lang.String statement,
                       java.lang.String tipo,
                       MovimentazioneFinanziaria.Natura natura)
                throws DatabaseException
Recupera l'ID che identifica la tupla in cui è memorizzato il tipo di una movimentazione finanziaria.

Parameters:
statement - lo statement SQL per il recupero dell'ID.
tipo - il nome del tipo di movimentazione finanziaria.
natura - il valore dell'enumerazione MovimentazioneFinanziaria.Natura che indica la natura del tipo di movimentazione.
Returns:
l'ID della tupla in cui è memorizzato il tipo di entrata (natura = MovimentazioneFinanziaria.Natura.ENTRATA) o di uscita (natura = MovimentazioneFinanziaria.Natura.USCITA) con nome tipo.
Throws:
DatabaseException - nel caso si verifichino errori nel recupero dell'ID.

getIDcontroparte

private long getIDcontroparte(java.lang.String statement,
                              java.lang.String controparte)
                       throws DatabaseException
Recupera l'ID che identifica la tupla in cui è memorizzata la controparte di una movimentazione finanziaria.

Parameters:
statement - lo statement SQL per il recupero dell'ID.
controparte - il nome della controparte della movimentazione finanziaria.
Returns:
l'ID della tupla in cui è memorizzata la controparte con nome controparte.
Throws:
DatabaseException - nel caso si verifichino errori nel recupero dell'ID.

getIDutente

private long getIDutente(java.lang.String statement,
                         java.lang.String username)
                  throws DatabaseException
Recupera l'ID che identifica la tupla in cui sono memorizzati i dati dell'utente identificato dallo username passato come parametro.

Parameters:
statement - lo statement SQL per il recupero dell'ID.
username - lo username dell'utente di riferimento.
Returns:
l'ID della tupla in cui sono memorizzati i dati dell'utente con username username.
Throws:
DatabaseException - nel caso si verifichino errori nel recupero dell'ID.

getElencoTipi

public java.lang.String[] getElencoTipi(MovimentazioneFinanziaria.Natura natura)
                                 throws DatabaseException
Recupera dal database i nomi dei tipi di movimentazione finanziaria aventi come natura quella indicata nel parametro

Parameters:
natura - il valore dell'enumerazione MovimentazioneFinanziaria.Natura che indica la natura dei tipi di movimentazione da recuperare.
Returns:
l'array di stringhe che rappresentano i tipi di entrata (natura = MovimentazioneFinanziaria.Natura.ENTRATA) o di uscita (natura = MovimentazioneFinanziaria.Natura.USCITA).
Throws:
DatabaseException - nel caso si verifichino errori nel recupero dei tipi.