ssbm.domain
Class BusinessDelegate4Server

java.lang.Object
  extended by ssbm.domain.BusinessDelegate4Server
All Implemented Interfaces:
BusinessDelegate

public class BusinessDelegate4Server
extends java.lang.Object
implements BusinessDelegate

Questa classe implementa l’interfaccia BusinessDelegate secondo la logica del lato server dell’applicazione.
L'implementazione consiste nell’invocare i metodi del gestori del servizio richiesto. I metodi che restituiscono i risultati dei servizi restituiscono gli oggetti ottenuti direttamente dall’esecuzione dei servizi.

Author:
Salvatore Piccione

Field Summary
private  DataContainer dataTable
          L'istanza di DataContainer contenente i dati ottenuti dall'esecuzione dell'ultimo servizio richiesto.
private  DataContainersList dataTablesList
          L'istanza di DataContainersList contenente i dati ottenuti dall'esecuzione dell'ultimo servizio richiesto.
private  Entities entity
          Il valore dell'enumerazione Entities che indica il nome dell'entità a cui si riferisce l'ultimo servizio d'uso richiesto.
private  Services service
          Il valore dell'enumerazione Services che indica il nome dell'ultimo servizio richiesto.
 
Constructor Summary
BusinessDelegate4Server()
          Costruisce un'istanza vuota.
 
Method Summary
private  void executeDeleteService(DataContainer dataTable)
          Esegue il servizio di eliminazione dati utilizzando come identificativo del dato da eliminare quello riportato nell'istanza di DataContainer passata come parametro.
private  void executeGetService(DataContainer dataTable)
          Esegue il servizio di recupero dati utilizzando come parametri per la selezione dei dati da recuperare quelli riportati nell'istanza di DataContainer passata come parametro.
private  void executeInsertService(DataContainer dataTable)
          Esegue il servizio di memorizzazione dati utilizzando come data da inserire quelli riportati nell'istanza di DataContainer passata come parametro.
 void executeSecurityCheck(DataContainer dataTable, java.lang.String netAddress)
          Controlla la validità delle provenienza di una richiesta di esecuzione di un servizio.
 void executeSecurityCheck(java.lang.String username, java.lang.String netAddress)
          Controlla la validità delle provenienza di una richiesta di esecuzione di un servizio.
 void executeService(DataContainer dataTable, Services service)
          Esegue un servizio di autenticazione utilizzando i dati riportati nell'istanza di DataContainer passata come parametro.
 void executeService(DataContainer dataTable, Services service, Entities entity)
          Esegue un servizio d'uso relativo ad una specifica entità ed utilizzando i dati riportati nell'istanza di DataContainer passata come parametro.
 void executeService(DataContainersList dataTablesList, Services service, Entities entity)
          Esegue un servizio d'uso relativo ad una specifica entità ed utilizzando i dati riportati nell'istanza di DataContainersList passata come parametro.
private  void executeUpdateService(DataContainer dataTable)
          Esegue il servizio di aggiornamento dati utilizzando come dati aggiornati quelli riportati nell'istanza di DataContainer passata come parametro.
 DataContainer getDataContainer()
          Restituisce l'istanza di DataContainer contenente i dati ottenuti dall'esecuzione dell'ultimo servizio richiesto.
 DataContainersList getDataContainersList()
          Restituisce l'istanza di DataContainersList contenente i dati ottenuti dall'esecuzione dell'ultimo servizio richiesto.
private  void reset()
          Imposta a null i campi d'esemplare che memorizzano il risultato dell'esecuzione dell'ultimo servizio e il nome dell'entità di riferimento.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

dataTable

private DataContainer dataTable
L'istanza di DataContainer contenente i dati ottenuti dall'esecuzione dell'ultimo servizio richiesto.


dataTablesList

private DataContainersList dataTablesList
L'istanza di DataContainersList contenente i dati ottenuti dall'esecuzione dell'ultimo servizio richiesto.


service

