csbase.client.applicationmanager

Class ApplicationManager

java.lang.Object

csbase.client.applicationmanager.ApplicationManager

public final class ApplicationManager
extends Object

Classe que implementa o gerente de aplicações do cliente, que será representado por um singleton.

Author:

Tecgraf

Method Summary

Modifier and Type	Method and Description
void	addAsFavoriteApplication(String id) Adiciona uma aplicação como favorita
void	addListener(ApplicationManagerListener listener) Adição de listener
void	broadcastAsyncMessage(String type, Object value, String senderId) Envia uma mensagem assíncrona para a todas as aplicações.
JMenu	buildCategoryMenu(csbase.logic.applicationservice.ApplicationCategory cat) Constroi um menu com applicações de uma categoria.
AbstractAction	createApplicationAction(String aid) Construção de uam ação que dispare a aplicação
JMenuItem	createApplicationMenuItem(String aid, String text) Construção de umitem de menu que dispara uma aplicação.
void	delAsFavoriteApplication(String id) Remove uma aplicação como favorita
void	delListener(ApplicationManagerListener listener) Remoção de listener
boolean	finishAllApplications() Método que termina todas as aplicações registradas no ApplicationManager.
Hashtable<String,csbase.logic.applicationservice.ApplicationCategory>	getAllApplicationCategories() Retorna a hash table de categorias.
ArrayList<csbase.logic.applicationservice.ApplicationRegistry>	getAllApplicationRegistries() Obtém a lista completa dos registros de aplicação.
AbstractAction	getApplicationAction(csbase.logic.applicationservice.ApplicationRegistry reg) Obtém uma ação de disparo da aplicação.
ActionListener	getApplicationActionListener(csbase.logic.applicationservice.ApplicationRegistry reg) Obtém um ActionListener de disparo da aplicação.
csbase.logic.applicationservice.ApplicationCategory	getApplicationCategory(String id) Método para retorno categoria de aplicações
String	getApplicationDescription(csbase.logic.applicationservice.ApplicationRegistry applicationRegistry) Consulta a descrição de uma aplicação.
String[]	getApplicationEventQueue(ApplicationType application, String[] queue) Busca de um array para um event-log
String[]	getApplicationEventQueue(String id) Busca de um array para um event-log
String	getApplicationFullPackageName(csbase.logic.applicationservice.ApplicationRegistry reg) Utilitário para saber o nome o pacote (nome do diretório no fonte) aonde se encontra a aplicação.
ImageIcon	getApplicationIcon(String id) Busca do ícone configurada para a aplicação.
String	getApplicationId(Class<? extends ApplicationType> clazz) Consulta o id de uma aplicação com base na classe que a implementa.
ApplicationType	getApplicationInstance(String id) Obtém a instância da aplicação a partir do seu identificador.
ApplicationLink	getApplicationLink(csbase.logic.applicationservice.ApplicationRegistry reg) Obtém o link da aplicação.
String	getApplicationName(csbase.logic.applicationservice.ApplicationRegistry applicationRegistry) Consulta o nome de uma aplicação.
String	getApplicationPackageName(csbase.logic.applicationservice.ApplicationRegistry reg) Utilitário para saber o nome o pacote (nome do diretório no fonte) aonde se encontra a aplicação.
csbase.logic.applicationservice.ApplicationRegistry	getApplicationRegistry(String id) Método para retorno do registry de uma aplicação.
InputStream	getApplicationResource(Window parent, csbase.logic.applicationservice.ApplicationRegistry appRegistry, String[] resourcePath) Retorna um stream de entrada correspondente a um arquivo que se encontra no repositório da aplicação.
List<String>	getApplicationsFromType(String fileType) Obtem a aplicação correspondente ao tipo de arquivo.
String	getCategoryName(csbase.logic.applicationservice.ApplicationCategory category) Consulta o nome de uma categoria.
String	getClassInternalPath(csbase.logic.applicationservice.ApplicationRegistry reg, String relativePath) Obtém a representação de um caminho absoluto a partir raiz do sistema de uma representação relativa à raiz da aplicação.
List<String>	getFavoriteApplications() Consulta o valor de preferências para aplicações preferenciais.
static ApplicationManager	getInstance() Método que retorna a instância do gerente.
int	getInstanceIndex(ApplicationType app) Consulta o identificador de instância
Locale	getLocale() Obtem o locale das aplicações.
Hashtable<String,Vector<ApplicationType>>	getRunningApplications() Método de acesso para a lista de instâncias de aplicações em execução.
Vector<ApplicationType>	getRunningApplications(String id) Obtém um vetor com todas instâncias de uma determinada aplicação que estão executando.
boolean	hasApplicationRegistry(String id) Verfica se existe registro para aplicação com o id definido.
boolean	hasRunningApplications() Determina se existem aplicações em execução.
boolean	isAnyApplicationRunning(String id) Indica se existe pelo menos uma instância de uma determinada aplicação em execução.
boolean	isApplicationRunning(ApplicationType app) Indica se uma instância específica de uma aplicação está em execução.
boolean	isFavoriteApplication(String id) Consulta se aplicação (id) é favorita do usuário.
boolean	killApplication(ApplicationType app) Método para finalizar uma instância de aplicação.
void	notifyDeath(ApplicationType app) Método para notificação de fim de aplicação (via usuário) ao gerente de aplicações.
String	registerExternalApplication(String url, String type) Registra uma aplicação externa
void	runApplication(ApplicationType application) Executa uma aplicação.
<A extends ApplicationType> A	runApplication(Class<A> clazz) Método para criação de uma instância de aplicação com base em sua classe.
<A extends ApplicationType> A	runApplication(String id) Método para criação de uma instância de aplicação.
void	sendAsyncMessage(String appInstanceId, String type, Object value, String senderId) Envia uma mensagem assíncrona para a aplicação.
Object	sendSyncMessage(String appInstanceId, String type, Object value, String senderId) Envia uma mensagem síncrona para a aplicação.
static void	setInstance(Locale locale) Ajuste da instância
void	setProjectFlag(boolean hasProject) Ajuste de flag de necessidade de projeto.
boolean	unregisterExternalApplication(String id) Registra uma aplicação externa

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static ApplicationManager getInstance()

