akka.dispatch.sysmsg

Class LatestFirstSystemMessageList

java.lang.Object

scala.AnyVal

akka.dispatch.sysmsg.LatestFirstSystemMessageList

public class LatestFirstSystemMessageList
extends scala.AnyVal

INTERNAL API

Value class supporting list operations on system messages. The next field of SystemMessage is hidden, and can only accessed through the value classes LatestFirstSystemMessageList and EarliestFirstSystemMessageList, abstracting over the fact that system messages are the list nodes themselves. If used properly, this stays a compile time construct without any allocation overhead.

This list is mutable.

The type of the list also encodes that the messages contained are in reverse order, i.e. the head of the list is the latest appended element.

Constructor Summary

Constructors

Constructor and Description
LatestFirstSystemMessageList(SystemMessage head)

Method Summary

Modifier and Type	Method and Description
static java.lang.Class<? extends java.lang.Object>	getClass()
SystemMessage	head()
boolean	isEmpty() Indicates if the list is empty or not.
boolean	nonEmpty() Indicates if the list has at least one element or not.
EarliestFirstSystemMessageList	reverse() Reverses the list.
int	size() Indicates if the list is empty or not.
LatestFirstSystemMessageList	tail() Gives back the list containing all the elements except the first.

Methods inherited from class java.lang.Object

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

Constructor Detail

LatestFirstSystemMessageList

public LatestFirstSystemMessageList(SystemMessage head)

Method Detail

getClass

public static java.lang.Class<? extends java.lang.Object> getClass()

head

public SystemMessage head()

isEmpty

public final boolean isEmpty()

Indicates if the list is empty or not. This operation has constant cost.

Returns:

(undocumented)

nonEmpty

public final boolean nonEmpty()

Indicates if the list has at least one element or not. This operation has constant cost.

Returns:

(undocumented)

size

public final int size()

Indicates if the list is empty or not. This operation has constant cost.

Returns:

(undocumented)

tail

public final LatestFirstSystemMessageList tail()

Gives back the list containing all the elements except the first. This operation has constant cost.

*Warning:* as the underlying list nodes (the SystemMessage instances) are mutable, care should be taken when passing the tail to other methods. SystemMessage.unlink() should be called on the head if one wants to detach the tail permanently.

Returns:

(undocumented)

reverse

public final EarliestFirstSystemMessageList reverse()

Reverses the list. This operation mutates the underlying list. The cost of the call to reverse is linear in the number of elements.

The type of the returned list is of the opposite order: EarliestFirstSystemMessageList

Returns:

(undocumented)