private Services service
Il valore dell'enumerazione Services che indica il nome dell'ultimo servizio richiesto.


entity

private Entities entity
Il valore dell'enumerazione Entities che indica il nome dell'entità a cui si riferisce l'ultimo servizio d'uso richiesto.

Constructor Detail

BusinessDelegate4Server

public BusinessDelegate4Server()
Costruisce un'istanza vuota.

Method Detail

reset

private void reset()
Imposta a null i campi d'esemplare che memorizzano il risultato dell'esecuzione dell'ultimo servizio e il nome dell'entità di riferimento.


executeService

public void executeService(DataContainer dataTable,
                           Services service,
                           Entities entity)
                    throws java.lang.Exception
Description copied from interface: BusinessDelegate
Esegue un servizio d'uso relativo ad una specifica entità ed utilizzando i dati riportati nell'istanza di DataContainer passata come parametro.

Specified by:
executeService in interface BusinessDelegate
Parameters:
dataTable - l'istanza di DataContainer contenente i dati da utilizzare nell'esecuzione del servizio richiesto.
service - il valore dell'enumerazione Services che indica il servizio richiesto.
entity - il valore dell'enumerazione Entities che indica l'entità di riferimento.
Throws:
java.lang.Exception - se si verifica un problema nell'esecuzione del servizio.

executeGetService

private void executeGetService(DataContainer dataTable)
                        throws DatabaseException
Esegue il servizio di recupero dati utilizzando come parametri per la selezione dei dati da recuperare quelli riportati nell'istanza di DataContainer passata come parametro.

Parameters:
dataTable - l'istanza di DataContainer contenente i parametri per la selezione dai dati da recuperare.
Throws:
DatabaseException - se si verificano degli errori nella comunicazione con il database.

executeUpdateService

private void executeUpdateService(DataContainer dataTable)
                           throws DatabaseException,
                                  DomainException,
                                  java.lang.IllegalArgumentException
Esegue il servizio di aggiornamento dati utilizzando come dati aggiornati quelli riportati nell'istanza di DataContainer passata come parametro.

Parameters:
dataTable - l'istanza di DataContainer contenente i dati aggiornati e l'ID che identifica la tupla contenente i dati da aggiornare.
Throws:
DatabaseException - se si verificano degli errori nella comunicazione con il database.
DomainException - se si verificano degli errori nell'implementazione della logica di dominio.
java.lang.IllegalArgumentException - se l'aggiornamento riguarda un bilancio.

executeDeleteService

private void executeDeleteService(DataContainer dataTable)
                           throws DatabaseException,
                                  DomainException,
                                  java.lang.IllegalArgumentException
Esegue il servizio di eliminazione dati utilizzando come identificativo del dato da eliminare quello riportato nell'istanza di DataContainer passata come parametro.

Parameters:
dataTable - l'istanza di DataContainer contenente l'identificativo del dato da eliminare.
Throws:
DatabaseException - se si verificano degli errori nella comunicazione con il database.
DomainException - se si verificano degli errori nell'implementazione della logica di dominio.
java.lang.IllegalArgumentException - se l'eliminazione non riguarda un utente.

executeInsertService

private void executeInsertService(DataContainer dataTable)
                           throws DomainException,
                                  DatabaseException,
                                  java.lang.IllegalArgumentException
Esegue il servizio di memorizzazione dati utilizzando come data da inserire quelli riportati nell'istanza di DataContainer passata come parametro.

Parameters:
dataTable - l'istanza di DataContainer contenente i dati da storicizzare
Throws:
DomainException - se si verificano degli errori nell'implementazione della logica di dominio.
DatabaseException - se si verificano degli errori nella comunicazione con il database.
java.lang.IllegalArgumentException - se l'inserimento riguarda un bilancio.

executeService

public void executeService(DataContainer dataTable,
                           Services service)
                    throws java.lang.Exception
Description copied from interface: BusinessDelegate
Esegue un servizio di autenticazione utilizzando i dati riportati nell'istanza di DataContainer passata come parametro.

