ssbm.commons.exception
Class NetException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by ssbm.commons.exception.NetException
All Implemented Interfaces:
java.io.Serializable

public class NetException
extends java.lang.Exception

Questa classe rappresenta un errore verificatosi nel livello di comunicazione di rete.
È lanciata se si riscontra un errore nella comunicazione client/server o nella costruzione ed analisi dei messaggi di testo scambiati tra client e server.

Author:
Salvatore Piccione
See Also:
Serialized Form

Field Summary
private  java.lang.String details
          Stringa contenente i dettagli dell'eccezione.
static int EXPECTED_DATA
          Codice che identifica l'errore generato dall'assenza di dati da inviare.
static int MALFORMED_MESSAGE
          Codice che identifica l'errore generato da un messaggio di testo non avente la struttura attesa.
private static java.util.Map<java.lang.Integer,java.lang.String> MESSAGES_TABLE
          Dizionario che memorizza le associazioni codice errore - messaggio esplicativo.
private static java.lang.String PLACEHOLDER
          Segnaposto del messaggio esplicativo di un errore.
private static java.lang.String PREFIX
          Prefisso dei messaggi esplicativi.
static int READ_ERROR
          Codice che identifica l'errore generato durante la lettura da un canale socket.
private static long serialVersionUID
           
static int UNEXPECTED_RESULT_CODE
          Codice che identifica l'errore generato da un codice dell'esito inaspettato.
static int WRITE_ERROR
          Codice che identifica l'errore generato durante la scrittura su un canale socket.
static int WRONG_RESULT_CODE
          Codice che identifica l'errore generato dall'uso di un codice errato per comunicare dell'esito di un servizio.
static int WRONG_RESULT_NAME
          Codice che identifica l'errore generato dal nome errato dell'esito di un servizio.
static int WRONG_SERVICE_CODE
          Codice che identifica l'errore generato dall'uso di un codice errato per richiedere l'esecuzione di un servizio.
static int WRONG_SERVICE_NAME
          Codice che identifica l'errore generato dall'uso di un nome errato per richiedere l'esecuzione di un servizio.
 
Constructor Summary
NetException()
          Costruisce un'eccezione priva di messaggio esplicativo.
NetException(int code)
          Costruisce un'eccezione avente come messaggio esplicativo quello associato all'errore identificato dal codice specificato.
NetException(int code, java.lang.String parameter)
          Costruisce un'eccezione avente come messaggio esplicativo quello associato al codice di errore specificato.
NetException(int code, java.lang.String parameter, java.lang.Throwable cause)
          Costruisce un'eccezione avente un messaggio esplicativo ed una causa.
NetException(int code, java.lang.Throwable cause)
          Costruisce un'eccezione avente un messaggio esplicativo ed una causa.
NetException(java.lang.String message)
          Costruisce un'eccezione con un messaggio esplicativo.
NetException(java.lang.String message, java.lang.Throwable cause)
          Costruisce un'eccezione con un messaggio esplicativo e la causa.
 
Method Summary
 java.lang.String getMessage()
          Restituisce il messaggio esplicativo dell'eccezione e gli eventuali dettagli.
private static java.util.Map<java.lang.Integer,java.lang.String> initializeTable()
          Inizializza il campo statico MESSAGES_TABLE.
 void setDetails(java.lang.String details)
          Imposta i dettagli dell'eccezione.
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

details

private java.lang.String details
Stringa contenente i dettagli dell'eccezione.


WRONG_RESULT_CODE

public static final int WRONG_RESULT_CODE
Codice che identifica l'errore generato dall'uso di un codice errato per comunicare dell'esito di un servizio.
Per questo tipo di errore è necessario specificare il codice sbagliato.

See Also:
Constant Field Values

EXPECTED_DATA

public static final int EXPECTED_DATA
Codice che identifica l'errore generato dall'assenza di dati da inviare.

See Also:
Constant Field Values

WRONG_SERVICE_CODE

public static final int WRONG_SERVICE_CODE
Codice che identifica l'errore generato dall'uso di un codice errato per richiedere l'esecuzione di un servizio.
Per questo tipo di errore è necessario specificare il codice sbagliato.

See Also:
Constant Field Values

WRONG_SERVICE_NAME

public static final int WRONG_SERVICE_NAME
Codice che identifica l'errore generato dall'uso di un nome errato per richiedere l'esecuzione di un servizio.
Per questo tipo di errore è necessario specificare il nome sbagliato.

See Also:
Constant Field Values

