csbase.client.desktop

Class BasicDesktopFrame

java.lang.Object

csbase.client.desktop.DesktopFrame

csbase.client.desktop.BasicDesktopFrame

All Implemented Interfaces:

ClientUI, Observer

public class BasicDesktopFrame
extends DesktopFrame
implements Observer

A classe BasicDesktopFrame implementa a interface principal do sistema no lado cliente. Ela provê a funcionalidade mínima comum a qualquer sistema desenvolvido com base no CSBase. A configuração deste componente (específica para cada sistema) compreende: - o título do desktop e a imagem a ele associada - a localização dos arquivos de propriedades que configuram as aplicações e os grupos de aplicações.

Author:

Tecgraf/PUC-Rio

Field Summary

Fields inherited from class csbase.client.desktop.DesktopFrame

adminFrame, connMonitorListener, dirContentsPanel, notifPanel, projectTree, projectTreePanel, splitPaneBetweenAppAndNotif, splitPaneBetweenTreeAndApp, splitPaneBetweenTreeAndTable, treeFilterPanel

Constructor Summary

Constructors

Constructor and Description
BasicDesktopFrame() Constrói a interface principal do cliente.

Method Summary

Modifier and Type	Method and Description
protected void	addOptionalConfigItems(JMenu configMenu) Constrói itens opcionais do menu de configuração.
protected void	addOptionalMonitoringItems(JMenu monitoringMenu) Constrói itens opcionais do menu de monitoração.
boolean	confirmShutdown() Finaliza o cliente.
protected JMenu	createDataRetrievalMenu() Constrói o submenu para recuperação de dados externos ao projeto.
protected List<JMenuItem>	createDiskMonitoringMenuItems() Itens para monitoração de espaço em disco
protected JMenu	createOptionalMenu() Cria menu opcional no final da barra de menu quando sobrescrito pelas subclasses.
protected void	createProjectTreeFactory() Cria uma fábrica de árvores de projeto.
protected JMenu	createRecentProjectsMenu() Cria o Menu para abertura rápida de projetos abertos recentemente pelo usuário ("Abrir Recentes...").
ApplicationPanel	getApplicationPanel() Consulta o valor de applicationPanel
protected String	getProperty(String name) Obtém uma propriedade opcional da classe.
void	prepareShutdown() Realiza açoes necessárias ao encerramento da aplicação cliente principal.
void	showDesktop() Constrói e apresenta os componentes da interface principal do cliente.
boolean	shutdownProject() Fecha o projeto corrente (caso exista) antes de encerrar a aplicação cliente principal.
void	update(Observable o, Object arg) Este método é chamado nas seguintes situações: 1 - Um projeto do usuário é criado 2 - Um projeto do usuário é removido 3 - O usuário é adicionado ou removido de um projeto 4 - Um projeto do qual o usuário participa é removido Desta forma, habilita ou desabilita os itens do menu Projeto "(Abrir) Do Usuário" e "(Abrir) De outros usuários".

Methods inherited from class csbase.client.desktop.DesktopFrame

addWindow, adjustTitle, adjustTrayIcon, checkOpenableProject, closeProject, configureDesktop, createDirectoryContentsPanel, createLookAndFeelDesktopSubmenu, createNotificationPanel, createProjectAutoUpdateItem, createRestoreDesktopItem, createShowTreeFilterItem, createTrayIcon, createTrayIconItem, createTreeFilterPanel, displayTrayErrorMessage, displayTrayInfoMessage, displayTrayWarningMessage, enableIfAdminProject, enableIfProject, enableIfProjectOpened, getClientInstanceId, getConfiguration, getDefaultExitTrayMenuItem, getDefaultVisibilityTrayCheckMenuItem, getDesktopErrorImage, getDesktopFrame, getDesktopFrameIcon, getDesktopPreferences, getFatherClientInstanceId, getFileTypeFinder, getFrameImage, getInstance, getMenuBar, getNotificationPanel, getProject, getRecentProjectOpenActions, getRecentProjects, getTitle, getTrayIcon, getTree, getView, isDesktopVisible, isTrayIconSupported, mustUpdateProjectTree, openProject, openProjectCreationDialog, openProjectUpdateDialog, postInitialization, preInitialization, removeWindow, saveDesktopPreferences, setCurrentProject, setDesktopErrorImage, setDesktopVisible, setFrameImage, setMenuBar, setShouldExpandDataset, setShowHiddenFiles, setTitle, shouldExpandDataset, shouldShowHiddenFiles, showUI, shutdownDesktop, startServicesObservers, stopServicesObservers, userHasOthersProject, userHasProject

