TaskQueue (Gosu :: Lab 1.14.16 API)

java.lang.Object
- java.lang.Thread
- - editor.util.TaskQueue

All Implemented Interfaces:

Runnable
```
public class TaskQueue
extends Thread
```
A general purpose concurrent task queue. Facilitates creating named queues containing any number of Runnable tasks. A task is posted to its queue asynchronously. Each queue maintains a single thread and tasks are executed in the order they are posted.
Improvements to this class might include some sort of priority scheduling for tasks. For now they execute with equal priority.

Nested Class Summary
- Nested classes/interfaces inherited from class java.lang.Thread
  Thread.State, Thread.UncaughtExceptionHandler

Field Summary
- Fields inherited from class java.lang.Thread
  MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`cancelTasks(Class taskClass)`
`static void`	`emptyAndRemoveQueue(String strQueueName)` Clears all the inactive tasks in the specified queue.
`void`	`emptyQueue()` Empty the queue
`static TaskQueue`	`getInstance(ILogger logger, String strQueueName)` Fetch a TaskQueue by name.
`static TaskQueue`	`getInstance(String strQueueName)` Fetch a TaskQueue by name.
`List<Runnable>`	`getTasks()` Get a list of all the tasks in this TaskQueue.
`static boolean`	`hasWork()`
`static void`	`killAll()` Stops all task queues and dumps thier queue.
`protected void`	`log(Throwable t)` Log an exception or error.
`Runnable`	`peekTask()` Peek at the "current" task in the queue.
`void`	`postTask(Runnable task)` Posts a task to the queue (asynchronously).
`void`	`postTaskAndWait(Runnable runnable)`
`void`	`postTaskAndWait(Runnable runnable, long timeout)`
`void`	`run()` Do NOT ever call this! Public only by contract.
`void`	`setILogger(ILogger logger)`
`int`	`size()` Get the size of the queue at the instance this is called.
`void`	`waitUntilAllCurrentTasksFinish()`

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, 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

- Method Detail
  - getInstance
```
public static TaskQueue getInstance(String strQueueName)
```
    Fetch a TaskQueue by name. If the TaskQueue doesn't already exist, creates the TaskQueue.
  - getInstance
```
public static TaskQueue getInstance(ILogger logger,
                                    String strQueueName)
```
    Fetch a TaskQueue by name. If the TaskQueue doesn't already exist, creates the TaskQueue.
    
    Parameters:
    
    logger - An optional logger.
    
    strQueueName - The unique name for the queue.
    
    Returns:
    
    The TaskQueue associated with the specified name.
  - emptyAndRemoveQueue
```
public static void emptyAndRemoveQueue(String strQueueName)
```
    Clears all the inactive tasks in the specified queue.
  - killAll
```
public static void killAll()
```
    Stops all task queues and dumps thier queue. This is a very dangerous method and should only be called from tests.
  - postTask
```
public void postTask(Runnable task)
```
    Posts a task to the queue (asynchronously).
    
    Parameters:
    
    task - A task to run in the TaskQueue's thread.
  - waitUntilAllCurrentTasksFinish
```
public void waitUntilAllCurrentTasksFinish()
```
  - peekTask
```
public Runnable peekTask()
```
    Peek at the "current" task in the queue. It may or may not be running.
    
    Returns:
    
    The "current" task in the queue.
  - getTasks
```
public List<Runnable> getTasks()
```
    Get a list of all the tasks in this TaskQueue.
    
    Returns:
    
    A cloned list of all the tasks in this TaskQueue.
  - emptyQueue
```
public void emptyQueue()
```
    Empty the queue
  - size
```
public int size()
```
    Get the size of the queue at the instance this is called.
  - run
```
public void run()
```
    Do NOT ever call this! Public only by contract.
    
    Specified by:
    
    run in interface Runnable
    
    Overrides:
    
    run in class Thread
  - log
```
protected void log(Throwable t)
```
    Log an exception or error.
  - hasWork
```
public static boolean hasWork()
```
  - postTaskAndWait
```
public void postTaskAndWait(Runnable runnable,
                            long timeout)
```
  - postTaskAndWait
```
public void postTaskAndWait(Runnable runnable)
```
  - cancelTasks
```
public void cancelTasks(Class taskClass)
```
  - setILogger
```
public void setILogger(ILogger logger)
```

Class TaskQueue

Nested Class Summary

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

Field Summary

Fields inherited from class java.lang.Thread

Method Summary

Methods inherited from class java.lang.Thread

Methods inherited from class java.lang.Object

Method Detail

getInstance

getInstance

emptyAndRemoveQueue

killAll

postTask

waitUntilAllCurrentTasksFinish

peekTask

getTasks

emptyQueue

size

run

log

hasWork

postTaskAndWait

postTaskAndWait

cancelTasks

setILogger