ikr.simlib.algorithms.queuingDisciplines

Class BoundedLIFOQDisc

java.lang.Object

ikr.simlib.algorithms.queuingDisciplines.StackableQueuingDiscipline

ikr.simlib.algorithms.queuingDisciplines.LIFOQDisc

ikr.simlib.algorithms.queuingDisciplines.BoundedLIFOQDisc

All Implemented Interfaces:

BoundedQDisc, QueuingDiscipline, ReflectionConstructable, ReflectionConstructable2<SimNode,Parameters>, ReflectionConstructable3<SimNode,Parameters,java.lang.Integer>

public class BoundedLIFOQDisc
extends LIFOQDisc
implements BoundedQDisc

This class implements a bounded LIFO (Last In First Out) queuing discipline, i.e., it has a finite buffer size. If a new message arrives and there is not enough buffer space left in the queue to store the message, messages are deleted from the head of the queue until there is enough buffer space in the drop-head queue to hold the new message. The messages are deleted by the HandleLossMessage()-method. You can overwrite this virtual method if you want something else to be done with the message. If the arriving message is larger than the maximum available buffer space in the queue, then it is discarded immediately and no messages within the queue are deleted.

Nested Class Summary

Nested classes/interfaces inherited from interface ikr.simlib.algorithms.queuingDisciplines.QueuingDiscipline

QueuingDiscipline.QueueEntry

Field Summary

Fields

Modifier and Type	Field and Description
protected int	maxSizeInUnits

Fields inherited from class ikr.simlib.algorithms.queuingDisciplines.LIFOQDisc

queue

Fields inherited from class ikr.simlib.algorithms.queuingDisciplines.StackableQueuingDiscipline

lossProbability, numberOfMessages, numberOfUnits, parent, simNode, transferTime, waitingTime

Fields inherited from interface ikr.simlib.parameters.reflection.ReflectionConstructable

CREATE_INSTANCE_METHOD_NAME

Constructor Summary

Constructors

Constructor and Description
BoundedLIFOQDisc(int size, SimNode ownNode)
BoundedLIFOQDisc(SimNode ownNode, Parameters pars)

Method Summary

Methods

Modifier and Type	Method and Description
static BoundedLIFOQDisc	createInstance(SimNode ownNode, Parameters pars) as required by ReflectionConstructable
static BoundedLIFOQDisc	createInstance(SimNode ownNode, Parameters pars, java.lang.Integer size)
boolean	wouldStore(Message msg)

Methods inherited from class ikr.simlib.algorithms.queuingDisciplines.LIFOQDisc

getMaxSizeInUnits, isEmpty, peek, pop, push

Methods inherited from class ikr.simlib.algorithms.queuingDisciplines.StackableQueuingDiscipline

dequeue, dropScheduledNext, enqueue, getCurrentNumberOfMessages, getCurrentNumberOfUnits, getName, getNode, getParent, handleLossMessage, handleMessage, handleRejectedMessage, hasSpaceFor, statsUpdateDequeue, statsUpdateEnqueue, statsUpdateLoss, statsUpdateReject

Methods inherited from class java.lang.Object

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

Methods inherited from interface ikr.simlib.algorithms.queuingDisciplines.QueuingDiscipline

dequeue, dropScheduledNext, getCurrentNumberOfMessages, getCurrentNumberOfUnits, getMaxSizeInUnits, getName, getNode, getParent, handleMessage, isEmpty

Field Detail

maxSizeInUnits

protected int maxSizeInUnits

Constructor Detail

BoundedLIFOQDisc

public BoundedLIFOQDisc(int size,
                SimNode ownNode)

BoundedLIFOQDisc

public BoundedLIFOQDisc(SimNode ownNode,
                Parameters pars)

Method Detail

createInstance

public static BoundedLIFOQDisc createInstance(SimNode ownNode,
                              Parameters pars)

as required by ReflectionConstructable

createInstance

public static BoundedLIFOQDisc createInstance(SimNode ownNode,
                              Parameters pars,
                              java.lang.Integer size)

wouldStore

public boolean wouldStore(Message msg)

Specified by:

wouldStore in interface QueuingDiscipline

Overrides:

wouldStore in class StackableQueuingDiscipline

Returns:

true if the queue would store the given message. May return false due to a bounded buffer size or a probabilistic decision, for ProbabilisticQeuingDisciplines. For these, two subsequent calls with the same message may return different results!