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

Class FeedbackSimQueueSelector<J extends SimJob,DQ extends SimQueue>

java.lang.Object

org.javades.jqueues.r5.entity.jq.queue.composite.feedback.FeedbackSimQueueSelector<J,DQ>

Type Parameters:

J - The job type.

DQ - The queue-type for delegate jobs.

All Implemented Interfaces:

SimQueueSelector<J,DQ>

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

A SimQueueSelector for feedback queues.

This is the mandatory SimQueueSelector for feedback queues, as enforced in the constructor of AbstractFeedbackSimQueue. It uses a more convenient SimQueueFeedbackController provided upon construction.

In addition, in support for FB_v, it maintains the number of visits since the last reset for each "real" job in the composite queue.

If attached to a AbstractFeedbackSimQueue, the selector will be reset automatically by the queue when required. In return, the FeedbackSimQueueSelector then automatically resets the embedded SimQueueFeedbackController.

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:

SimQueueFeedbackController, FB_v, FB_p

Constructor Summary

Constructors

Constructor and Description
FeedbackSimQueueSelector(DQ queue, SimQueueFeedbackController<J,DQ> feedbackController) Creates a SimQueueSelector for a feedback queue.

Method Summary

Modifier and Type	Method and Description
SimQueueFeedbackController<J,DQ>	getFeedbackController() Returns the feedback controller.
void	resetSimQueueSelector() Resets the feedback controller and clears the registration of visits.
DQ	selectFirstQueue(double time, J job) Returns the embedded queue.
DQ	selectNextQueue(double time, J job, DQ previousQueue) Returns the embedded queue if the delegate job is to be fed back, null otherwise.

Methods inherited from class java.lang.Object

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

Constructor Detail

FeedbackSimQueueSelector

public FeedbackSimQueueSelector(DQ queue,
                                SimQueueFeedbackController<J,DQ> feedbackController)

Creates a SimQueueSelector for a feedback queue.

Parameters:

queue - The queue, non-null.

feedbackController - The feedback controller, non-null.

Throws:

IllegalArgumentException - If the queue or feedback controller is null.

Method Detail

getFeedbackController

public final SimQueueFeedbackController<J,DQ> getFeedbackController()

Returns the feedback controller.

Returns:

The feedback controller, non-null.

resetSimQueueSelector

public void resetSimQueueSelector()

Resets the feedback controller and clears the registration of visits.

Specified by:

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

See Also:

SimQueueFeedbackController.resetFeedbackController()

selectFirstQueue

public DQ selectFirstQueue(double time,
                           J job)

Returns the embedded queue.

Updates the visits administration, putting the new job in with zero visits.

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 embedded SimQueue.

selectNextQueue

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

Returns the embedded queue if the delegate job is to be fed back, null otherwise.

Updates the visits administration, removing the job when it is leaving or increasing its number of visits when it is fed back.

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:

If consultation of the feedback controller indicates a new feedback is needed, returns the embedded SimQueue, null otherwise.

See Also:

SimQueueFeedbackController, getFeedbackController()