com.ontimize.gui

Class OperationThread

java.lang.Object

java.lang.Thread

com.ontimize.gui.OperationThread

All Implemented Interfaces:

Runnable

Direct Known Subclasses:

ExtendedOperationThread, UploadFileThread

public class OperationThread
extends Thread

Basic Thread implementation that performs an operation and stores the result into an EntityResult class.
The operation must be performed in the Thread.run() method, and the result must be stored in an OperationThread variable called res.
The run method must set the right operation status, such as hasFinished, hasStarted, cancelled , etc. An implementation example could be
public void run() {
hasStarted=true;
// Perform operation. The finish check is done with isAlive() hasFinished=true;
}


Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Thread

Thread.State, Thread.UncaughtExceptionHandler

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	cancelled
String	description
protected boolean	hasFinished
protected boolean	hasStarted
static String	OPERATION_CANCELLED
protected Object	res
protected String	status
protected Thread	t

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
OperationThread() Constructor.
OperationThread(String description) Sets a description to the thread

Method Summary

Methods

Modifier and Type	Method and Description
void	cancel() Sets the thread status as canceled.
String	getDescription() Returns the thread description
Object	getResult() Returns the thread result.
String	getStatus() Returns the thread status, which is a message referent to the thread situation.
boolean	hasFinished() Checks whether the thread has finished.
boolean	hasStarted() Checks whether the thread has started.
boolean	isCancelled() Checks whether the thread has been canceled or not

Methods inherited from class java.lang.Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, run, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Field Detail

res

protected Object res

cancelled

protected boolean cancelled

t

protected Thread t

hasFinished

protected boolean hasFinished

hasStarted

protected boolean hasStarted

status

protected String status

OPERATION_CANCELLED

public static String OPERATION_CANCELLED

description

public String description

Constructor Detail

OperationThread

public OperationThread()

Constructor.

OperationThread

public OperationThread(String description)

Sets a description to the thread

Parameters:

description - the thread description

Method Detail

getDescription

public String getDescription()

Returns the thread description

Returns:

the thread description

isCancelled

public boolean isCancelled()

Checks whether the thread has been canceled or not

Returns:

true if the thread was canceled, false otherwise

cancel

public void cancel()

Sets the thread status as canceled. If stopping safely the thread can be done, it must be done in this method. The EntityResult configured for this thread is set as a new EntityResult with operation wrong and the message OPERATION_CANCELLED.

hasFinished

public boolean hasFinished()

Checks whether the thread has finished.

Returns:

true if the thread is finished, false if the thread is still running

hasStarted

public boolean hasStarted()

Checks whether the thread has started.

Returns:

rue if the thread has started, false otherwise

getResult

public Object getResult()

Returns the thread result. The result by default is stored in a EntityResult object.

Returns:

the thread result

getStatus

public String getStatus()

Returns the thread status, which is a message referent to the thread situation.

Returns: