csbase.client.ias

Class IncludeUserInfoDialog

java.lang.Object

csbase.client.ias.UserInfoDialog

csbase.client.ias.IncludeUserInfoDialog

public class IncludeUserInfoDialog
extends UserInfoDialog

Diálogo para inclusão de dados de um ou mais usuários.

NOTA 1: Caso o método de autenticação do servidor não seja validação local, o diálogo exibe um checkbox permitindo uma autenticação local "forçada". Isto é necessário devido a uma circunstância atual na Petrobras de descentralização na administração de servidores LDAP. Como existem muitas configurações diferentes, o sistema tem dificuldade em conectar-se a alguns desses servidores, o que impossibilita usuários cadastrados nesses servidores de acessarem o sistema. Para contornar esse problema, foi criada essa possibilidade de login local forçado para o administrador poder atribuir a usuários enquadrados nessa situação, enquanto uma solução mais geral não for encontrada.

NOTA 2: a sigla "DTO" usada na documentação refere-se ao padrão Data Transfer Object, utilizado por um objeto que centraliza as informações do usuário (ver UserInfoDialog.userInfo).

Author:

Tecgraf

Field Summary

Fields inherited from class csbase.client.ias.UserInfoDialog

addEmailTf, dialogTitle, emailsModel, login, name, ownerWindow, userInfo, userInfoDialog

Constructor Summary

Constructors

Constructor and Description
IncludeUserInfoDialog(Window ownerWindow) Cria o diálogo de inclusão de usuários.

Method Summary