Método que retorna a instância do gerente.

Returns:

a instância.

setInstance

public static void setInstance(Locale locale)
                        throws RemoteException

Ajuste da instância

Parameters:

locale - o Locale desejado.

Throws:

RemoteException - em caso de falha.

addListener

public final void addListener(ApplicationManagerListener listener)

Adição de listener

Parameters:

listener - o listener

createApplicationAction

public AbstractAction createApplicationAction(String aid)

Construção de uam ação que dispare a aplicação

Parameters:

aid - o identificador da aplicação.

Returns:

a ação.

createApplicationMenuItem

public JMenuItem createApplicationMenuItem(String aid,
                                           String text)

Construção de umitem de menu que dispara uma aplicação.

Parameters:

aid - o identificador da aplicação.

text - .

Returns:

um item de menu.

delListener

public final void delListener(ApplicationManagerListener listener)

Remoção de listener

Parameters:

listener - o listener

finishAllApplications

public boolean finishAllApplications()

Método que termina todas as aplicações registradas no ApplicationManager.

Returns:

booleano que indica se as aplicações foram fechadas.

getAllApplicationRegistries

public final ArrayList<csbase.logic.applicationservice.ApplicationRegistry> getAllApplicationRegistries()

Obtém a lista completa dos registros de aplicação.

Returns:

a lista.

getApplicationEventQueue

public final String[] getApplicationEventQueue(String id)

Busca de um array para um event-log

Parameters:

id - id

Returns:

a nova lista de strings

getApplicationsFromType

public List<String> getApplicationsFromType(String fileType)

Obtem a aplicação correspondente ao tipo de arquivo.

Parameters:

fileType - o tipo de arquivo.

Returns:

o identificador da aplicação.

getApplicationIcon

public ImageIcon getApplicationIcon(String id)

Busca do ícone configurada para a aplicação.

Parameters:

id - identificador da aplicação.

Returns:

.

getApplicationRegistry

public csbase.logic.applicationservice.ApplicationRegistry getApplicationRegistry(String id)

Método para retorno do registry de uma aplicação.

Parameters:

id - o identificador de aplicação.

Returns:

o registro.

hasApplicationRegistry

public boolean hasApplicationRegistry(String id)

Verfica se existe registro para aplicação com o id definido.

Parameters:

id - o id.

Returns:

verdeiro se o registro existe ou falso, caso contrário.

getApplicationCategory

public csbase.logic.applicationservice.ApplicationCategory getApplicationCategory(String id)

Método para retorno categoria de aplicações

Parameters:

id - o identificador

Returns:

a categoria.

getAllApplicationCategories

public Hashtable<String,csbase.logic.applicationservice.ApplicationCategory> getAllApplicationCategories()

Retorna a hash table de categorias.

Returns:

a tabela.

getApplicationEventQueue

public final String[] getApplicationEventQueue(ApplicationType application,
                                               String[] queue)

