Package overit.geocall.io.tracer

Class AbstractIOLogTracer

java.lang.Object

overit.geocall.io.tracer.AbstractIOLogTracer

All Implemented Interfaces:

IOLogTracer, Identified

Direct Known Subclasses:

DBLogTracer, FileLogTracer

public abstract class AbstractIOLogTracer
extends Object
implements IOLogTracer

Field Summary

Fields

Modifier and Type	Field	Description
protected boolean	_client
protected List<IOLogFilter>	_filters
protected Identity	_identity
protected IOLogProfiler	_profiler
protected String	_service
protected Streamer	_streamer

Fields inherited from interface overit.geocall.io.tracer.IOLogTracer

STATUS_COMPLETE, STATUS_ERROR, STATUS_REQUEST

Constructor Summary

Constructors

Constructor	Description
AbstractIOLogTracer(IOLogProfiler profiler, String service, boolean client)

Method Summary

Modifier and Type	Method	Description
void	addFilter(IOLogFilter filter)	Aggiunge un filtro che verrà eseguito prima del salvataggio dei log di input/output/error.
protected <T> T	doFilter(T message, int phase)	Applica i filtri al messaggio passato come parametro, ritornando l'istanza del messaggio modificato
Identity	getIdentity()	Returns the Identity associated to the component
protected abstract boolean	isLogActive()	Check whether the log should be traced or not
protected void	logError(Object error)	Registra il contenuto della risposta nel caso la richiesta non abbia avuto successo.
protected void	logInput(Object input)	Registra il contenuto della richiesta.
protected void	logOutput(Object output)	Registra il contenuto della risposta nel caso la richiesta abbia avuto successo.
void	onError(Object error)	Metodo di utilità che semplifica le operazioni di setup e scrittura dell'errore sul file di log.
void	onError(Object error, Date registrationTime)	Metodo di utilità che semplifica le operazioni di setup e scrittura dell'errore sul file di log.
void	onInput(String serviceName, String serviceUrl, Object input)	Metodo di utilità che semplifica le operazioni di setup e scrittura dell'input sul file di log.
void	onInput(String serviceName, String serviceUrl, Object input, Date registrationTime)	Metodo di utilità che semplifica le operazioni di setup e scrittura dell'input sul file di log.
void	onInput(String serviceName, String serviceUrl, String headers, Object input, Date registrationTime)	Metodo di utilità che semplifica le operazioni di setup e scrittura dell'input sul file di log.
void	onOutput(Object output)	Metodo di utilità che semplifica le operazioni di setup e scrittura dell'output sul file di log.
void	onOutput(Object output, Date registrationTime)	Metodo di utilità che semplifica le operazioni di setup e scrittura dell'output sul file di log.
void	onOutput(Object output, Date registrationTime, String headers)	Metodo di utilità che semplifica le operazioni di setup e scrittura dell'output sul file di log.
void	removeFilter(IOLogFilter filter)	Rimuove un determinato filtro, evitando che questo contribuisca alla modifica del messaggio prima del logging
void	setIdentity(Identity identity)	Sets the Identity to the component

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface overit.geocall.io.tracer.IOLogTracer

completed, flush, getOutputStreamError, getOutputStreamInput, getOutputStreamOutput, getReference, onResult, save, setDuration, setEnd, setInputAttachments, setMethod, setOutputAttachments, setRequestHeaders, setResponseHeaders, setService, setStart, setStatus, setStatusCode

Field Details

_streamer

protected Streamer _streamer

_service

protected String _service

_client

protected boolean _client

_profiler

protected IOLogProfiler _profiler

_filters

protected List<IOLogFilter> _filters

_identity

protected Identity _identity

Constructor Details

AbstractIOLogTracer

public AbstractIOLogTracer(IOLogProfiler profiler,
 String service,
 boolean client)

Method Details

onInput

public void onInput(String serviceName,
 String serviceUrl,
 Object input)

Description copied from interface: IOLogTracer