Modifier and Type	Method and Description
protected void	addDataComponentsListeners() Adiciona observadores aos componentes que mantém os dados do usuário.
protected void	addUserInfo(csbase.logic.UserInfo info) Carrega as informações de usuário nos campos de texto.
protected void	clearFields() Limpa todos os campos de dados do usuário (menos o combo de UserGroup e o checkbox de login local forçado - estes permanecem com a última seleção para facilitar a inclusão sucessiva de vários usuários com essas mesmas características.
protected boolean	confirmClose() Avisa o usuário de que há dados entrados não-salvos, e confirma se este deseja realmente sair ignorando os dados entrados, cancelar ou gravar suas alterações antes de fechar.
protected List<JComponent[]>	createDataComponents() Cria uma lista com os componentes que irão conter os dados do usuários. Cada elemento dessa lista deverá ser um array de dois componentes.
protected boolean	createUser() Executa a ação de criar o usuário, usando os dados preenchidos nos campos do diálogo.
protected void	fireOnDataChanged() Método chamado sempre que algum dado for alterado.
protected void	makeDialog() Cria um diálogo básico de dados de um usuário, dividido em 3 áreas: um painel superior com os campos de texto login, nome e e-mail; um painel central vazio, preparado para botões que acionam diálogos de informações complementares, como perfis, permissões e senha; e finalmente um painel inferior para botões de ação, contendo um botão "Fechar". Tanto o botão "X" no canto superior esquerdo da janela quanto o botão "Fechar" executam o mesmo procedimento UserInfoDialog.close() ao fechar.
protected JPanel	makeLowerPanel() Constrói o painel inferior, contendo os botões de ação (o painel básico só contém o botão fechar).
protected JPanel	makeMiddlePanel() Constrói o painel central, reservado para a entrada de informações complementares do usuário.
protected boolean	requiredFieldsAreFilled() Indica se os campos requeridos estão preenchidos.
protected void	sendUserInfoCallBackObject(UserInfoCallBackInterface callBack) Adiciona um KeyListener ao campo de login usando o callBack Object para devolver o conteúdo do campo à classe que o chamou.
protected boolean	unsavedDataInput() Verifica se houve entrada de dados não-salvos na interface.
protected void	updateUserInfo() Atualiza o conteúdo do DTO de usuário com as informações contidas nos campos do diálogo (login, nome e e-mail).

Methods inherited from class csbase.client.ias.UserInfoDialog

addEmail, getLogin, getUserInfoDialog, makeCloseButton, makeUpperPanel, setVisible

Methods inherited from class java.lang.Object

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

Constructor Detail

IncludeUserInfoDialog

public IncludeUserInfoDialog(Window ownerWindow)

Cria o diálogo de inclusão de usuários.

Parameters:

ownerWindow - janela que criou este diálogo.

Method Detail

updateUserInfo

protected void updateUserInfo()

Atualiza o conteúdo do DTO de usuário com as informações contidas nos campos do diálogo (login, nome e e-mail).

Se o método UserInfoDialog.createDataComponents() for sobrescrito para adicionar novos componentes, este método também deverá ser sobrescrito para que o valor desses novos componentes sejam salvos no userInfo.

Acrescenta ao DTO as seleções de grupo de usuário e atributo "login local forçado".
OBS: Os diálogos de informações complementares (perfis, permissões e senhas) se encarregam de atualizar o DTO, portanto não é necessário atualizar essas informações aqui.

Overrides:

updateUserInfo in class UserInfoDialog

See Also:

UserInfoDialog.createDataComponents()

makeLowerPanel

protected JPanel makeLowerPanel()

Constrói o painel inferior, contendo os botões de ação (o painel básico só contém o botão fechar).
Acrescenta ao painel o botão "Incluir".

Overrides:

makeLowerPanel in class UserInfoDialog

Returns:

o painel inferior do diálogo.

See Also:

makeIncludeUserButton()

createUser

protected boolean createUser()

Executa a ação de criar o usuário, usando os dados preenchidos nos campos do diálogo. Se a criação for bem-sucedida, limpa os campos, possibilitando múltiplas inclusões em série. O método assume que qualquer erro ocorrido na criação do usuário deverá ser reportado no ponto em que ocorrer, portanto não se preocupa com a exibição de mensagem de erro, apenas de sucesso.

Returns:

true se o usuário tiver sido criado com sucesso, false se este não tiver sido criado, seja por falta de informações, seja por erro na criação.

clearFields

protected void clearFields()

Limpa todos os campos de dados do usuário (menos o combo de UserGroup e o checkbox de login local forçado - estes permanecem com a última seleção para facilitar a inclusão sucessiva de vários usuários com essas mesmas características.
Desabilita também o botão de incluir.

makeDialog

protected void makeDialog()

Cria um diálogo básico de dados de um usuário, dividido em 3 áreas:

1. um painel superior com os campos de texto login, nome e e-mail;
2. um painel central vazio, preparado para botões que acionam diálogos de informações complementares, como perfis, permissões e senha;
3. e finalmente um painel inferior para botões de ação, contendo um botão "Fechar".

Tanto o botão "X" no canto superior esquerdo da janela quanto o botão "Fechar" executam o mesmo procedimento UserInfoDialog.close() ao fechar.
Adiciona listeners de mudança nos dados aos campos do diálogo.

Overrides:

makeDialog in class UserInfoDialog

See Also:

UserInfoDialog.close()

createDataComponents

protected List<JComponent[]> createDataComponents()

Cria uma lista com os componentes que irão conter os dados do usuários.
Cada elemento dessa lista deverá ser um array de dois componentes. O 1o deverá ser o label do 2o componente.

Se esse método for sobrescrito para adicionar novos componentes, você também deverá sobrescrever os métodos UserInfoDialog.addDataComponentsListeners() e UserInfoDialog.updateUserInfo().

Overrides:

createDataComponents in class UserInfoDialog

Returns:

uma lista de tuplas label-componente que irão conter os dados do usuário.

See Also:

UserInfoDialog.addDataComponentsListeners()

addDataComponentsListeners

protected void addDataComponentsListeners()

Adiciona observadores aos componentes que mantém os dados do usuário.

Se ao extender essa classe você sobrescrever o método UserInfoDialog.createDataComponents() para adicionar novos componentes, sobrescreva também este método adicionando aqui os observadores dos dados destes componentes para que quando estes forem alterados, eles chamem o método UserInfoDialog.fireOnDataChanged().

Este método é chamado logo após o método UserInfoDialog.makeDialog(), garantindo assim que todos os componentes gráficos já existam.

Overrides:

addDataComponentsListeners in class UserInfoDialog

confirmClose

protected boolean confirmClose()

Avisa o usuário de que há dados entrados não-salvos, e confirma se este deseja realmente sair ignorando os dados entrados, cancelar ou gravar suas alterações antes de fechar.
Se o usuário confirmar a inclusão, verifica se os dados requeridos estão preenchidos (ver UserInfoDialog.requiredFieldsAreFilled(). Se não estiverem, pede o preenchimento e cancela o fechamento.

Specified by:

confirmClose in class UserInfoDialog

Returns:

true caso o diálogo deva ser realmente fechado, ou false caso o usuário queira cancelar o fechamento para revisar suas alterações.

makeMiddlePanel

protected JPanel makeMiddlePanel()

Constrói o painel central, reservado para a entrada de informações complementares do usuário. Essa implementação retorna um painel vazio. Acrescenta os botões de seleção de permissões e seleção de perfis ao painel.

Overrides:

makeMiddlePanel in class UserInfoDialog

Returns:

painel central do diálogo.

sendUserInfoCallBackObject

protected void sendUserInfoCallBackObject(UserInfoCallBackInterface callBack)

Adiciona um KeyListener ao campo de login usando o callBack Object para devolver o conteúdo do campo à classe que o chamou.

Parameters:

callBack - o callback.

addUserInfo

protected void addUserInfo(csbase.logic.UserInfo info)

Carrega as informações de usuário nos campos de texto.

Parameters:

info - as informações de usuário

unsavedDataInput

protected boolean unsavedDataInput()

Verifica se houve entrada de dados não-salvos na interface.

Specified by:

unsavedDataInput in class UserInfoDialog

Returns:

true se e somente se todos os campos requeridos estiverem preenchidos, false caso contrário.

fireOnDataChanged

protected void fireOnDataChanged()

Método chamado sempre que algum dado for alterado.
Chama o método que trata o estado habilitado do botão de incluir usuário.

Overrides:

fireOnDataChanged in class UserInfoDialog

requiredFieldsAreFilled

protected boolean requiredFieldsAreFilled()

Description copied from class: UserInfoDialog

Indica se os campos requeridos estão preenchidos.

Overrides:

requiredFieldsAreFilled in class UserInfoDialog

Returns:

true se os campos requeridos estiverem preenchidos ou false se estiverem vazios.