csbase.logic

Class ServerMonitor

java.lang.Object

csbase.logic.ServerMonitor

public class ServerMonitor
extends Object

Monitora uma conexão com um servidor CSBase identificado por uma ServerURI. Somente guarda a referência para o ponto de entrada do servidor após um lookup bem sucedido. Notifica através de ouvintes do tipo ServerMonitorListener o estado do servidor que pode ser alcançável ou não alcançável.

Author:

Tecgraf/PUC-Rio

Constructor Summary

Constructors

Constructor and Description
ServerMonitor(ServerURI serverURI) Constrói um monitor que será monitorado indefinidamente.
ServerMonitor(ServerURI serverURI, int maxRetries) Constrói um monitor.
ServerMonitor(ServerURI serverURI, int maxRetries, boolean verbose) Constrói um monitor.

Method Summary

Modifier and Type	Method and Description
void	addListener(ServerMonitorListener listener) Adiciona o listener a lista de listeners que são notificados quando a conexão é perdida ou restabelecida.
void	deleteListener(ServerMonitorListener listener) Remove o listener da lista de listeners que são notificados quando a conexão é perdida ou restabelecida.
ServerEntryPoint	getServer()
Thread	getServerLookupThread() Retorna a thread de lookup com o servidor.
ServerURI	getURI() Retorna a URI do servidor que está sendo monitorado.
void	invalidate() Força uma verificação assíncrona do estado do servidor.
boolean	isMonitoring() Indica se a monitoração está sendo executada
boolean	isReachable() Indica se o servidor está alcançável.
protected void	logError(String msg, Throwable t) Escreve no console a mensagem de erro e a exceção lançada
protected void	logInfo(String msg) Escreve no console uma mensagem informativa
protected void	logWarning(String msg) Escreve no console uma mensagem de aviso
boolean	lookup() Executa um lookup para obter a referência do ponto de entrada do servidor.
boolean	ping() Testa se o servidor está alcançável.
void	setVerbose(boolean verbose) Define se mensagens informativas devem ser exibidas.
void	startMonitoring() Inicia a thread de monitoração do servidor.
void	stopMonitoring() Interrompe o monitor.
protected boolean	tryReaching() Valida se consegue fazer contato com o servidor.

Methods inherited from class java.lang.Object

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

Constructor Detail

ServerMonitor

public ServerMonitor(ServerURI serverURI)

Constrói um monitor que será monitorado indefinidamente.

Parameters:

serverURI - A URI do servidor a ser monitorado.

ServerMonitor

public ServerMonitor(ServerURI serverURI,
                     int maxRetries)

Constrói um monitor.

Parameters:

serverURI - A URI do servidor a ser monitorado

maxRetries - O número máximo de tentativas de reconexão. Zero significa tentar indefinidamente

ServerMonitor

public ServerMonitor(ServerURI serverURI,
                     int maxRetries,
                     boolean verbose)

Constrói um monitor.

Parameters:

serverURI - A URI do servidor a ser monitorado

maxRetries - O número máximo de tentativas de reconexão. Zero significa tentar indefinidamente

verbose - true se informações devem ser exibidas, false se apenas erros e alertas devem ser exibidos

Method Detail

logError

protected void logError(String msg,
                        Throwable t)

Escreve no console a mensagem de erro e a exceção lançada

Parameters:

msg - a mensagem

t - a exceção lançada

logWarning

protected void logWarning(String msg)

Escreve no console uma mensagem de aviso

Parameters:

msg - a mensagem

logInfo

protected void logInfo(String msg)

Escreve no console uma mensagem informativa

Parameters:

msg - a mensagem

lookup

public final boolean lookup()

Executa um lookup para obter a referência do ponto de entrada do servidor.

Returns:

true se lookup bem sucedido ou false caso contrário.

tryReaching

protected boolean tryReaching()

Valida se consegue fazer contato com o servidor.

Retorna true Se for possível contactar o servidor. Caso contrário, se antes o servidor estava inalcançavel, notifica seus ouvintes da mudança de estado. Tenta contactar o servidor novamente. Se for possível, notifica os ouvintes e retorna true, caso contrário retorna false.

Returns:

true se foi possível contactar o servidor.

invalidate

public final void invalidate()

Força uma verificação assíncrona do estado do servidor.

ping

public final boolean ping()

Testa se o servidor está alcançável.

Returns:

true, caso o servidor esteja alcançável, ou false, caso contrário.

isReachable

public final boolean isReachable()

Indica se o servidor está alcançável.

Returns:

true, caso o servidor esteja alcançável, ou false, caso contrário.

startMonitoring

public final void startMonitoring()

Inicia a thread de monitoração do servidor.

stopMonitoring

public final void stopMonitoring()

Interrompe o monitor.

isMonitoring

public final boolean isMonitoring()

Indica se a monitoração está sendo executada

Returns:

true se a thread de monitoração está ativa, false caso contrário

addListener

public final void addListener(ServerMonitorListener listener)

Adiciona o listener a lista de listeners que são notificados quando a conexão é perdida ou restabelecida.

Parameters:

listener - Listener adicionado na lista

deleteListener

public final void deleteListener(ServerMonitorListener listener)

Remove o listener da lista de listeners que são notificados quando a conexão é perdida ou restabelecida.

Parameters:

listener - Listener a ser removido na lista

getURI

public final ServerURI getURI()

Retorna a URI do servidor que está sendo monitorado.

Returns:

O nome do servidor.

getServerLookupThread

public final Thread getServerLookupThread()

Retorna a thread de lookup com o servidor.

Returns:

A thread de lookup

getServer

public final ServerEntryPoint getServer()

Returns:

O ponto de entrada do servidor ou null caso esteja fora do ar

setVerbose

public void setVerbose(boolean verbose)

Define se mensagens informativas devem ser exibidas.

Parameters:

verbose - true se informações devem ser exibidas, false se apenas erros e alertas devem ser exibidos