csbase.remote

Interface ServerEntryPoint

All Superinterfaces:

csbase.util.rmi.IPingable, java.rmi.Remote

public interface ServerEntryPoint
extends csbase.util.rmi.IPingable

Define as funcionalidades de um servidor CSBase que são visíveis para o cliente. A partir desta interface remota que deve ser feito lookup no servidor.

Ex:
ServerEntryPoint server = (ServerEntryPoint) Naming.lookup("rmi://"+serverName+"/"+ServerEntryPoint.LOOKUP);

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	LOOKUP Constante utilizada para fazer lookup no servidor

Method Summary

Methods

Modifier and Type	Method and Description
boolean	canChangePasswords() Informa se o servidor aceite troca de senhas.
HttpServiceInterface	fetchHttpService() Trata o caso especial dos serviço HttpService que ainda não foi segmentado e migrado para o padrão de proxies para serviços.
<T extends ServiceInterface> T	fetchService(java.lang.Object sessionKey, java.lang.String serviceName) Obtem a referência para um determinado serviço disponível
java.util.Map<java.lang.String,ServiceInterface>	fetchServices(java.lang.Object sessionKey, java.util.Set<java.lang.String> servicesNames) Obtem as referências para os serviços especificados.
UserOutline[]	getLoggedUsers() Obtém os usuários atualmente conectados ao sistema.
java.security.PublicKey	getPublicKey() Retorna a chave pública para criptografar a senha do login.
java.lang.String	getSystemDefaultCharsetName() Consulta nome do charset default do servidor
java.lang.String	getSystemName() Consulta o nome do sistema.
java.lang.String	getSystemURLWithRMIPort() Obtém a URL de um determinado sistema, acrescido do parâmetro da porta RMI (server_port).
java.lang.String	getSystemURLWithRMIPort(java.lang.String systemName) Obtém a URL de um determinado sistema, acrescido do parâmetro da porta RMI (server_port) e o parâmetro da página (page).
java.lang.String	getVersionName() Informa a versão do servidor em execução.
boolean	isLocalLogin() Indica se o método de autenticação do servidor é local ou não.
java.util.Map<java.lang.String,java.io.Serializable>	isValidSession(java.lang.Object sessionKey, java.lang.String serverName, byte[] signedServerName) Valida a sessão de um usuário.
Session	login(OpenBusLoginToken token, java.util.Locale locale, java.util.TimeZone timeZone) Executa o login de um usuário conectado ao OpenBus.
Session	login(ServerURI referedServerURI, java.util.Map<java.lang.String,java.io.Serializable> attr, boolean copyServerSessionAttrs, java.lang.Object sessionkey, java.lang.String login, java.lang.String delegatedLogin, java.util.Locale locale, java.util.TimeZone tz) Executa o login de um usuário que é validado através de uma referência de outro servidor onde ele deve ter uma sessão válida.
Session	login(java.lang.String token) Executa o login de um usuário que fez anteriormente um preLogin.
Session	login(java.lang.String localServerName, byte[] signedLocalServerName, java.util.Locale locale) Executa o login de um servidor local.
Session	login(java.lang.String login, EncryptedPassword encryptedPassword, java.util.Locale locale) Executa o login de um usuário via usuário e senha.
Session	login(java.lang.String login, EncryptedPassword encryptedPassword, java.util.Locale locale, java.lang.String delegatedLogin) Executa o login de um usuário via login e senha com a possibilidade de delegar o login a um outro usuário, para isso o usuário deverá ser um super-usuário do sistema que significa ter permissão de super-usuário( SuperUserPermission).
Session	login(java.lang.String login, EncryptedPassword encryptedPassword, java.util.Locale locale, java.util.TimeZone timeZone) Executa o login de um usuário via usuário e senha.
Session	login(java.lang.String login, EncryptedPassword encryptedPassword, java.util.Locale locale, java.util.TimeZone tz, java.lang.String delegatedLogin) Executa o login de um usuário via login e senha com a possibilidade de delegar o login a um outro usuário, para isso o usuário deverá ser um super-usuário do sistema que significa ter permissão de super-usuário( SuperUserPermission).
Session	login(java.lang.String login, EncryptedPassword encryptedPassword, java.util.Locale locale, java.util.TimeZone tz, java.lang.String delegatedLogin, java.util.Map<java.lang.String,java.io.Serializable> params) Executa o login de um usuário via login e senha com a possibilidade de delegar o login a um outro usuário, para isso o usuário deverá ser um super-usuário do sistema que significa ter permissão de super-usuário ( SuperUserPermission).
Session	login(java.lang.String token, java.util.TimeZone timeZone) Executa o login de um usuário que fez anteriormente um preLogin.
void	logout(java.lang.Object sessionKey) Faz o logout de um usuário do sistema.
PreLoginData	preLogin(java.lang.String login, java.lang.String password, java.util.Locale locale) Autentica um usuário no sistema e cria um token para ser usado como identificação em um posterior login onde não há a informação de usuário e senha.
PreLoginData	preLogin(java.lang.String login, java.lang.String password, java.util.Locale locale, java.util.Map<java.lang.String,java.io.Serializable> attributes) Autentica um usuário no sistema e cria um token para ser usado como identificação em um posterior login onde não há a informação de usuário e senha.
PreLoginData	preLogin(java.lang.String login, java.lang.String password, java.util.Locale locale, java.lang.String delegatedLogin, java.rmi.Remote control, java.io.Serializable userData) Autentica um usuário no sistema e cria um token para ser usado como identificação em um posterior login onde não há a informação de usuário e senha.
java.lang.String	preLogin2Web(java.lang.String login, java.lang.String password, java.util.Locale locale) Autentica um usuário no sistema e retorna uma url de acesso ao mesmo, que permitirá abrir o sistema sem necessidade de perguntar ao usuário as informações de login e senha.
java.lang.String	preLogin2Web(java.lang.String login, java.lang.String password, java.util.Locale locale, java.util.Map<java.lang.String,java.io.Serializable> attributes) Autentica um usuário no sistema e retorna uma url de acesso ao mesmo, que permitirá abrir o sistema sem necessidade de perguntar ao usuário as informações de login e senha.
java.lang.String	preLogin2Web(java.lang.String login, java.lang.String password, java.util.Locale locale, java.lang.String systemName) Autentica um usuário no sistema especificado e cria um token para ser usado como identificação em um posterior login onde não há a informação de usuário e senha.
java.lang.String	preLogin2Web(java.lang.String login, java.lang.String password, java.util.Locale locale, java.lang.String delegatedLogin, java.lang.String systemName) Autentica um usuário no sistema especificado e cria um token para ser usado como identificação em um posterior login onde não há a informação de usuário e senha.
void	setServerSessionProperty(java.lang.Object sessionKey, java.lang.String propertyName, java.io.Serializable propertyValue) Define o valor de uma propriedade na sessão do usuário no servidor.
void	setSystemName(java.lang.Object sessionKey, java.lang.String systemName) Define o nome do sistema que está sendo usado como cliente.

