jadex.commons.collection

Class ActionReferenceQueue

java.lang.Object

java.lang.ref.ReferenceQueue

jadex.commons.collection.ActionReferenceQueue

public class ActionReferenceQueue
extends ReferenceQueue

The extended reference queue allows for adding (weak) object with an associated action. Whenever the object becomes unreferenced its corresponding weak entry can be fetched from the queue and when this is done the associated action will automatically be executed.

Constructor Summary

Constructors

Constructor and Description
ActionReferenceQueue() Create a new list.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	addEntry(Object o, Runnable action) Add an object with an associated value.
int	getEntriesSize() Get the size of the entries (existing objects).
Reference	poll() Poll a stale entry.
Reference	remove() Remove an element from the queue.
Reference	remove(long timeout) Remove an element from the queue.
Runnable	removeEntry(Object obj) Remove an entry.
String	toString() Get the string representation.

Methods inherited from class java.lang.Object

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

Constructor Detail

ActionReferenceQueue

public ActionReferenceQueue()

Create a new list.

Method Detail

addEntry

public boolean addEntry(Object o,
               Runnable action)

Add an object with an associated value.

Parameters:

o - The object (becomes weak reference).

val - The value.

removeEntry

public Runnable removeEntry(Object obj)

Remove an entry.

getEntriesSize

public int getEntriesSize()

Get the size of the entries (existing objects). Does not expunge stale entries.

Returns:

The number of existing entries.

remove

public Reference remove()
                 throws InterruptedException

Remove an element from the queue.

Overrides:

remove in class ReferenceQueue

Returns:

A weak entry.

Throws:

InterruptedException

remove

public Reference remove(long timeout)
                 throws IllegalArgumentException,
                        InterruptedException

Remove an element from the queue.

Overrides:

remove in class ReferenceQueue

Returns:

A weak entry.

Throws:

IllegalArgumentException

InterruptedException

poll

public Reference poll()

Poll a stale entry.

Overrides:

poll in class ReferenceQueue

Returns:

A weak entry or null (if none is stale).

toString

public String toString()

Get the string representation.

Overrides:

toString in class Object