busexplorer

Class BusExplorerLogin

java.lang.Object

busexplorer.BusExplorerLogin

public class BusExplorerLogin
extends Object

Trata, analisa e armazena dados de login no barramento.

Author:

Tecgraf

Field Summary

Fields

Modifier and Type	Field and Description
BusAddress	address Endereço.
BusAdminFacade	admin Instância de administração do baramento.
String	domain Domínio de autenticação
BusExtensionFacade	extension Instância da fachada de extensão a governança.
tecgraf.openbus.core.v2_1.services.access_control.LoginInfo	info Entidade.

Constructor Summary

Constructors

Constructor and Description
BusExplorerLogin(BusAddress address, String entity, String domain) Construtor para o objeto que representa o login no barramento.

Method Summary

Modifier and Type	Method and Description
void	doLogin(String password) Realiza o login no barramento usando a senha fornecida nessa chamada.
tecgraf.openbus.OpenBusContext	getOpenBusContext() Obtém o contexto da comunicação com o barramento.
ORB	getORB() Obtém o ORB associado ao contexto da comunicação com o barramento.
boolean	hasAdminRights() Indica se o usuário autenticado no momento possui permissão de administração.
void	logout() Realiza o shutdown do ORB e do assistente, terminando o login.
void	onRelogin(tecgraf.openbus.OnReloginCallback callback) Permite a personalização da OnReloginCallback presente no OpenBus SDK Java e garante o comportamento necessário para atualizar as informações armazenadas no BusExplorerLogin.

Methods inherited from class java.lang.Object

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

Field Detail

info

public final tecgraf.openbus.core.v2_1.services.access_control.LoginInfo info

Entidade.

address

public final BusAddress address

Endereço.

domain

public final String domain

Domínio de autenticação

admin

public BusAdminFacade admin

Instância de administração do baramento.

extension

public BusExtensionFacade extension

Instância da fachada de extensão a governança.

Constructor Detail

BusExplorerLogin

public BusExplorerLogin(BusAddress address,
                        String entity,
                        String domain)
                 throws InvalidName

Construtor para o objeto que representa o login no barramento. É realizada a validação do endereço usando os métodos fornecidos no BusAddress.

Parameters:

address - endereço do barramento

entity - entidade a ser autenticada no barramento

domain - domínio de autenticação para autenticar a entidade no barramento

Throws:

InvalidName - caso o ORB do OpenBus SDK Java não possua referência para OpenBusContext

See Also:

BusAddress.checkBusReference(), BusAddress.checkBusVersion()

Method Detail

onRelogin

public void onRelogin(tecgraf.openbus.OnReloginCallback callback)

Permite a personalização da OnReloginCallback presente no OpenBus SDK Java e garante o comportamento necessário para atualizar as informações armazenadas no BusExplorerLogin.

Parameters:

callback - implementação personalizada do OnReloginCallback

doLogin

public void doLogin(String password)
             throws tecgraf.openbus.core.v2_1.services.access_control.WrongEncoding,
                    tecgraf.openbus.exception.AlreadyLoggedIn,
                    tecgraf.openbus.core.v2_1.services.ServiceFailure,
                    tecgraf.openbus.core.v2_1.services.access_control.UnknownDomain,
                    tecgraf.openbus.core.v2_1.services.access_control.TooManyAttempts,
                    tecgraf.openbus.core.v2_1.services.access_control.AccessDenied

Realiza o login no barramento usando a senha fornecida nessa chamada.

Parameters:

password - Senha.

Throws:

tecgraf.openbus.core.v2_1.services.access_control.AccessDenied - caso as credenciais (entidade ou senha) não sejam válidas

tecgraf.openbus.exception.AlreadyLoggedIn - caso a conexão com o barramento já esteja autenticada

IllegalArgumentException - caso não seja possível determinar o corbaloc do endereço do barramento

tecgraf.openbus.core.v2_1.services.ServiceFailure - caso não seja possível acessar o serviço remoto

tecgraf.openbus.core.v2_1.services.access_control.TooManyAttempts - caso tenham havido muitas tentativas repetidas de autenticação por senha no barramento com a mesma entidade

tecgraf.openbus.core.v2_1.services.access_control.UnknownDomain - caso o domínio de autenticação não seja conhecido pelo barramento

tecgraf.openbus.core.v2_1.services.access_control.WrongEncoding - caso tenha havido um erro na codificação do handshake do protocolo OpenBus (pode ser um erro interno na biblioteca do OpenBus SDK Java)

hasAdminRights

public boolean hasAdminRights()

Indica se o usuário autenticado no momento possui permissão de administração.

Returns:

true se possui permissão de administração e false caso contrário. Se o login não foi realizado, o retorno será false.

logout

public void logout()

Realiza o shutdown do ORB e do assistente, terminando o login.

getOpenBusContext

public tecgraf.openbus.OpenBusContext getOpenBusContext()

Obtém o contexto da comunicação com o barramento.

Returns:

o contexto da biblioteca do OpenBus.

getORB

public ORB getORB()

Obtém o ORB associado ao contexto da comunicação com o barramento.

Returns:

a instância de ORB obtida através do OpenBusContext.ORB()