Methods inherited from interface csbase.util.rmi.IPingable

canReach, ping

Field Detail

LOOKUP

static final java.lang.String LOOKUP

Constante utilizada para fazer lookup no servidor

See Also:

Constant Field Values

Method Detail

getVersionName

java.lang.String getVersionName()
                                throws java.rmi.RemoteException

Informa a versão do servidor em execução. O texto retornado é o informado por Version.getName().

Returns:

A versão do servidor.

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

preLogin

PreLoginData preLogin(java.lang.String login,
                    java.lang.String password,
                    java.util.Locale locale)
                      throws java.rmi.RemoteException

Autentica um usuário no sistema e cria um token para ser usado como identificação em um posterior login onde não há a informação de usuário e senha. Esse token pode ser utilizado como parâmetro em endereços urls.

Parameters:

login - O identificador do usuário que deseja fazer seu login.

password - A senha do respectivo usuário.

locale - A Locale que o usuário deseja utilizar no posterior login.

Returns:

Dados sobe o preLogin realizado.

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

See Also:

login(String)

preLogin

PreLoginData preLogin(java.lang.String login,
                    java.lang.String password,
                    java.util.Locale locale,
                    java.util.Map<java.lang.String,java.io.Serializable> attributes)
                      throws java.rmi.RemoteException