Methods inherited from class java.lang.Object

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

Constructor Detail

BasicDesktopFrame

public BasicDesktopFrame()
                  throws ClientException

Constrói a interface principal do cliente.

Throws:

ClientException - em caso de falha.

Method Detail

getProperty

protected String getProperty(String name)

Obtém uma propriedade opcional da classe.

Parameters:

name - nome da propriedade

Returns:

uma propriedade opcional da classe

getApplicationPanel

public final ApplicationPanel getApplicationPanel()

Consulta o valor de applicationPanel

Returns:

o valor

createProjectTreeFactory

protected void createProjectTreeFactory()

Cria uma fábrica de árvores de projeto.

createRecentProjectsMenu

protected JMenu createRecentProjectsMenu()

Cria o Menu para abertura rápida de projetos abertos recentemente pelo usuário ("Abrir Recentes..."). Cadastra um listener em ProjectTree para que seja atualizado a cada mudança de projeto.

Returns:

O menu

createDataRetrievalMenu

protected JMenu createDataRetrievalMenu()

Constrói o submenu para recuperação de dados externos ao projeto. O desktop básico não oferece nenhuma fonte de obtenção de dados. Em alguns sistemas, dados podem ser obtidos a partir de bases de dados, ou outras fontes. Neste caso, este método deve ser redefinido. Caso algum sistema não queira exibir este menu, este método deve ser redefinido para retornar null.

Returns:

o menu de recuperação de dados ou null para omitir este menu.

addOptionalMonitoringItems

protected void addOptionalMonitoringItems(JMenu monitoringMenu)

Constrói itens opcionais do menu de monitoração. Esses itens serão adicionados no final do menu

Parameters:

monitoringMenu - o menu de monitoração

createDiskMonitoringMenuItems

protected List<JMenuItem> createDiskMonitoringMenuItems()

Itens para monitoração de espaço em disco

Returns:

uma lista com os itens de monitoração de espaço em disco

showDesktop

public void showDesktop()

Constrói e apresenta os componentes da interface principal do cliente.

Overrides:

showDesktop in class DesktopFrame

addOptionalConfigItems

protected void addOptionalConfigItems(JMenu configMenu)

Constrói itens opcionais do menu de configuração. Esses itens serão adicionados no início do menu

Parameters:

configMenu - o menu de configuração

createOptionalMenu

protected JMenu createOptionalMenu()

Cria menu opcional no final da barra de menu quando sobrescrito pelas subclasses. A implementação padrão retorna null.

Returns:

menu opcional

shutdownProject

public boolean shutdownProject()

Fecha o projeto corrente (caso exista) antes de encerrar a aplicação cliente principal.

Overrides:

shutdownProject in class DesktopFrame

Returns:

booleano que indica se o projeto foi fechado.

prepareShutdown

public void prepareShutdown()

Realiza açoes necessárias ao encerramento da aplicação cliente principal.

Overrides:

prepareShutdown in class DesktopFrame

update

public void update(Observable o,
                   Object arg)

Este método é chamado nas seguintes situações: 1 - Um projeto do usuário é criado 2 - Um projeto do usuário é removido 3 - O usuário é adicionado ou removido de um projeto 4 - Um projeto do qual o usuário participa é removido Desta forma, habilita ou desabilita os itens do menu Projeto "(Abrir) Do Usuário" e "(Abrir) De outros usuários".

Specified by:

update in interface Observer

Parameters:

o - .

arg - .

confirmShutdown

public boolean confirmShutdown()

Finaliza o cliente.

Overrides:

confirmShutdown in class DesktopFrame

Returns:

booleano que indica se o encerramento foi confirmado pelo usuário.