org.javades.jqueues.r5.entity.jq.queue.composite.tandem

Class TandemSimQueueSelector<J extends SimJob,DQ extends SimQueue>

java.lang.Object

org.javades.jqueues.r5.entity.jq.queue.composite.tandem.TandemSimQueueSelector<J,DQ>

Type Parameters:

J - The job type.

DQ - The queue-type for delegate jobs.

All Implemented Interfaces:

SimQueueSelector<J,DQ>

public class TandemSimQueueSelector<J extends SimJob,DQ extends SimQueue>
extends Object
implements SimQueueSelector<J,DQ>

A SimQueueSelector for tandem queues.

In a tandem queue, a (delegate) job visits all sub-queues once in a predetermined sequence. This SimQueueSelector is mandatory for Tandem.

Author:

Jan de Jongh, TNO

Copyright (C) 2005-2017 Jan de Jongh, TNO

This file is covered by the LICENSE file in the root of this project.

See Also:

Tandem

Constructor Summary

Constructors

Constructor and Description
TandemSimQueueSelector(Set<DQ> queues) Creates a SimQueueSelector for a tandem queue.

Method Summary

Modifier and Type	Method and Description
void	resetSimQueueSelector() Does nothing.
DQ	selectFirstQueue(double time, J job) Returns the first SimQueue to visit by a (delegate) SimJob.
DQ	selectNextQueue(double time, J job, DQ previousQueue) Returns the next SimQueue to visit by a delegate SimJob.

Methods inherited from class java.lang.Object

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

Constructor Detail

TandemSimQueueSelector

public TandemSimQueueSelector(Set<DQ> queues)

Creates a SimQueueSelector for a tandem queue.

Parameters:

queues - The queues, must be non-null.

Throws:

IllegalArgumentException - If the queues argument is null, or if it contains a null entry.

Method Detail

resetSimQueueSelector

public final void resetSimQueueSelector()

Does nothing.

Specified by:

resetSimQueueSelector in interface SimQueueSelector<J extends SimJob,DQ extends SimQueue>

selectFirstQueue

public final DQ selectFirstQueue(double time,
                                 J job)

Returns the first SimQueue to visit by a (delegate) SimJob.

Specified by:

selectFirstQueue in interface SimQueueSelector<J extends SimJob,DQ extends SimQueue>

Parameters:

time - The time of arrival of the job.

job - The job, non-null.

Returns:

The first SimQueue returned by an iterator over the queue set, or null if that set is null or empty.

selectNextQueue

public final DQ selectNextQueue(double time,
                                J job,
                                DQ previousQueue)

Returns the next SimQueue to visit by a delegate SimJob.

Specified by:

selectNextQueue in interface SimQueueSelector<J extends SimJob,DQ extends SimQueue>

Parameters:

time - The current time, i.e., the departure time of the job at its previous queue.

job - The job, non-null.

previousQueue - The previous queue the job visited, and just departed from.

Returns:

The next SimQueue after the previousQueue in an iterator over the queue set, or null if that set is null or if no such element exists (i.e., previousQueue is the last element returned from the iterator).

Throws:

IllegalStateException - If the previous queue argument is null or not a member of the queue set.