Autentica um usuário no sistema e cria um token para ser usado como identificação em um posterior login onde não há a informação de usuário e senha. Esse token pode ser utilizado como parâmetro em endereços urls.

Parameters:

login - O identificador do usuário que deseja fazer seu login.

password - A senha do respectivo usuário.

locale - A Locale que o usuário deseja utilizar no posterior login.

attributes - Atributos da sessão do usuário.

Returns:

Dados sobe o preLogin realizado.

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

See Also:

login(String)

preLogin

PreLoginData preLogin(java.lang.String login,
                    java.lang.String password,
                    java.util.Locale locale,
                    java.lang.String delegatedLogin,
                    java.rmi.Remote control,
                    java.io.Serializable userData)
                      throws java.rmi.RemoteException

Autentica um usuário no sistema e cria um token para ser usado como identificação em um posterior login onde não há a informação de usuário e senha. Esse token pode ser utilizado como parâmetro em endereços urls.

O usuário é autenticado por um super-usuário, que é um usuário com permissão de super-usuário(SuperUserPermission). Autentica e cria no servidor uma sessão do usuário delegado.

OBS: O Administrador(admin) não precisa de permissão de super-usuário para delegar um outro usuário e, por questões de segurança, não pode ser um usuário delegado por nenhum super-usuário.

Parameters:

login - o identificador do super-usuário.

password - a senha do super-usuário.

locale - A Locale que será usado no login do usuário delegado.

delegatedLogin - login do usuário que será delegado pelo super-usuário sem a necessidade de senha.

control - Objeto de controle.

userData - Identificação do usuário.

Returns:

Dados sobe o preLogin realizado.

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

See Also:

login(String)

preLogin2Web

java.lang.String preLogin2Web(java.lang.String login,
                            java.lang.String password,
                            java.util.Locale locale,
                            java.lang.String systemName)
                              throws java.rmi.RemoteException

Autentica um usuário no sistema especificado e cria um token para ser usado como identificação em um posterior login onde não há a informação de usuário e senha. Esse token pode ser utilizado como parâmetro em endereços urls.

Parameters:

login - O identificador do usuário que deseja fazer seu login.

password - A senha do respectivo usuário.

locale - A Locale que o usuário deseja utilizar no posterior login.

systemName - O nome do sistema onde o usuário deseja se autenticar.

Returns:

Uma string que é o token para identificação de um pré-login válido. null se o login e/ou senha forem inválidos.

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

See Also:

login(String)

preLogin2Web

java.lang.String preLogin2Web(java.lang.String login,
                            java.lang.String password,
                            java.util.Locale locale,
                            java.lang.String delegatedLogin,
                            java.lang.String systemName)
                              throws java.rmi.RemoteException

Autentica um usuário no sistema especificado e cria um token para ser usado como identificação em um posterior login onde não há a informação de usuário e senha. Esse token pode ser utilizado como parâmetro em endereços urls.

Parameters:

login - O identificador do usuário que deseja fazer seu login.

password - A senha do respectivo usuário.

locale - A Locale que o usuário deseja utilizar no posterior login.

delegatedLogin - login do usuário que será delegado pelo super-usuário sem a necessidade de senha.

systemName - O nome do sistema onde o usuário deseja se autenticar.

Returns:

Uma string que é o token para identificação de um pré-login válido. null se o login e/ou senha forem inválidos.

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

