csbase.client.remote

Class ClientRemoteMonitor

java.lang.Object

csbase.logic.ServerManager

csbase.logic.SingleServerManager

csbase.client.remote.ClientRemoteMonitor

Direct Known Subclasses:

BasicServerMonitor

public class ClientRemoteMonitor
extends csbase.logic.SingleServerManager

Representa uma classe que será usada por um cliente para monitorar o estado da conexão com um servidor.

Author:

Tecgraf/PUC-Rio

Constructor Summary

Constructors

Constructor and Description
ClientRemoteMonitor(String appName, String serverURI, Class<?> locator) Cria um monitorador remoto de servidor que será usado por um cliente.

Method Summary

Modifier and Type	Method and Description
boolean	canChangePasswords() Informa se o servidor aceite troca de senhas.
protected void	error(Throwable t) Método de depuração.
csbase.remote.Authenticator	getAuthenticator() Busca o autenticador.
static ClientRemoteMonitor	getInstance()
String	getLogin() Retorna o login do usuário.
csbase.logic.LoginInfo	getLoginInfo() Retorna as informações de login corrente.
String	getPassword() Retorna a senha do usuário.
protected String	getReloginImagePath() Obtem o caminho da imagem da tela de relogin.
boolean	isLocalLogin() Indica se o método de autenticação do servidor é local ou não.
boolean	isLoginInfoInitialized() Retorna true se loginInfo não foi inicializado.
protected String	lang(String key)
protected csbase.logic.Session	login() Faz o login para um usuário via login e senha ou token dependendo de como o monitor foi iniciado.
void	setPassword(String newPassword) Altera a senha do usuário.
protected boolean	start() Método de início.
boolean	start(csbase.logic.openbus.OpenBusLoginToken token, Locale locale) Inicia o monitor.
boolean	start(String token) Inicia o monitor.
boolean	start(String login, String password, Locale locale) Inicia o monitor.
protected void	warning(String message) Método de depuração (stderr)

Methods inherited from class csbase.logic.SingleServerManager

logout, lookup, ping, setSystemName, startMonitoring, stop

Methods inherited from class csbase.logic.ServerManager

addCommonListener, addListener, addListener, addObserver, addObserver, addServer, deleteCommonListener, deleteListener, deleteListener, deleteObserver, deleteObserver, doLogin, getDefaultURI, getManagedServers, getMonitor, getMonitor, getServer, getServer, getServerLookupThread, getServerLookupThread, getServerPath, getService, getService, getSession, getSession, invalidate, invalidate, isAlive, isAlive, isDefault, isMonitored, login, logout, logout, performLookup, performLookup, removeObservers, removeObservers, setDefaultServer, setSystemName, setVerbose, shutdown, validate, validate

Methods inherited from class java.lang.Object

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

Constructor Detail

ClientRemoteMonitor

public ClientRemoteMonitor(String appName,
                           String serverURI,
                           Class<?> locator)

Cria um monitorador remoto de servidor que será usado por um cliente.

Parameters:

appName - O nome da aplicação (sistema) que está iniciando o monitoramento.

serverURI - A String que representa a URI CSBase do servidor

locator - A classe com o localizador de serviços. Será a classe ClientRemoteLocator ou um de seus descendentes.

Method Detail

getAuthenticator

public final csbase.remote.Authenticator getAuthenticator()

Busca o autenticador. Consulta o atributo (ver documentação de authenticator).

Returns:

o atributo.

getInstance

public static final ClientRemoteMonitor getInstance()

Returns:

A Instância única desta classe

warning

protected final void warning(String message)

Método de depuração (stderr)

Parameters:

message - mensagem

error

protected final void error(Throwable t)

Método de depuração.

Parameters:

t - exceção

getLogin

public String getLogin()

Retorna o login do usuário.

Returns:

.

getPassword

public String getPassword()

Retorna a senha do usuário.

Returns:

.

setPassword

public void setPassword(String newPassword)

Altera a senha do usuário.

Parameters:

newPassword - .

isLocalLogin