Busca de um array para um event-log

Parameters:

application - aplicativo

queue - tag

Returns:

a nova lista de strings

getInstanceIndex

public final int getInstanceIndex(ApplicationType app)

Consulta o identificador de instância

Parameters:

app - aplicação.

Returns:

id o identificador se a aplicação estiver rodando, ou um valor negativo caso contrário.

getLocale

public Locale getLocale()

Obtem o locale das aplicações.

Returns:

um locale.

getRunningApplications

public final Hashtable<String,Vector<ApplicationType>> getRunningApplications()

Método de acesso para a lista de instâncias de aplicações em execução.

Returns:

Lista de instâncias de aplicações em execução.

hasRunningApplications

public final boolean hasRunningApplications()

Determina se existem aplicações em execução.

Returns:

true caso existam aplicações em execução no momento ou false, caso contrário.

getRunningApplications

public Vector<ApplicationType> getRunningApplications(String id)

Obtém um vetor com todas instâncias de uma determinada aplicação que estão executando.

Parameters:

id - identificador da aplicação

Returns:

vetor com todas instâncias em execução de uma determinada aplicação que estão

isAnyApplicationRunning

public boolean isAnyApplicationRunning(String id)

Indica se existe pelo menos uma instância de uma determinada aplicação em execução.

Parameters:

id - ID da aplicação

Returns:

true se existe alguma instância da aplicação em execução

See Also:

isApplicationRunning(ApplicationType)

isApplicationRunning

public boolean isApplicationRunning(ApplicationType app)

Indica se uma instância específica de uma aplicação está em execução.

Parameters:

app - instância da aplicação

Returns:

true se a instância da aplicação está em execução

killApplication

public boolean killApplication(ApplicationType app)

Método para finalizar uma instância de aplicação.

Parameters:

app - a instância a ser finalizada

Returns:

flag de sucesso da operação.

notifyDeath

public void notifyDeath(ApplicationType app)

Método para notificação de fim de aplicação (via usuário) ao gerente de aplicações.

Parameters:

app - a aplicação

runApplication

public void runApplication(ApplicationType application)
                    throws ApplicationException

Executa uma aplicação.

Parameters:

application - A aplicação.

Throws:

ApplicationException - Em caso de erro ao executar a aplicação.

runApplication

public final <A extends ApplicationType> A runApplication(String id)
                                                   throws ApplicationException

Método para criação de uma instância de aplicação. Extraordinariamente, este método inibe warning de unchecked type, pois precisa fazer um cast explícito para o tipo (classe) que efetivamente define a aplicação.

Type Parameters:

A - a classe da aplicação chamada.

Parameters:

id - o identificador da aplicação.

Returns:

a aplicação instanciada.

Throws:

ApplicationException - se houver falha no lançamento da aplicação.

runApplication

public <A extends ApplicationType> A runApplication(Class<A> clazz)
                                             throws ApplicationException

Método para criação de uma instância de aplicação com base em sua classe.

Type Parameters:

A - classe da aplicação

Parameters:

clazz - classe

Returns:

a instância executada.

Throws:

ApplicationException - se houver falha no lançamento.

setProjectFlag

public void setProjectFlag(boolean hasProject)

Ajuste de flag de necessidade de projeto.

Parameters:

hasProject - flag indicativo.

getApplicationLink

public final ApplicationLink getApplicationLink(csbase.logic.applicationservice.ApplicationRegistry reg)

Obtém o link da aplicação.

Parameters:

reg - registry

Returns:

o link.

getClassInternalPath

public final String getClassInternalPath(csbase.logic.applicationservice.ApplicationRegistry reg,
                                         String relativePath)

Obtém a representação de um caminho absoluto a partir raiz do sistema de uma representação relativa à raiz da aplicação.

Parameters:

reg - o registro da aplicação.

relativePath - o caminho relativo à raiz da aplicação (ex: resources/Notepad_pt_BR.properties).

Returns:

o caminho relativo à raiz do sistema (ex: /csbase/client/applications/notepad/resources/ Notepad_pt_BR.properties).

getApplicationFullPackageName

public final String getApplicationFullPackageName(csbase.logic.applicationservice.ApplicationRegistry reg)

Utilitário para saber o nome o pacote (nome do diretório no fonte) aonde se encontra a aplicação.

Parameters:

reg - regsitry

Returns:

nome do pacote

getApplicationPackageName

public final String getApplicationPackageName(csbase.logic.applicationservice.ApplicationRegistry reg)

Utilitário para saber o nome o pacote (nome do diretório no fonte) aonde se encontra a aplicação.