See Also:

login(String)

preLogin2Web

java.lang.String preLogin2Web(java.lang.String login,
                            java.lang.String password,
                            java.util.Locale locale)
                              throws java.rmi.RemoteException

Autentica um usuário no sistema e retorna uma url de acesso ao mesmo, que permitirá abrir o sistema sem necessidade de perguntar ao usuário as informações de login e senha. Para se concatenar parâmetros nessa url deve-se usar "&".

Parameters:

login - O identificador do usuário que deseja fazer seu login.

password - A senha do respectivo usuário.

locale - A Locale que o usuário deseja utilizar no posterior login.

Returns:

Uma url para carga do cliente do sistema. null se o login e/ou senha forem inválidos.

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

preLogin2Web

java.lang.String preLogin2Web(java.lang.String login,
                            java.lang.String password,
                            java.util.Locale locale,
                            java.util.Map<java.lang.String,java.io.Serializable> attributes)
                              throws java.rmi.RemoteException

Autentica um usuário no sistema e retorna uma url de acesso ao mesmo, que permitirá abrir o sistema sem necessidade de perguntar ao usuário as informações de login e senha. Para se concatenar parâmetros nessa url deve-se usar "&".

Parameters:

login - O identificador do usuário que deseja fazer seu login.

password - A senha do respectivo usuário.

locale - A Locale que o usuário deseja utilizar no posterior login.

attributes - Atributos da sessão do usuário.

Returns:

Uma url para carga do cliente do sistema. null se o login e/ou senha forem inválidos.

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

login

Session login(java.lang.String login,
            EncryptedPassword encryptedPassword,
            java.util.Locale locale)
              throws java.rmi.RemoteException

Executa o login de um usuário via usuário e senha.

Pode ser utilizado para se logar a primeira vez ou após uma queda do servidor.

Atenção: Para cada ação de login deve haver uma ação de logout associada.

Parameters:

login - o identificador do usuário que deseja fazer seu login.

encryptedPassword - a senha do respectivo usuário.

locale - A Locale que o usuário escolheu no login.

Returns:

Uma chave que identifica um usuário logado. null se chave e/ou senha foram inválidos

Throws:

java.rmi.RemoteException - se ocorrer algum problema na comunicação com o servidor.

See Also:

logout(Object)

login

Session login(java.lang.String login,
            EncryptedPassword encryptedPassword,
            java.util.Locale locale,
            java.util.TimeZone timeZone)
              throws java.rmi.RemoteException

Executa o login de um usuário via usuário e senha.

Pode ser utilizado para se logar a primeira vez ou após uma queda do servidor.

Atenção: Para cada ação de login deve haver uma ação de logout associada.

Parameters:

login - o identificador do usuário que deseja fazer seu login.

encryptedPassword - a senha do respectivo usuário.

locale - A Locale que o usuário escolheu no login.

timeZone - TimeZone do cliente pelo qual o usuário se logou.

Returns:

Uma chave que identifica um usuário logado. null se chave e/ou senha foram inválidos

Throws:

java.rmi.RemoteException - se ocorrer algum problema na comunicação com o servidor.

See Also:

logout(Object)

login

Session login(java.lang.String login,
            EncryptedPassword encryptedPassword,
            java.util.Locale locale,
            java.lang.String delegatedLogin)
              throws java.rmi.RemoteException

Executa o login de um usuário via login e senha com a possibilidade de delegar o login a um outro usuário, para isso o usuário deverá ser um super-usuário do sistema que significa ter permissão de super-usuário( SuperUserPermission). Autentica e cria no servidor uma sessão do usuário delegado. Pode ser utilizado para se logar a primeira vez ou após uma queda do servidor. OBS: O Administrador(admin) não precisa de permissão de super-usuário para delegar um outro usuário e, por questões de segurança, não pode ser um usuário delegado por nenhum super-usuário.

