csbase.client.ias

Class UserInfoDialog

java.lang.Object

csbase.client.ias.UserInfoDialog

Direct Known Subclasses:

IncludeUserInfoDialog, ModifyUserInfoDialog

public abstract class UserInfoDialog
extends Object

Classe abstrata que representa o que há de comum aos diálogos que exibem dados de um usuário.

Author:

Marcus Leal

Field Summary

Fields

Modifier and Type	Field and Description
protected JTextField	addEmailTf Campo utilizado para conter e-mails que serão armazenados na lista.
protected String	dialogTitle Título para o diálogo e seus subdiálogos
protected DefaultListModel	emailsModel Modelo da lista que contém os e-mails do usuário.
protected JTextField	login Campo login do usuário
protected JTextField	name Campo nome do usuário
protected Window	ownerWindow Janela que criou o diálogo
protected csbase.logic.UserInfo	userInfo Objeto que centraliza as informações do usuário (padrão Data Transfer Object - DTO), compartilhadas entre esse diálogo e seus diálogos de informações complementares (diálogos de perfis, permissões e senha)
protected DesktopComponentDialog	userInfoDialog Instância do diálogo

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	UserInfoDialog(Window ownerWindow, String dialogTitle) Construtor que inicializa atributos comuns (referência para a janela-pai, título do diálogo e DTO de informaços do usuário).

Method Summary

Methods

Modifier and Type	Method and Description
protected void	addDataComponentsListeners() Adiciona observadores aos componentes que mantém os dados do usuário.
void	addEmail() Pega o e-mail digitado no campo #addEmailTf e o adiciona na lista de e-mails.
protected abstract 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.
protected void	fireOnDataChanged() Método chamado sempre que algum dado for alterado.
protected JTextField	getLogin()
DesktopComponentDialog	getUserInfoDialog()
protected JButton	makeCloseButton() Cria o botão de fechamento da janela, atribuindo-lhe como ação o método close().
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".
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 JPanel	makeUpperPanel() Constrói o painel superior contendo as principais informações do usuário (login, nome e e-mail).
protected boolean	requiredFieldsAreFilled() Indica se os campos requeridos estão preenchidos.
void	setVisible(boolean b) Exibe/esconde o diálogo.
protected abstract 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 java.lang.Object

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

Field Detail

userInfoDialog

protected DesktopComponentDialog userInfoDialog

Instância do diálogo

ownerWindow

protected Window ownerWindow

Janela que criou o diálogo

name

protected JTextField name

Campo nome do usuário

login

protected JTextField login

Campo login do usuário

emailsModel

protected DefaultListModel emailsModel

Modelo da lista que contém os e-mails do usuário.

addEmailTf

protected JTextField addEmailTf

Campo utilizado para conter e-mails que serão armazenados na lista.

dialogTitle

protected String dialogTitle

Título para o diálogo e seus subdiálogos

userInfo

protected csbase.logic.UserInfo userInfo

Objeto que centraliza as informações do usuário (padrão Data Transfer Object - DTO), compartilhadas entre esse diálogo e seus diálogos de informações complementares (diálogos de perfis, permissões e senha)

Constructor Detail

UserInfoDialog

protected UserInfoDialog(Window ownerWindow,
              String dialogTitle)

Construtor que inicializa atributos comuns (referência para a janela-pai, título do diálogo e DTO de informaços do usuário).

Parameters:

ownerWindow - janela que criou este diálogo.

dialogTitle - título deste diálogo, usado também em alguns dos seus subdiálogos.

Method Detail

setVisible

public void setVisible(boolean b)

Exibe/esconde o diálogo. Se o diálogo ainda não tiver sido construído, realiza essa tarefa antes de invocar as operações de visibilidade.

Parameters:

b - indica se o diálogo deve estar visível (true) ou invisível (false).

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 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 fireOnDataChanged().

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

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 close() ao fechar.

See Also:

close()

getUserInfoDialog

public DesktopComponentDialog getUserInfoDialog()

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 addDataComponentsListeners() e updateUserInfo().

Returns:

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

See Also:

addDataComponentsListeners()

addEmail

public void addEmail()

Pega o e-mail digitado no campo #addEmailTf e o adiciona na lista de e-mails.

makeUpperPanel

protected JPanel makeUpperPanel()

Constrói o painel superior contendo as principais informações do usuário (login, nome e e-mail).

Returns:

o painel superior do diálogo.

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.

Returns:

painel central do diálogo.

makeCloseButton

protected JButton makeCloseButton()

Cria o botão de fechamento da janela, atribuindo-lhe como ação o método close().

Returns:

o botão de fechamento.

See Also:

close()

requiredFieldsAreFilled

protected boolean requiredFieldsAreFilled()

Indica se os campos requeridos estão preenchidos.

Returns:

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

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 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.

See Also:

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).

Returns:

o painel inferior do diálogo.

getLogin

protected JTextField getLogin()

fireOnDataChanged

protected void fireOnDataChanged()

Método chamado sempre que algum dado for alterado.

unsavedDataInput

protected abstract boolean unsavedDataInput()

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

Returns:

true se algum dado foi editado ou false caso contrário

confirmClose

protected abstract 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.

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.