com.haulmont.cuba.gui.backgroundwork

Class LocalizedTaskWrapper<T,V>

java.lang.Object

com.haulmont.cuba.gui.executors.BackgroundTask<T,V>

com.haulmont.cuba.gui.backgroundwork.LocalizedTaskWrapper<T,V>

public class LocalizedTaskWrapper<T,V>
extends BackgroundTask<T,V>

Nested Class Summary

Nested classes/interfaces inherited from class com.haulmont.cuba.gui.executors.BackgroundTask

BackgroundTask.ProgressListener<T,V>, BackgroundTask.ProgressListenerAdapter<T,V>

Method Summary

Modifier and Type	Method and Description
void	canceled() Called by the execution environment in UI thread if the task is canceled by BackgroundTaskHandler.cancel() invocation.
void	done(V result) Called by the execution environment in UI thread when the task is completed.
java.util.Map<java.lang.String,java.lang.Object>	getParams() Called by the execution environment in UI thread to prepare some execution parameters.
boolean	handleException(java.lang.Exception ex) Called by the execution environment in UI thread if the task BackgroundTask.run(TaskLifeCycle) method raised an exception.
boolean	handleTimeoutException() Called by the execution environment in UI thread if the task timeout is exceeded.
void	progress(java.util.List<T> changes) Called by the execution environment in UI thread on progress change.
V	run(TaskLifeCycle<T> lifeCycle) Main method that performs a task.

Methods inherited from class com.haulmont.cuba.gui.executors.BackgroundTask

addProgressListener, getOwnerFrame, getProgressListeners, getTimeoutMilliseconds, getTimeoutSeconds, removeProgressListener

Methods inherited from class java.lang.Object

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

Method Detail

getParams

public java.util.Map<java.lang.String,java.lang.Object> getParams()

Description copied from class: BackgroundTask

Called by the execution environment in UI thread to prepare some execution parameters. These parameters can be requested by the working thread inside the BackgroundTask.run(TaskLifeCycle) method by calling TaskLifeCycle.getParams().

Overrides:

getParams in class BackgroundTask<T,V>

Returns:

parameters map or null if parameters are not needed

run

public V run(TaskLifeCycle<T> lifeCycle)
      throws java.lang.Exception

Description copied from class: BackgroundTask

Main method that performs a task.
Called by the execution environment in a separate working thread.
Implementation of this method should support interruption:

• In long loops check TaskLifeCycle.isInterrupted() and return if it is true
• Don't swallow InterruptedException - return from the method or don't catch it at all

Specified by:

run in class BackgroundTask<T,V>

Parameters:

lifeCycle - lifecycle object that allows the main method to interact with the execution environment

Returns:

task result

Throws:

java.lang.Exception - exception in working thread

handleException

public boolean handleException(java.lang.Exception ex)

Description copied from class: BackgroundTask

Called by the execution environment in UI thread if the task BackgroundTask.run(TaskLifeCycle) method raised an exception.

Overrides:

handleException in class BackgroundTask<T,V>

Parameters:

ex - exception

Returns:

true if this method implementation actually handles the exception. Used for chaining handlers.

handleTimeoutException

public boolean handleTimeoutException()

Description copied from class: BackgroundTask

Called by the execution environment in UI thread if the task timeout is exceeded.

Overrides:

handleTimeoutException in class BackgroundTask<T,V>

Returns:

true if this method implementation actually handles this event. Used for chaining handlers.

done

public void done(V result)

Description copied from class: BackgroundTask

Called by the execution environment in UI thread when the task is completed.

Overrides:

done in class BackgroundTask<T,V>

Parameters:

result - result of execution returned by BackgroundTask.run(TaskLifeCycle) method

canceled

public void canceled()

Description copied from class: BackgroundTask

Called by the execution environment in UI thread if the task is canceled by BackgroundTaskHandler.cancel() invocation.
This method is not called in case of timeout expiration or owner window closing.

Overrides:

canceled in class BackgroundTask<T,V>

progress

public void progress(java.util.List<T> changes)

Description copied from class: BackgroundTask

Called by the execution environment in UI thread on progress change.

Overrides:

progress in class BackgroundTask<T,V>

Parameters:

changes - list of changes since previous invocation