Atenção: Para cada ação de login deve haver uma ação de logout associada.

Parameters:

login - o identificador do super-usuário.

encryptedPassword - a senha do super-usuário.

locale - A Locale que será usado no login do usuário delegado.

delegatedLogin - login do usuário que será delegado pelo super-usuário sem a necessidade de senha.

Returns:

A sessão do usuário. null se chave e/ou senha foram inválidos

Throws:

java.rmi.RemoteException - se ocorrer algum problema na comunicação com o servidor.

See Also:

SuperUserPermission, logout(Object)

login

Session login(java.lang.String login,
            EncryptedPassword encryptedPassword,
            java.util.Locale locale,
            java.util.TimeZone tz,
            java.lang.String delegatedLogin)
              throws java.rmi.RemoteException

Executa o login de um usuário via login e senha com a possibilidade de delegar o login a um outro usuário, para isso o usuário deverá ser um super-usuário do sistema que significa ter permissão de super-usuário( SuperUserPermission). Autentica e cria no servidor uma sessão do usuário delegado. Pode ser utilizado para se logar a primeira vez ou após uma queda do servidor. OBS: O Administrador(admin) não precisa de permissão de super-usuário para delegar um outro usuário e, por questões de segurança, não pode ser um usuário delegado por nenhum super-usuário.

Atenção: Para cada ação de login deve haver uma ação de logout associada.

Parameters:

login - o identificador do super-usuário.

encryptedPassword - a senha do super-usuário.

locale - A Locale que será usado no login do usuário delegado.

tz - O TimeZone que será usado no login do usuário delegado

delegatedLogin - login do usuário que será delegado pelo super-usuário sem a necessidade de senha.

Returns:

A sessão do usuário. null se chave e/ou senha foram inválidos

Throws:

java.rmi.RemoteException - se ocorrer algum problema na comunicação com o servidor.

See Also:

SuperUserPermission, logout(Object)

login

Session login(java.lang.String login,
            EncryptedPassword encryptedPassword,
            java.util.Locale locale,
            java.util.TimeZone tz,
            java.lang.String delegatedLogin,
            java.util.Map<java.lang.String,java.io.Serializable> params)
              throws java.rmi.RemoteException

Executa o login de um usuário via login e senha com a possibilidade de delegar o login a um outro usuário, para isso o usuário deverá ser um super-usuário do sistema que significa ter permissão de super-usuário ( SuperUserPermission). Autentica e cria no servidor uma sessão do usuário delegado. Pode ser utilizado para se logar a primeira vez ou após uma queda do servidor. OBS: O Administrador(admin) não precisa de permissão de super-usuário para delegar um outro usuário e, por questões de segurança, não pode ser um usuário delegado por nenhum super-usuário.

Atenção: Para cada ação de login deve haver uma ação de logout associada.

Parameters:

login - o identificador do super-usuário.

encryptedPassword - a senha do super-usuário.

locale - A Locale que será usado no login do usuário delegado.

tz - O TimeZone que será usado no login do usuário delegado

delegatedLogin - login do usuário que será delegado pelo super-usuário sem a necessidade de senha.

params - Parâmetros que serão copiados para a sessão do usuário

Returns:

A sessão do usuário. null se chave e/ou senha foram inválidos

Throws:

java.rmi.RemoteException - se ocorrer algum problema na comunicação com o servidor.

See Also:

SuperUserPermission, logout(Object)

login

Session login(java.lang.String token)
              throws java.rmi.RemoteException

Executa o login de um usuário que fez anteriormente um preLogin.

Atenção: Para cada ação de login deve haver uma ação de logout associada.

Parameters:

token - Identificação de um preLogin.

Returns:

Uma chave que identifica um usuário logado. null se chave e/ou senha foram inválidos

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

See Also:

preLogin(String, String, Locale), logout(Object)

login

Session login(java.lang.String token,
            java.util.TimeZone timeZone)
              throws java.rmi.RemoteException

