csbase.client.desktop

Class Task<R>

java.lang.Object

tecgraf.javautils.gui.Task<R>

csbase.client.desktop.Task<R>

Type Parameters:

R - A classe do resultado da tarefa.

All Implemented Interfaces:

java.lang.Runnable

Direct Known Subclasses:

LocalTask, RemoteTask

public abstract class Task<R>
extends tecgraf.javautils.gui.Task<R>

A classe Task modela uma tarefa possivelmente demorada executada no cliente. Uma thread é criada para a execução da tarefa, para que eventos de interface (como redesenho) possam ser atendidos. As interações de teclado e mouse, contudo, são bloqueadas. Caso a duração da tarefa ultrapasse um valor limite configurável, um diálogo modal contendo uma barra de progresso será exibido. Este diálogo será fechado automaticamente ao final da tarefa. Após um intervalo de valor configurável, um botão para fechamento do diálogo é oferecido ao usuário. O texto do botão (Fechar ou Cancelar) é também configurável, pois depende do tipo de tarefa, e do efeito de seu fechamento. Essa classe permite aninhamento. Isto é, se dentro do método performTask uma outra tarefa for criada e executada, o retorno visual para seu acompanhamento é dado na mesma janela da tarefa anterior, evitando que múltiplas janelas de acompanhamento sejam abertas. É importante notar que tarefas aninhadas devem, obrigatoriamente, usar os métodos beforeTaskUI e afterTaskUI para qualquer código que atue sobre a interface gráfica.

Author:

Tecgraf/PUC-Rio

Field Summary

Fields inherited from class tecgraf.javautils.gui.Task

CANCEL_BUTTON, CLOSE_BUTTON, DEFAULT_CANCEL_DELAY, parentWindow, progressBar, progressDialog, taskTitle, textPane

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Task() Construtor.
protected	Task(java.awt.Dialog.ModalityType modality) Construtor.

Method Summary

Methods

Modifier and Type	Method and Description
protected int	getCancelDelaySecs()
protected java.awt.Window	getDefaultParentWindow()
protected void	handleError(java.lang.Exception error) Tratamento de erros específico para cada tipo de tarefa.

Methods inherited from class tecgraf.javautils.gui.Task

afterTaskUI, beforeTaskUI, cancelTask, execute, execute, execute, execute, execute, execute, executeNonBlocking, getAdditionalInfo, getError, getProgressDialogDelay, getResult, getStatus, getTaskMessage, performTask, run, setProgressDialogDelay, setProgressDialogEnabled, setProgressStatus, setResult, setStepText, setUnknownStatus, wasCancelled

Methods inherited from class java.lang.Object

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

Constructor Detail

Task

protected Task()

Construtor.

Task

protected Task(java.awt.Dialog.ModalityType modality)

Construtor.

Parameters:

modality - tipo de bloqueio das janelas

Method Detail

getDefaultParentWindow

protected java.awt.Window getDefaultParentWindow()

Overrides:

getDefaultParentWindow in class tecgraf.javautils.gui.Task<R>

handleError

protected void handleError(java.lang.Exception error)

Tratamento de erros específico para cada tipo de tarefa. Esse tratamento é chamado na EDT. Essa implementação representa um tratamento mínimo, apenas para erros no cliente. Qualquer exceção lançada durante a execução do método performTask é repassada para este método para tratamento.

Overrides:

handleError in class tecgraf.javautils.gui.Task<R>

Parameters:

error - - exceção que representa o erro durante execução da tarefa.

getCancelDelaySecs

protected int getCancelDelaySecs()

Overrides:

getCancelDelaySecs in class tecgraf.javautils.gui.Task<R>