Metodo di utilità che semplifica le operazioni di setup e scrittura dell'input sul file di log.

Specified by:

onInput in interface IOLogTracer

Parameters:

serviceName - nome del servizio, utilizzato per il setup delle directory

serviceUrl - url del servizio inserito all'interno del masterfile

input - vengono gestite istanze di oggetti appartenenti alle seguenti classi: XMLTree, SOAPMessage, JsonElement e

invalid reference

byte[]

, Throwable. Per tutte le altre classi l'input verrà serializzato attraverso il serializzatore JackMapper.

onInput

public void onInput(String serviceName,
 String serviceUrl,
 Object input,
 Date registrationTime)

Description copied from interface: IOLogTracer

Metodo di utilità che semplifica le operazioni di setup e scrittura dell'input sul file di log.

Specified by:

onInput in interface IOLogTracer

Parameters:

serviceName - nome del servizio, utilizzato per il setup delle directory

serviceUrl - url del servizio inserito all'interno del masterfile

input - vengono gestite istanze di oggetti appartenenti alle seguenti classi: XMLTree, SOAPMessage, JsonElement e

invalid reference

byte[]

, Throwable. Per tutte le altre classi l'input verrà serializzato attraverso il serializzatore JackMapper.

registrationTime - istante di registrazione del log.

onInput

public void onInput(String serviceName,
 String serviceUrl,
 String headers,
 Object input,
 Date registrationTime)

Description copied from interface: IOLogTracer

Metodo di utilità che semplifica le operazioni di setup e scrittura dell'input sul file di log.

Specified by:

onInput in interface IOLogTracer

Parameters:

serviceName - nome del servizio, utilizzato per il setup delle directory

serviceUrl - url del servizio inserito all'interno del masterfile

headers - headers della risposta della richiesta.

input - vengono gestite istanze di oggetti appartenenti alle seguenti classi: XMLTree, SOAPMessage, JsonElement e

invalid reference

byte[]

, Throwable. Per tutte le altre classi l'input verrà serializzato attraverso il serializzatore JackMapper.

registrationTime - istante di registrazione del log.

onOutput

public void onOutput(Object output)

Description copied from interface: IOLogTracer

Metodo di utilità che semplifica le operazioni di setup e scrittura dell'output sul file di log.

Specified by:

onOutput in interface IOLogTracer

Parameters:

output - vengono gestite istanze di oggetti appartenenti alle seguenti classi: XMLTree, SOAPMessage, JsonElement e

invalid reference

byte[]

, Throwable. Per tutte le altre classi l'output verrà serializzato attraverso il serializzatore JackMapper.

onOutput

public void onOutput(Object output,
 Date registrationTime)

Description copied from interface: IOLogTracer

Metodo di utilità che semplifica le operazioni di setup e scrittura dell'output sul file di log.

Specified by:

onOutput in interface IOLogTracer

Parameters:

output - vengono gestite istanze di oggetti appartenenti alle seguenti classi: XMLTree, SOAPMessage, JsonElement e

invalid reference

byte[]

, Throwable. Per tutte le altre classi l'output verrà serializzato attraverso il serializzatore JackMapper.

registrationTime - istante di registrazione del log.

onOutput

public void onOutput(Object output,
 Date registrationTime,
 String headers)

Description copied from interface: IOLogTracer

Metodo di utilità che semplifica le operazioni di setup e scrittura dell'output sul file di log.

Specified by:

onOutput in interface IOLogTracer

Parameters:

output - vengono gestite istanze di oggetti appartenenti alle seguenti classi: XMLTree, SOAPMessage, JsonElement e

invalid reference

byte[]

, Throwable. Per tutte le altre classi l'output verrà serializzato attraverso il serializzatore JackMapper.

registrationTime - istante di registrazione del log.

headers - headers della risposta.

onError

public void onError(Object error)

Description copied from interface: IOLogTracer

Metodo di utilità che semplifica le operazioni di setup e scrittura dell'errore sul file di log.