Executa o login de um usuário que fez anteriormente um preLogin.

Atenção: Para cada ação de login deve haver uma ação de logout associada.

Parameters:

token - Identificação de um preLogin.

timeZone - TimeZone do cliente pelo qual o usuário se logou.

Returns:

Uma chave que identifica um usuário logado. null se chave e/ou senha foram inválidos

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

See Also:

preLogin(String, String, Locale), logout(Object)

login

Session login(OpenBusLoginToken token,
            java.util.Locale locale,
            java.util.TimeZone timeZone)
              throws java.rmi.RemoteException

Executa o login de um usuário conectado ao OpenBus.

Parameters:

token - O token de login do OpenBus.

locale - A Locale que será usado no login do usuário delegado.

timeZone - TimeZone do cliente pelo qual o usuário se logou.

Returns:

Uma chave que identifica um usuário logado. null se chave e/ou senha foram inválidos

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

See Also:

logout(Object)

login

Session login(java.lang.String localServerName,
            byte[] signedLocalServerName,
            java.util.Locale locale)
              throws java.rmi.RemoteException

Executa o login de um servidor local.

Atenção: Para cada ação de login deve haver uma ação de logout associada.

Parameters:

localServerName - O nome do servidor local.

signedLocalServerName - O nome do servidor local, assinado.

locale - O locale do servidor local.

Returns:

Uma chave que identifica um usuário logado. null se chave e/ou senha foram inválidos

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

See Also:

logout(Object)

login

Session login(ServerURI referedServerURI,
            java.util.Map<java.lang.String,java.io.Serializable> attr,
            boolean copyServerSessionAttrs,
            java.lang.Object sessionkey,
            java.lang.String login,
            java.lang.String delegatedLogin,
            java.util.Locale locale,
            java.util.TimeZone tz)
              throws java.rmi.RemoteException

Executa o login de um usuário que é validado através de uma referência de outro servidor onde ele deve ter uma sessão válida. O servidor deve possuir o certificado do servidor referenciado para garantir a relação de confiança. Se o servidor referenciado for o mesmo (mesmo host e porta deste servidor) então basta verificar se a sessão é valida.

Parameters:

referedServerURI - A URI do servidor de referência para validação

attr - Atributos para serem armazenados na sessão do usuário

sessionkey - A chave da sessão a ser validada no servidor de referência

copyServerSessionAttrs - Se true copia os attributos de sessão do servidor de referência para a nova sessão criada nesse servidor

login - O login do usuário

delegatedLogin - O login para delegação ou null se não for o caso

locale - O Locale

tz - O Timezone

Returns:

A sessão do usuário ou null caso o usuário não seja validado no servidor de referência ou ocorra algum erro durante o login.

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

logout

void logout(java.lang.Object sessionKey)
            throws java.rmi.RemoteException

Faz o logout de um usuário do sistema.

Parameters:

sessionKey - A chave de sessão do usuário que está efetuando o logout.

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

getLoggedUsers

UserOutline[] getLoggedUsers()
                             throws java.rmi.RemoteException

Obtém os usuários atualmente conectados ao sistema.

Returns:

usuários atualmente conectados ao sistema.

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

isLocalLogin

boolean isLocalLogin()
                     throws java.rmi.RemoteException

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.

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

canChangePasswords

boolean canChangePasswords()
                           throws java.rmi.RemoteException

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.

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

fetchServices

java.util.Map<java.lang.String,ServiceInterface> fetchServices(java.lang.Object sessionKey,
                                                             java.util.Set<java.lang.String> servicesNames)
                                                               throws java.rmi.RemoteException

Obtem as referências para os serviços especificados. O mapa de serviços tem como chave os nomes dos serviços conforme as constantes XxxxServiceInterface.SERVICE_NAME.

Parameters:

sessionKey - Chave da sessão de um usuário.

servicesNames - Nome dos serviços.

Returns:

