csbase.client.desktop

Class BasicDesktopFrame

java.lang.Object

csbase.client.desktop.DesktopFrame

csbase.client.desktop.BasicDesktopFrame

All Implemented Interfaces:

ClientUI, java.util.Observer

public class BasicDesktopFrame
extends DesktopFrame
implements java.util.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

Methods

Modifier and Type	Method and Description
protected void	addOptionalConfigItems(javax.swing.JMenu configMenu) Constrói itens opcionais do menu de configuração.
protected void	addOptionalMonitoringItems(javax.swing.JMenu monitoringMenu) Constrói itens opcionais do menu de monitoração.
protected javax.swing.JMenu	createDataRetrievalMenu() Constrói o submenu para recuperação de dados externos ao projeto.
protected java.util.List<javax.swing.JMenuItem>	createDiskMonitoringMenuItems() Itens para monitoração de espaço em disco
protected javax.swing.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 javax.swing.JMenu	createRecentProjectsMenu() Cria o Menu para abertura rápida de projetos abertos recentemente pelo usuário ("Abrir Recentes...").
void	exitApplication() Finaliza o cliente.
ApplicationPanel	getApplicationPanel() Consulta o valor de applicationPanel
protected java.lang.String	getProperty(java.lang.String name) Obtém uma propriedade opcional da classe.
void	showDesktop() Constrói e apresenta os componentes da interface principal do cliente.
void	shutdownDesktop(ProjectCloseAction projCloseAction) Fecha o projeto corrente (caso exista) antes de encerrar a aplicação cliente principal.
void	update(java.util.Observable o, java.lang.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, checkOpenableProject, configureDesktop, createDirectoryContentsPanel, createLookAndFeelDesktopSubmenu, createNotificationPanel, createProjectAutoUpdateItem, createRestoreDesktopItem, createShowTreeFilterItem, createTrayIcon, createTreeFilterPanel, displayTrayErrorMessage, displayTrayInfoMessage, displayTrayWarningMessage, enableIfAdminProject, enableIfProject, enableIfProjectOpened, getClientInstanceId, getConfiguration, getDefaultExitTrayMenuItem, getDefaultVisibilityTrayCheckMenuItem, getDesktopErrorImage, getDesktopFrame, getDesktopFrameIcon, getDesktopPreferences, getFatherClientInstanceId, getFileTypeFinder, getFrameImage, getInstance, getMenuBar, getProject, getRecentProjectOpenActions, getRecentProjects, getTitle, getTrayIcon, getTree, getView, isDesktopVisible, mustUpdateProjectTree, openProject, openProjectCreationDialog, openProjectUpdateDialog, postInitialization, preInitialization, removeWindow, saveDesktopPreferences, setCurrentProject, setDesktopErrorImage, setDesktopVisible, setFrameImage, setMenuBar, setShowHiddenFiles, setTitle, 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 java.lang.String getProperty(java.lang.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 javax.swing.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 javax.swing.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(javax.swing.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 java.util.List<javax.swing.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(javax.swing.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 javax.swing.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

shutdownDesktop

public void shutdownDesktop(ProjectCloseAction projCloseAction)

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

Parameters:

projCloseAction - ação de fechamento do projeto

update

public void update(java.util.Observable o,
          java.lang.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 java.util.Observer

Parameters:

o - .

arg - .

exitApplication

public void exitApplication()

Finaliza o cliente.