csbase.client.project.action

Class CommonFileExportAction

java.lang.Object

javax.swing.AbstractAction

csbase.client.project.action.CommonProjectAction

csbase.client.project.action.CommonFileExportAction

All Implemented Interfaces:

ActionListener, Serializable, Cloneable, EventListener, Action

Direct Known Subclasses:

ExportFilesToDirAction, SingleFileExportAction

public abstract class CommonFileExportAction
extends CommonProjectAction

Ação para exportação de arquivos, a partir do projeto no servidor para o sistema de arquivos do cliente. Esta ação tenta primeiro acessar diretamente o sistema de arquivos, utilizando o JFileChooser. Caso não consiga (no caso dos jars não estarem assinados), utiliza a API JNLP.

Author:

Leonardo Barros

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	ACTION_NAME Nome da ação, para ser exibida em botões ou menus
protected static String	CRITICAL_ERROR Mensagem para erro de sistema.
protected static String	EMPTY_FILE Mensagem de aviso para arquivo de origem vazio.
protected static String	EXPORT_IN_PROGRESS_MSG Mensagem de notificação do início da exportação
protected static String	FILE_EXISTS Mensagem de aviso para arquivo de destino já existente
protected static String	JNLP_CANT_EXPORT_DIR Mensagem de erro para o caso em que se tentou exportar um diretório via JNLP.
protected static String	SINGLE_FILE_ERROR Mensagem de aviso para erro na exportação de um único arquivo
protected static String	SUCCESS Mensagem para exportação efetuada com sucesso
protected static String	SUCCESS_JNLP Mensagem para exportação via JNLP efetuada com sucesso
protected static String	TITLE Título do diálogo de exportação
protected static String	UPDATE_FILE Mensagem para atualização dos dados do arquivo.

Fields inherited from class csbase.client.project.action.CommonProjectAction

ERROR_DIALOG_TITLE, WAIT_DIALOG_TITLE

Fields inherited from class javax.swing.AbstractAction

changeSupport, enabled

Fields inherited from interface javax.swing.Action

ACCELERATOR_KEY, ACTION_COMMAND_KEY, DEFAULT, DISPLAYED_MNEMONIC_INDEX_KEY, LARGE_ICON_KEY, LONG_DESCRIPTION, MNEMONIC_KEY, NAME, SELECTED_KEY, SHORT_DESCRIPTION, SMALL_ICON

Constructor Summary

Constructors

Constructor and Description
CommonFileExportAction(ProjectFileContainer container) Cria a ação.

Method Summary

Methods

Modifier and Type	Method and Description
protected boolean	confirmEmptyFileExport(csbase.logic.ClientProjectFile sourceFile) Exibe uma mensagem avisando sobre a tentativa de exportar um arquivo vazio e solicita ao usuário que confirme a transferência.
protected boolean	confirmOverwrite(File targetFile) Exibe um diálogo para confirmar com o usuário se este deseja sobrescrever o arquivo existente.
protected double	getElapsedTime(long start) Obtém o tempo decorrido, em segundos, desde o início da execução.
protected long	getFileSize(csbase.logic.ClientProjectFile sourceFile) Obtém o tamanho de um arquivo diretamente do servidor.
String	getName() Obtém o nome da ação.
protected double	getTotalSizeInKBytes(long sizeInBytes) Obtém o volume total da transferência, em Kilobytes.
protected double	getTransferRate(double totalSize, double elapsedTime) Obtém a taxa de transferência, em Kbytes por segundo.
protected boolean	isDescendantOf(csbase.logic.ClientProjectFile descendant, csbase.logic.ClientProjectFile ancestor) Verifica se o primeiro arquivo é descendente do segundo, isto é, se está localizado debaixo do outro na árvore de diretórios.
protected Collection<csbase.logic.ClientProjectFile>	selectTopFiles(csbase.logic.ClientProjectFile[] selectedFiles) Seleciona, dentre os arquivos selecionados, os mais externos, isto é, que possivelmente contenham outros selecionados, para evitar redundâncias na exportação, já que diretórios com todo seu conteúdo são exportados.
protected void	showError(String msg) Método de aviso de erros de sistema.
protected void	showError(String msg, Exception ex) Método de aviso de erros de sistema.
protected boolean	transferFile(csbase.logic.ClientProjectFile sourceFile, File targetFile) Transfere um arquivo da área de projetos para o disco local.
protected boolean	transferFileUsingJNLP(csbase.logic.ClientProjectFile selectedFile) Transfere um arquivo usando JNLP.

Methods inherited from class csbase.client.project.action.CommonProjectAction

actionPerformed, clearClipboard, clearSelection, getFileChooser, getProject, getSelectedFile, getSelectedFiles, getSelectionCount, getTitle, getWindow, showError, showError, showError, startCopyAction, startCutAction, startPasteAction, startRenamingAction

Methods inherited from class javax.swing.AbstractAction

addPropertyChangeListener, clone, firePropertyChange, getKeys, getPropertyChangeListeners, getValue, isEnabled, putValue, removePropertyChangeListener, setEnabled

Methods inherited from class java.lang.Object

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

Field Detail

JNLP_CANT_EXPORT_DIR

protected static final String JNLP_CANT_EXPORT_DIR

Mensagem de erro para o caso em que se tentou exportar um diretório via JNLP.

See Also:

Constant Field Values

ACTION_NAME

protected static final String ACTION_NAME

Nome da ação, para ser exibida em botões ou menus

See Also:

Constant Field Values

CRITICAL_ERROR

protected static final String CRITICAL_ERROR