public final boolean isLocalLogin()

Indica se o método de autenticação do servidor é local ou não.

Returns:

true se os usuários forem autenticados localmente, false caso contrário.

canChangePasswords

public final boolean canChangePasswords()

Informa se o servidor aceite troca de senhas. A troca pode não ser aceita quando o método de autenticação utilizado pelo servidor acesse um servidor externo. Atualmente, este é o caso da autenticação via LDAP.

Returns:

verdadeiro caso o servidor aceite trocar senhas, falso caso contrário.

start

public final boolean start(String login,
                           String password,
                           Locale locale)
                    throws csbase.exception.CSBaseException

Inicia o monitor. Dados login, senha e o locale escolhido pelo usuário, o monitor vai tentar estabelecer a conexão com o servidor, autenticar o usuário e, a partir daí, irá monitorar constantemente a comunicação.

Parameters:

login - login

password - senha

locale - locale

Returns:

indicativo

Throws:

csbase.exception.CSBaseException - em caso de falha.

IllegalArgumentException - Caso algum dos parâmetros esteja nulo.

start

public final boolean start(String token)
                    throws csbase.exception.CSBaseException

Inicia o monitor. Dado um token que identica um pre-login do usuário, o monitor vai tentar estabelecer a conexão com o servidor, autenticar o usuário a partir desse token e, a partir daí, irá monitorar constantemente a comunicação.

Parameters:

token - Token de identificação do usuário.

Returns:

indicativo

Throws:

csbase.exception.CSBaseException - em caso de falha

IllegalArgumentException - Caso a chave de identificação da sessão do usuário seja nula.

start

public final boolean start(csbase.logic.openbus.OpenBusLoginToken token,
                           Locale locale)
                    throws csbase.exception.CSBaseException

Inicia o monitor. Dada a credencial do usuário no OpenBus, o monitor vai tentar estabelecer a conexão com o servidor, autenticar o usuário a partir dessa credencial e, a partir daí, irá monitorar constantemente a comunicação.

Parameters:

token - O token que permite ao servidor conectar-se ao barramento usando a conexão do cliente e validar o usuário

locale - locale

Returns:

indicativo

Throws:

csbase.exception.CSBaseException - em caso de falha

IllegalArgumentException - Caso a chave de identificação da sessão do usuário seja nula.

start

protected boolean start()
                 throws csbase.exception.CSBaseException

Método de início.

Returns:

indicativo

Throws:

csbase.exception.CSBaseException - em caso de erro

login

protected csbase.logic.Session login()
                              throws csbase.exception.CSBaseException,
                                     RemoteException

Faz o login para um usuário via login e senha ou token dependendo de como o monitor foi iniciado. Faz também o registro do usuário logado.

Havendo uma queda do servidor, e o monitor tiver sido iniciado através de um token, será solicitado ao usuário que entre com login e senha.

Specified by:

login in class csbase.logic.SingleServerManager

Returns:

A sessão do usuário.

Throws:

csbase.exception.CSBaseException - Caso ocorra algum problema no acesso ao servidor.

RemoteException - Em caso de falha na comunicação

See Also:

ServerEntryPoint.preLogin(String, String, Locale), ServerEntryPoint.login(String), ServerEntryPoint.login(String, EncryptedPassword, Locale)

getLoginInfo

public csbase.logic.LoginInfo getLoginInfo()

Retorna as informações de login corrente. Se não há ainda nenhuma informação de chave e senha, é solicitado ao usuário que informe a mesma.

Returns:

.

getReloginImagePath

protected String getReloginImagePath()

Obtem o caminho da imagem da tela de relogin.

Returns:

reloginImagePath o caminho da imagem.

lang

protected String lang(String key)

Specified by:

lang in class csbase.logic.SingleServerManager

isLoginInfoInitialized

public boolean isLoginInfoInitialized()

Retorna true se loginInfo não foi inicializado. Útil, por exemplo, quando o login foi feito por token (login as) durante a geração de menus do desktop

Returns:

true se loginInfo não foi inicializado