ssbm.domain
Interface BusinessDelegate

All Known Implementing Classes:
BusinessDelegate4Client, BusinessDelegate4Server

public interface BusinessDelegate

Quest’interfaccia definisce la firma dei metodi che devono essere implementati dalla classe che rappresenta il punto di accesso ai servizi del dominio.
I metodi consentono l'esecuzione dei servizi esposti dall'applicazione e il recupero degli eventuali risultati prodotti.

Author:
Salvatore Piccione

Method Summary
 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.
 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.
 

Method Detail

executeService

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

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.

executeService

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

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

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

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

DataContainer getDataContainer()
Restituisce l'istanza di DataContainer contenente i dati ottenuti dall'esecuzione dell'ultimo servizio richiesto.

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

DataContainersList getDataContainersList()
Restituisce l'istanza di DataContainersList contenente i dati ottenuti dall'esecuzione dell'ultimo servizio richiesto.

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

void executeSecurityCheck(java.lang.String username,
                          java.lang.String netAddress)
                          throws DomainException,
                                 SSBMSecurityException,
                                 DatabaseException
Controlla la validità delle provenienza di una richiesta di esecuzione di un servizio.

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.

executeSecurityCheck

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

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.