csbase.client.externalresources

Class ExternalResources

java.lang.Object

csbase.client.externalresources.ExternalResources

public final class ExternalResources
extends java.lang.Object

Representa o ponto de acesso à recursos externos ao cliente CSBase. Esses recursos são arquivos no sistema de arquivos local e exibição de URL's.

Author:

Tecgraf/PUC-Rio

Method Summary

Modifier and Type	Method and Description
java.net.URL	getCodeBase() Obtém a URL que representa o codebase, definido no arquivo jnlp.
static ExternalResources	getInstance() Obtém a instância única.
boolean	isEnabled() Verifica se os recursos externos estão habilitados.
LocalFile	openFileDialog(java.lang.String pathHint, java.lang.String[] extensions) Abre um diálogo para que o usuário escolha um arquivo que será importado para o CSBase.
LocalFile[]	openMultiFileDialog(java.lang.String pathHint, java.lang.String[] extensions) Abre um diálogo para que o usuário escolha alguns arquivos que serão importados para o CSBase.
LocalFile	saveAsFileDialog(java.lang.String pathHint, java.lang.String[] extensions, JNLPLocalFile localFile) Abre um diálogo para que o usuário escolha um arquivo que será salvo a partir de um arquivo do CSBase.
LocalFile	saveFileDialog(java.lang.String pathHint, java.lang.String[] extensions, java.io.InputStream inputStream, java.lang.String name) Abre um diálogo para que o usuário escolha um arquivo que será salvo a partir de um arquivo do CSBase.
boolean	showDocument(java.net.URL url) Exibe uma URL no browser do cliente.

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static ExternalResources getInstance()

Obtém a instância única.

Returns:

A instância única.

isEnabled

public boolean isEnabled()

Verifica se os recursos externos estão habilitados.

Returns:

true, caso os recursos externos estejam habilitados, ou false, caso contrário.

showDocument

public boolean showDocument(java.net.URL url)
                     throws csbase.exception.CSBaseException

Exibe uma URL no browser do cliente.

Parameters:

url - A URL a ser exibida.

Returns:

true, se conseguiu exibir a URL, ou false, caso contrário.

Throws:

csbase.exception.CSBaseException - Caso ocorra algum erro durante o procedimento.

getCodeBase

public java.net.URL getCodeBase()
                         throws csbase.exception.CSBaseException

Obtém a URL que representa o codebase, definido no arquivo jnlp.

Returns:

O codebase para a aplicação.

Throws:

csbase.exception.CSBaseException - Caso ocorra algum erro durante o procedimento.

openFileDialog

public LocalFile openFileDialog(java.lang.String pathHint,
                                java.lang.String[] extensions)
                         throws java.io.IOException,
                                csbase.exception.CSBaseException

Abre um diálogo para que o usuário escolha um arquivo que será importado para o CSBase.

Parameters:

pathHint - Uma dica de onde será o diretório inicial apresentado pelo diálogo.

extensions - Um array com as extensões mostradas pelo diálogo.

Returns:

O arquivo escolhido pelo usuário, ou null, caso o usuário cancele o diálogo.

Throws:

java.io.IOException - Caso ocorra algum problema ao abrir o arquivo.

csbase.exception.CSBaseException - Caso o serviço esteja indisponível.

openMultiFileDialog

public LocalFile[] openMultiFileDialog(java.lang.String pathHint,
                                       java.lang.String[] extensions)
                                throws java.io.IOException,
                                       csbase.exception.CSBaseException

Abre um diálogo para que o usuário escolha alguns arquivos que serão importados para o CSBase.

Parameters:

pathHint - Uma dica de onde será o diretório inicial apresentado pelo diálogo.

extensions - Um array com as extensões mostradas pelo diálogo.

Returns:

Os arquivos escolhidos pelo usuário, ou null, caso o usuário cancele o diálogo.

Throws:

java.io.IOException - Caso ocorra algum problema ao abrir o arquivo.

csbase.exception.CSBaseException - Caso o serviço esteja indisponível.

saveFileDialog

public LocalFile saveFileDialog(java.lang.String pathHint,
                                java.lang.String[] extensions,
                                java.io.InputStream inputStream,
                                java.lang.String name)
                         throws csbase.exception.CSBaseException,
                                java.io.IOException

Abre um diálogo para que o usuário escolha um arquivo que será salvo a partir de um arquivo do CSBase.

Parameters:

pathHint - Uma dica de onde será o diretório inicial apresentado pelo diálogo.

extensions - Um array com as extensões mostradas pelo diálogo.

inputStream - O fluxo de entrada com os dados que serão escritos no arquivo escolhido pelo usuário.

name - Uma sugestão de nome para o arquivo que o usuário estará salvando.

Returns:

O arquivo escolhido pelo usuário, ou null, caso o usuário cancele o diálogo.

Throws:

csbase.exception.CSBaseException - Caso o serviço esteja indisponível.

java.io.IOException - Caso ocorra algum problema ao abrir o arquivo.

saveAsFileDialog

public LocalFile saveAsFileDialog(java.lang.String pathHint,
                                  java.lang.String[] extensions,
                                  JNLPLocalFile localFile)
                           throws csbase.exception.CSBaseException,
                                  java.io.IOException

Abre um diálogo para que o usuário escolha um arquivo que será salvo a partir de um arquivo do CSBase.

Parameters:

pathHint - Uma dica de onde será o diretório inicial apresentado pelo diálogo.

extensions - Um array com as extensões mostradas pelo diálogo.

localFile - Um arquivo que foi salvo anteriormente utilizando o método saveFileDialog(String, String[], InputStream, String);

Returns:

O arquivo escolhido pelo usuário, ou null, caso o usuário cancele o diálogo.

Throws:

csbase.exception.CSBaseException - Caso o serviço esteja indisponível.

java.io.IOException - Caso ocorra algum problema ao abrir o arquivo.