com.atakmap.android.util

Class LimitingThread

java.lang.Object

com.atakmap.android.util.LimitingThread

All Implemented Interfaces:

java.lang.Runnable

public class LimitingThread
extends java.lang.Object
implements java.lang.Runnable

Provides a processing capability where the action will only be run as fast as it can no matter how many calls to exec() are performed - but will guarantee the last most call to exec() will execute the run method of the runnable passed in.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	TAG

Constructor Summary

Constructors

Constructor and Description
LimitingThread(java.lang.String name, java.lang.Runnable r) Construct a limiting thread with a name and a runnable which will be the worker code that is executed whenever the exec call is made on the limiting thread.

Method Summary

Modifier and Type	Method and Description
void	dispose()
void	dispose(boolean join) Perform disposal of the limiting thread, canceling any future calls to execute.
void	exec() Called to perform the action as defined in the runnable used during creation.
void	run()

Methods inherited from class java.lang.Object

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

Field Detail

TAG

public static final java.lang.String TAG

See Also:

Constant Field Values

Constructor Detail

LimitingThread

public LimitingThread(java.lang.String name,
                      java.lang.Runnable r)

Construct a limiting thread with a name and a runnable which will be the worker code that is executed whenever the exec call is made on the limiting thread. If the system cannot keep up, intermediate executions are dropped and only the last exec is executed.

Parameters:

name - the name of the limiting thread

r - the runnable to be used that contains the logic to be run on the limiting thread.

Method Detail

exec

public void exec()

Called to perform the action as defined in the runnable used during creation. It is guaranteed that the action will be executed at least once of the runnable. If multiple calls are made, the execution of a runnable may be dropped in order for the limting thread to catch up.

dispose

public void dispose(boolean join)

Perform disposal of the limiting thread, canceling any future calls to execute.

Parameters:

join - if join is true, try to wait for the execution to finish of the last call to exec.

dispose

public void dispose()

run

public void run()

Specified by:

run in interface java.lang.Runnable