Mapa com os serviços disponíveis. null se a sessão for inválida.

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

fetchService

<T extends ServiceInterface> T fetchService(java.lang.Object sessionKey,
                                          java.lang.String serviceName)
                                        throws java.rmi.RemoteException

Obtem a referência para um determinado serviço disponível

Parameters:

sessionKey - Chave da sessão de um usuário.

serviceName - Nome do Serviço. Conforme constante XxxxServiceInterface.SERVICE_NAME.

Returns:

Referência para o serviço especificado. null caso o serviço solicitado não esteja disponível ou a sessão for inválida.

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

fetchHttpService

HttpServiceInterface fetchHttpService()
                                      throws java.rmi.RemoteException

Trata o caso especial dos serviço HttpService que ainda não foi segmentado e migrado para o padrão de proxies para serviços.

OBS:
Esse método deve ser utilizado somente em casos onde é necessário obter uma referência para esse serviço sem estar logado. Servlets por exemplo.

Returns:

O serviço de Http.

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

setSystemName

void setSystemName(java.lang.Object sessionKey,
                 java.lang.String systemName)
                   throws java.rmi.RemoteException

Define o nome do sistema que está sendo usado como cliente.

Parameters:

sessionKey - A chave de sessão de um usuário.

systemName - O nome do sistema cliente.

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

getSystemName

java.lang.String getSystemName()
                               throws java.rmi.RemoteException

Consulta o nome do sistema.

Returns:

o nome

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

getSystemDefaultCharsetName

java.lang.String getSystemDefaultCharsetName()
                                             throws java.rmi.RemoteException

Consulta nome do charset default do servidor

Returns:

o nome do charset

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

getSystemURLWithRMIPort

java.lang.String getSystemURLWithRMIPort()
                                         throws java.rmi.RemoteException

Obtém a URL de um determinado sistema, acrescido do parâmetro da porta RMI (server_port).

Returns:

a URL de acesso para determinado sistema.

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

getSystemURLWithRMIPort

java.lang.String getSystemURLWithRMIPort(java.lang.String systemName)
                                         throws java.rmi.RemoteException

Obtém a URL de um determinado sistema, acrescido do parâmetro da porta RMI (server_port) e o parâmetro da página (page).

Parameters:

systemName - o nome do sistema que se deseja obter a URL. Este nome é usado para definir o parâmetro page da URL, que será acrescido da extensão do tipo de aplicativo web. (i.e.: ".jnlp")

Returns:

a URL de acesso para determinada aplicação.

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

setServerSessionProperty

void setServerSessionProperty(java.lang.Object sessionKey,
                            java.lang.String propertyName,
                            java.io.Serializable propertyValue)
                              throws java.rmi.RemoteException

Define o valor de uma propriedade na sessão do usuário no servidor.

Parameters:

sessionKey - A chave da sessão do usuário.

propertyName - O nome da propriedade.

propertyValue - O novo valor da propriedade.

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

isValidSession

java.util.Map<java.lang.String,java.io.Serializable> isValidSession(java.lang.Object sessionKey,
                                                                  java.lang.String serverName,
                                                                  byte[] signedServerName)
                                                                    throws java.rmi.RemoteException

Valida a sessão de um usuário. O servidor deve verificar a assinatura do nome do servidor requisitando a validação.

Parameters:

sessionKey - A sessão a ser validada

serverName - O nome do servidor requisitando a validação

signedServerName - O nome assinado do servidor requisitando a validação

Returns:

O mapa de atributos do servidor se a sessão é valida e o servidor que requisitou a validação é confiável, null caso contrário.

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.

getPublicKey

java.security.PublicKey getPublicKey()
                                     throws java.rmi.RemoteException

Retorna a chave pública para criptografar a senha do login.

Returns:

chave pública para criptografia da senha do login.

Throws:

java.rmi.RemoteException - Caso ocorra algum problema na comunicação com o servidor.