Parameters:

reg - regsitry

Returns:

nome do pacote

getApplicationAction

public final AbstractAction getApplicationAction(csbase.logic.applicationservice.ApplicationRegistry reg)

Obtém uma ação de disparo da aplicação.

Parameters:

reg - registry

Returns:

a ação.

getApplicationActionListener

public final ActionListener getApplicationActionListener(csbase.logic.applicationservice.ApplicationRegistry reg)

Obtém um ActionListener de disparo da aplicação.

Parameters:

reg - registry

Returns:

a ação.

getApplicationName

public String getApplicationName(csbase.logic.applicationservice.ApplicationRegistry applicationRegistry)

Consulta o nome de uma aplicação.

Parameters:

applicationRegistry - registry

Returns:

nome

getCategoryName

public String getCategoryName(csbase.logic.applicationservice.ApplicationCategory category)

Consulta o nome de uma categoria.

Parameters:

category - category

Returns:

nome

getApplicationDescription

public String getApplicationDescription(csbase.logic.applicationservice.ApplicationRegistry applicationRegistry)

Consulta a descrição de uma aplicação.

Parameters:

applicationRegistry - registry

Returns:

descrição

getApplicationId

public String getApplicationId(Class<? extends ApplicationType> clazz)

Consulta o id de uma aplicação com base na classe que a implementa.

Parameters:

clazz - classe da aplicação

Returns:

o id da aplicação (se registrada) ou null.

buildCategoryMenu

public final JMenu buildCategoryMenu(csbase.logic.applicationservice.ApplicationCategory cat)

Constroi um menu com applicações de uma categoria.

Parameters:

cat - categoria

Returns:

menu

getApplicationResource

public InputStream getApplicationResource(Window parent,
                                          csbase.logic.applicationservice.ApplicationRegistry appRegistry,
                                          String[] resourcePath)

Retorna um stream de entrada correspondente a um arquivo que se encontra no repositório da aplicação. NOTA: É necessário fechar o stream de entrada retornado por este método.

Parameters:

parent - - janela pai usada na task que faz a consulta ao servidor.

appRegistry - - registro da aplicação.

resourcePath - - path do arquivo.

Returns:

stream de entrada correspondente ao arquivo.

isFavoriteApplication

public final boolean isFavoriteApplication(String id)

Consulta se aplicação (id) é favorita do usuário.

Parameters:

id - id

Returns:

indicativo

getFavoriteApplications

public final List<String> getFavoriteApplications()

Consulta o valor de preferências para aplicações preferenciais.

Returns:

valor de preferencias

addAsFavoriteApplication

public final void addAsFavoriteApplication(String id)

Adiciona uma aplicação como favorita

Parameters:

id - id da aplicação

delAsFavoriteApplication

public final void delAsFavoriteApplication(String id)

Remove uma aplicação como favorita

Parameters:

id - id da aplicação

getApplicationInstance

public ApplicationType getApplicationInstance(String id)

Obtém a instância da aplicação a partir do seu identificador.

Parameters:

id - o identificador.

Returns:

a instância.

sendAsyncMessage

public void sendAsyncMessage(String appInstanceId,
                             String type,
                             Object value,
                             String senderId)

Envia uma mensagem assíncrona para a aplicação.

Parameters:

appInstanceId - id da instância da aplicação.

type - tipo da mensagem.

value - valor da mensagem.

senderId - id da aplicação de origem da mensagem.

broadcastAsyncMessage

public void broadcastAsyncMessage(String type,
                                  Object value,
                                  String senderId)

Envia uma mensagem assíncrona para a todas as aplicações.

Parameters:

type - tipo da mensagem.

value - valor da mensagem.

senderId - id da aplicação de origem da mensagem.

sendSyncMessage

public Object sendSyncMessage(String appInstanceId,
                              String type,
                              Object value,
                              String senderId)

Envia uma mensagem síncrona para a aplicação.

Parameters:

appInstanceId - id da instância da aplicação.

type - tipo da mensagem.

value - valor da mensagem.

senderId - id da aplicação de origem da mensagem.

Returns:

A resposta dapa pela aplicação

registerExternalApplication

public String registerExternalApplication(String url,
                                          String type)

Registra uma aplicação externa

Parameters:

url - O caminho onde está a aplicação externa

type - O tipo da aplicação

Returns:

O id associado a aplicação

unregisterExternalApplication

public boolean unregisterExternalApplication(String id)

Registra uma aplicação externa

Parameters:

id - O ID da aplicação

Returns:

true caso a aplicação estava previamente registrada, false caso contrario