Mensagem para erro de sistema. Não é possível continuar.

See Also:

Constant Field Values

SINGLE_FILE_ERROR

protected static final String SINGLE_FILE_ERROR

Mensagem de aviso para erro na exportação de um único arquivo

See Also:

Constant Field Values

FILE_EXISTS

protected static final String FILE_EXISTS

Mensagem de aviso para arquivo de destino já existente

See Also:

Constant Field Values

EMPTY_FILE

protected static final String EMPTY_FILE

Mensagem de aviso para arquivo de origem vazio.

See Also:

Constant Field Values

EXPORT_IN_PROGRESS_MSG

protected static final String EXPORT_IN_PROGRESS_MSG

Mensagem de notificação do início da exportação

See Also:

Constant Field Values

SUCCESS

protected static final String SUCCESS

Mensagem para exportação efetuada com sucesso

See Also:

Constant Field Values

SUCCESS_JNLP

protected static final String SUCCESS_JNLP

Mensagem para exportação via JNLP efetuada com sucesso

See Also:

Constant Field Values

TITLE

protected static final String TITLE

Título do diálogo de exportação

See Also:

Constant Field Values

UPDATE_FILE

protected static final String UPDATE_FILE

Mensagem para atualização dos dados do arquivo.

See Also:

Constant Field Values

Constructor Detail

CommonFileExportAction

public CommonFileExportAction(ProjectFileContainer container)

Cria a ação.

Parameters:

container - objeto contendo arquivos de projeto.

Method Detail

showError

protected void showError(String msg)

Método de aviso de erros de sistema.

Overrides:

showError in class CommonProjectAction

Parameters:

msg - mensagem a ser exibida.

See Also:

CommonProjectAction.showError(Window, String, String)

showError

protected void showError(String msg,
             Exception ex)

Método de aviso de erros de sistema.

Parameters:

msg - mensagem a ser exibida.

ex - exceção detectada.

getTotalSizeInKBytes

protected double getTotalSizeInKBytes(long sizeInBytes)

Obtém o volume total da transferência, em Kilobytes.

Parameters:

sizeInBytes - volume total da transferência, em bytes.

Returns:

volume total dos arquivos transferidos (em KBytes).

getElapsedTime

protected double getElapsedTime(long start)

Obtém o tempo decorrido, em segundos, desde o início da execução.

Parameters:

start - tempo de início da execução (milissegundos desde 1970).

Returns:

tempo decorrido desde o início da execução (em segundos).

getTransferRate

protected double getTransferRate(double totalSize,
                     double elapsedTime)

Obtém a taxa de transferência, em Kbytes por segundo.

Parameters:

totalSize - volume tranferido (em KBytes).

elapsedTime - tempo decorrido (em segundos).

Returns:

taxa de transferência (em Kbytes/segundo).

selectTopFiles

protected Collection<csbase.logic.ClientProjectFile> selectTopFiles(csbase.logic.ClientProjectFile[] selectedFiles)

Seleciona, dentre os arquivos selecionados, os mais externos, isto é, que possivelmente contenham outros selecionados, para evitar redundâncias na exportação, já que diretórios com todo seu conteúdo são exportados.

Parameters:

selectedFiles - todos os arquivos selecionados.

Returns:

arquivos selecionados mais externos.

isDescendantOf

protected boolean isDescendantOf(csbase.logic.ClientProjectFile descendant,
                     csbase.logic.ClientProjectFile ancestor)

Verifica se o primeiro arquivo é descendente do segundo, isto é, se está localizado debaixo do outro na árvore de diretórios.

Parameters:

descendant - possível descendente.

ancestor - possível ancestral.

Returns:

true se o primeiro arquivo for descendente do segundo.

confirmOverwrite

protected boolean confirmOverwrite(File targetFile)

Exibe um diálogo para confirmar com o usuário se este deseja sobrescrever o arquivo existente.

Parameters:

targetFile - diretório de destino.

Returns:

true se o usuário confirmar, false caso contrário.

getName

public String getName()

Obtém o nome da ação.

Specified by:

getName in class CommonProjectAction

Returns:

nome da ação.

confirmEmptyFileExport

protected boolean confirmEmptyFileExport(csbase.logic.ClientProjectFile sourceFile)

Exibe uma mensagem avisando sobre a tentativa de exportar um arquivo vazio e solicita ao usuário que confirme a transferência.

Parameters:

sourceFile - arquivo vazio.

Returns:

true se o usuário confirmar que deseja continuar a transferência, mesmo sabendo que o arquivo está vazio.

getFileSize

protected long getFileSize(csbase.logic.ClientProjectFile sourceFile)

Obtém o tamanho de um arquivo diretamente do servidor.

Parameters:

sourceFile - - arquivo

Returns:

tamanho do arquivo ou -1 se houve alguma falha na comunicação com o servidor

transferFile

protected boolean transferFile(csbase.logic.ClientProjectFile sourceFile,
                   File targetFile)

Transfere um arquivo da área de projetos para o disco local. Os paths de origem e destino já foram devidamente configurados.

Parameters:

sourceFile - - referência no cliente para o arquivo a ser exportado

targetFile - - arquivo de destino no disco local

Returns:

flag indicando se a transferência foi bem-sucedida

transferFileUsingJNLP

protected boolean transferFileUsingJNLP(csbase.logic.ClientProjectFile selectedFile)

Transfere um arquivo usando JNLP. Diretórios não podem ser transferidos desta forma, e geram erro.

Parameters:

selectedFile - - arquivo a ser transferido

Returns:

flag indicando se a transferência foi bem sucedida