ssbm.db.mapping
Class UtenteMapper

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

public class UtenteMapper
extends DataMapper

Questa classe gestisce il data mapping tra l’entitเ Utente 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
UtenteMapper()
          Costruisce un'istanza connessa al database dell'applicazione.
 
Method Summary
 boolean checkExistance(Utente user)
          Controlla che esista una tupla contenente lo username e l'indirizzo IP riportati nell'istanza di Utente passata come parametro.
 int delete(java.lang.String username)
          Elimina la tupla contenente i dati dell'utente identificato dallo username passato come parametro.
 Utente get(java.lang.String username)
          Recupera la password e l'ID della tupla in cui sono memorizzati i dati dell'utente identificato dallo username passato come parametro.
 Utente get4login(java.lang.String username, java.lang.String password)
          Recupera l'indirizzo IP dell'utente identificato dallo username e dalla password passati come parametri.
 int insert(Utente user)
          Inserisce nel database i dati riportati nell'istanza di Utente passata come parametro.
 int update(Utente user)
          Aggiorna i dati di un utente.
 int update4login(java.lang.String username, java.lang.String netAddress)
          Imposta l'indirizzo IP dal quale ่ connesso l'utente che ha richiesto il login.
 int update4logout(java.lang.String username)
          Imposta a null l'indirizzo IP dal quale ่ connesso l'utente identificato dallo username passato 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

UtenteMapper

public UtenteMapper()
             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 Utente get(java.lang.String username)
           throws DatabaseException
Recupera la password e l'ID della tupla in cui sono memorizzati i dati dell'utente identificato dallo username passato come parametro.

Parameters:
username - lo username che identifica l'utente per il quale recuperare le credenziali di accesso.
Returns:
l'istanza di Utente contenente username, password e ID della tupla oppure null se username non ่ lo username di un utente registrato.
Throws:
DatabaseException - nel caso si verifichino errori nel recupero dei dati.

get4login

public Utente get4login(java.lang.String username,
                        java.lang.String password)
                 throws DatabaseException
Recupera l'indirizzo IP dell'utente identificato dallo username e dalla password passati come parametri.

Parameters:
username - lo username dell'utente per il quale recuperare l'indirizzo IP dal quale ่ connesso.
password - la password dell'utente per il quale recuperare l'indirizzo IP dal quale ่ connesso.
Returns:
l'istanza di Utente contenente username, password ed indirizzo IP se username e password sono delle credenziali di accesso valide, altrimenti null.
Throws:
DatabaseException - nel caso si verifichino errori nel recupero dei dati.

update4logout

public int update4logout(java.lang.String username)
                  throws DatabaseException
Imposta a null l'indirizzo IP dal quale ่ connesso l'utente identificato dallo username passato come parametro.

Parameters:
username - lo username dell'utente che ha richiesto il logout.
Returns:
il numero di tuple del database che sono state aggiornate.
Throws:
DatabaseException - nel caso si verifichino problemi nell'aggiornamento dei dati.

update4login

public int update4login(java.lang.String username,
                        java.lang.String netAddress)
                 throws DatabaseException
Imposta l'indirizzo IP dal quale ่ connesso l'utente che ha richiesto il login.
L'utente ่ identificato dallo username passato come parametro,

Parameters:
username - lo username dell'utente che ha richiesto il login.
netAddress - l'indirizzo IP dal quale ่ connesso l'utente.
Returns:
il numero di tuple aggiornate.
Throws:
DatabaseException - nel caso si verifichino errori nell'aggiornamento dei dati.

update

public int update(Utente user)
           throws DatabaseException,
                  DomainException
Aggiorna i dati di un utente.
La tupla da aggiornare ่ identificata dall'ID riportato nell'istanza di Utente passata come parametro.

Parameters:
user - l'istanza di Utente contenente i dati aggiornati e l'ID che identifica la tupla da aggiornare.
Returns:
il numero di tuple aggiornate.
Throws:
DatabaseException - nel caso in cui si verifichino errori nell'aggiornamento dei dati.
DomainException - se lo username riportato in user ่ memorizzato in un'altra tupla.
See Also:
DomainException.DUPLICATED_DATA_INS_ERROR

insert

public int insert(Utente user)
           throws DatabaseException,
                  DomainException
Inserisce nel database i dati riportati nell'istanza di Utente passata come parametro.

Parameters:
user - l'istanza di Utente contenente i dati da inserire.
Returns:
il numero di tuple inserite.
Throws:
DatabaseException - nel caso in cui si verifichino errori nell'inserimento dei dati.
DomainException - se lo username riportato in user ่ memorizzato in un'altra tupla.
See Also:
DomainException.DUPLICATED_DATA_INS_ERROR

delete

public int delete(java.lang.String username)
           throws DatabaseException
Elimina la tupla contenente i dati dell'utente identificato dallo username passato come parametro.

Parameters:
username - lo username dell'utente da eliminare.
Returns:
il numero di tuple eliminate.
Throws:
DatabaseException - nel caso in cui si verifichino problemi nell'eliminazione dei dati.

checkExistance

public boolean checkExistance(Utente user)
                       throws DatabaseException
Controlla che esista una tupla contenente lo username e l'indirizzo IP riportati nell'istanza di Utente passata come parametro.

Parameters:
user - l'istanza di Utente contenente i dati da utilizzare per il controllo.
Returns:
true se esiste una tupla con lo username e l'indirizzo IP riportati in user, false altrimenti.
Throws:
DatabaseException - nel caso in cui si verifichino problemi nell'esecuzione del controllo.