Specified by:

onError in interface IOLogTracer

Parameters:

error - vengono gestite istanze di oggetti appartenenti alle seguenti classi: XMLTree, SOAPMessage, JsonElement e

invalid reference

byte[]

, Throwable. Per tutte le altre classi l'errore verrà serializzato attraverso il serializzatore JackMapper.

onError

public void onError(Object error,
 Date registrationTime)

Description copied from interface: IOLogTracer

Metodo di utilità che semplifica le operazioni di setup e scrittura dell'errore sul file di log.

Specified by:

onError in interface IOLogTracer

Parameters:

error - vengono gestite istanze di oggetti appartenenti alle seguenti classi: XMLTree, SOAPMessage, JsonElement e

invalid reference

byte[]

, Throwable. Per tutte le altre classi l'errore verrà serializzato attraverso il serializzatore JackMapper.

registrationTime - istante di registrazione del log.

addFilter

public void addFilter(IOLogFilter filter)

Description copied from interface: IOLogTracer

Aggiunge un filtro che verrà eseguito prima del salvataggio dei log di input/output/error.

Specified by:

addFilter in interface IOLogTracer

Parameters:

filter - Il filtro da aggiungere

removeFilter

public void removeFilter(IOLogFilter filter)

Description copied from interface: IOLogTracer

Rimuove un determinato filtro, evitando che questo contribuisca alla modifica del messaggio prima del logging

Specified by:

removeFilter in interface IOLogTracer

Parameters:

filter - Il filtro da rimuovere

logInput

protected void logInput(Object input)

Registra il contenuto della richiesta.

Parameters:

input - vengono gestite istanze di oggetti appartenenti alle seguenti classi:

• XMLTree
• SOAPMessage
• JsonElement
• invalid reference

  byte[]

• Throwable

Per tutte le altre classi l'input verrà serializzato attraverso il serializzatore JackMapper

logOutput

protected void logOutput(Object output)

Registra il contenuto della risposta nel caso la richiesta abbia avuto successo.

Parameters:

output - vengono gestite istanze di oggetti appartenenti alle seguenti classi:

• XMLTree
• SOAPMessage
• JsonElement
• invalid reference

  byte[]

• Throwable

Per tutte le altre classi l'output verrà serializzato attraverso il serializzatore JackMapper

logError

protected void logError(Object error)

Registra il contenuto della risposta nel caso la richiesta non abbia avuto successo.

Parameters:

error - vengono gestite istanze di oggetti appartenenti alle seguenti classi:

• XMLTree
• SOAPMessage
• JsonElement
• invalid reference

  byte[]

• Throwable

Per tutte le altre classi l'errore verrà serializzato attraverso il serializzatore JackMapper

doFilter

protected <T> T doFilter(T message,
 int phase)

Applica i filtri al messaggio passato come parametro, ritornando l'istanza del messaggio modificato

Type Parameters:

T - tipo generico del messaggio. Il tipo di instanza di input deve forzatamente corrispondere al tipo di instanza in output

Parameters:

message - istanza del messaggio che dovrà essere filtrato prima di poter essere loggato

phase -

• IOLogTracer.STATUS_REQUEST se è un messaggio di input
• IOLogTracer.STATUS_COMPLETE se è un messaggio di output
• IOLogTracer.STATUS_ERROR se è un messaggio di error

Returns:

istanza del messaggio filtrato.

getIdentity

public Identity getIdentity()

Description copied from interface: Identified

Returns the Identity associated to the component

Specified by:

getIdentity in interface Identified

Returns:

The Identity of the user currently logged in the application

setIdentity

public void setIdentity(Identity identity)

Description copied from interface: Identified

Sets the Identity to the component

Specified by:

setIdentity in interface Identified

Parameters:

identity - The Identity that must be associated to the component

isLogActive

protected abstract boolean isLogActive()

Check whether the log should be traced or not

Returns:

true if the log is active, false otherwise