MALFORMED_MESSAGE

public static final int MALFORMED_MESSAGE
Codice che identifica l'errore generato da un messaggio di testo non avente la struttura attesa.
Per questo tipo di errore è necessario specificare l'host che ha inviato il messaggio.

See Also:
Constant Field Values

READ_ERROR

public static final int READ_ERROR
Codice che identifica l'errore generato durante la lettura da un canale socket.
Per questo tipo di errore è necessario specificare l'host che ha scritto i dati da leggere.

See Also:
Constant Field Values

WRITE_ERROR

public static final int WRITE_ERROR
Codice che identifica l'errore generato durante la scrittura su un canale socket.
Per questo tipo di errore è necessario specificare l'host che utilizza in canale in scrittura.

See Also:
Constant Field Values

WRONG_RESULT_NAME

public static final int WRONG_RESULT_NAME
Codice che identifica l'errore generato dal nome errato dell'esito di un servizio.
Per questo tipo di errore è necessario specificare il nome dell'esito che risulta essere errato.

See Also:
Constant Field Values

UNEXPECTED_RESULT_CODE

public static final int UNEXPECTED_RESULT_CODE
Codice che identifica l'errore generato da un codice dell'esito inaspettato.
Per questo tipo di errore è necessario specificare il codice ricevuto e il codice atteso nel seguente modo: "codice_ricevuto codice atteso: codice_atteso".

See Also:
Constant Field Values

MESSAGES_TABLE

private static final java.util.Map<java.lang.Integer,java.lang.String> MESSAGES_TABLE
Dizionario che memorizza le associazioni codice errore - messaggio esplicativo.


PLACEHOLDER

private static final java.lang.String PLACEHOLDER
Segnaposto del messaggio esplicativo di un errore.

See Also:
Constant Field Values

PREFIX

private static final java.lang.String PREFIX
Prefisso dei messaggi esplicativi.

See Also:
Constant Field Values

serialVersionUID

private static final long serialVersionUID
See Also:
Constant Field Values
Constructor Detail

NetException

public NetException()
Costruisce un'eccezione priva di messaggio esplicativo.


NetException

public NetException(java.lang.String message)
Costruisce un'eccezione con un messaggio esplicativo.

Parameters:
message - il messaggio esplicativo

NetException

public NetException(java.lang.String message,
                    java.lang.Throwable cause)
Costruisce un'eccezione con un messaggio esplicativo e la causa.

Parameters:
message - il messaggio esplicativo.
cause - la causa dell'eccezione.

NetException

public NetException(int code,
                    java.lang.String parameter)
Costruisce un'eccezione avente come messaggio esplicativo quello associato al codice di errore specificato. Tale messaggio è personalizzato con il testo passato come parametro.

Parameters:
code - il codice dell'errore.
parameter - il testo che sostituisce il segnaposto del messaggio.

NetException

public NetException(int code,
                    java.lang.String parameter,
                    java.lang.Throwable cause)
Costruisce un'eccezione avente un messaggio esplicativo ed una causa.
Il messaggio esplicativo è quello associato all'errore identificato dal codice specificato. Tale messaggio è personalizzato con il testo passato come parametro.

Parameters:
code - il codice dell'errore.
parameter - il testo che sostituisce il segnaposto del messaggio.
cause - la causa dell'eccezione.

NetException

public NetException(int code)
Costruisce un'eccezione avente come messaggio esplicativo quello associato all'errore identificato dal codice specificato.

Parameters:
code - il codice dell'errore.

NetException

public NetException(int code,
                    java.lang.Throwable cause)
Costruisce un'eccezione avente un messaggio esplicativo ed una causa.
Il messaggio esplicativo è quello associato all'errore identificato dal codice specificato.

Parameters:
code - il codice dell'errore.
cause - la causa dell'eccezione.
Method Detail

getMessage

public java.lang.String getMessage()
Restituisce il messaggio esplicativo dell'eccezione e gli eventuali dettagli.

Overrides:
getMessage in class java.lang.Throwable
Returns:
il messaggio esplicativo dell'eccezione con gli eventuali dettagli.

setDetails

public void setDetails(java.lang.String details)
Imposta i dettagli dell'eccezione.

Parameters:
details - i dettagli.

initializeTable

private static java.util.Map<java.lang.Integer,java.lang.String> initializeTable()
Inizializza il campo statico MESSAGES_TABLE.

Returns:
un dizionario sincronizzato contenente il codice dell'errore e il messaggio ad esso associato.