Specified by:
executeService in interface BusinessDelegate
Parameters:
dataTable - l'istanza di DataContainer contenente i dati da utilizzare nell'esecuzione del servizio richiesto.
service - il valore dell'enumerazione Services che indica il servizio richiesto.
Throws:
java.lang.Exception - se si verifica un problema nell'esecuzione del servizio.

executeService

public void executeService(DataContainersList dataTablesList,
                           Services service,
                           Entities entity)
                    throws java.lang.Exception
Description copied from interface: BusinessDelegate
Esegue un servizio d'uso relativo ad una specifica entità ed utilizzando i dati riportati nell'istanza di DataContainersList passata come parametro.

Specified by:
executeService in interface BusinessDelegate
Parameters:
dataTablesList - l'istanza di DataContainersList contenente i dati da utilizzare nell'esecuzione del servizio richiesto.
service - il valore dell'enumerazione Services che indica il servizio richiesto.
entity - il valore dell'enumerazione Entities che indica l'entità di riferimento.
Throws:
java.lang.Exception - se si verifica un problema nell'esecuzione del servizio.

getDataContainer

public DataContainer getDataContainer()
Description copied from interface: BusinessDelegate
Restituisce l'istanza di DataContainer contenente i dati ottenuti dall'esecuzione dell'ultimo servizio richiesto.

Specified by:
getDataContainer in interface BusinessDelegate
Returns:
l'istanza di DataContainer contenente i dati ottenuti dall'esecuzione dell'ultimo servizio oppure null se non è stato richiesto alcun servizio o l’ultimo servizio richiesto non ha prodotto un'istanza di DataContainer.

getDataContainersList

public DataContainersList getDataContainersList()
Description copied from interface: BusinessDelegate
Restituisce l'istanza di DataContainersList contenente i dati ottenuti dall'esecuzione dell'ultimo servizio richiesto.

Specified by:
getDataContainersList in interface BusinessDelegate
Returns:
l'istanza di DataContainersList contenente i dati ottenuti dall'esecuzione dell'ultimo servizio oppure null se non è stato richiesto alcun servizio o l’ultimo servizio richiesto non ha prodotto un'istanza di DataContainersList.

executeSecurityCheck

public void executeSecurityCheck(DataContainer dataTable,
                                 java.lang.String netAddress)
                          throws DomainException,
                                 DatabaseException,
                                 SSBMSecurityException
Description copied from interface: BusinessDelegate
Controlla la validità delle provenienza di una richiesta di esecuzione di un servizio.

Specified by:
executeSecurityCheck in interface BusinessDelegate
Parameters:
dataTable - il dizionario di dati contenente i dati necessari alla costruzione di un'istanza di Utente che rappresenta l'utente che richiede un servizio.
netAddress - l'indirizzo IP dal quale proviene le richiesta di esecuzione di un servizio.
Throws:
DomainException - se dataTable non contiene un indirizzo di rete valido.
DatabaseException - se si verificano degli errori nella connessione al database.
SSBMSecurityException - se la richiesta proviene da un indirizzo IP diverso da quello dal quale l'utente è stato autenticato.

executeSecurityCheck

public void executeSecurityCheck(java.lang.String username,
                                 java.lang.String netAddress)
                          throws DomainException,
                                 SSBMSecurityException,
                                 DatabaseException
Description copied from interface: BusinessDelegate
Controlla la validità delle provenienza di una richiesta di esecuzione di un servizio.

Specified by:
executeSecurityCheck in interface BusinessDelegate
Parameters:
username - lo username dell'utente che richiede l'esecuzione di un servizio.
netAddress - l'indirizzo IP dal quale proviene le richiesta di esecuzione di un servizio.
Throws:
DomainException - se requestAddress non è un indirizzo di rete valido.
SSBMSecurityException - se la richiesta proviene da un indirizzo IP diverso da quello dal quale l'utente è stato autenticato.
DatabaseException - se si verificano degli errori nella connessione al database.