org.yawlfoundation.yawl.resourcing.allocators

Class AbstractAllocator

java.lang.Object

org.yawlfoundation.yawl.resourcing.AbstractSelector

org.yawlfoundation.yawl.resourcing.allocators.AbstractAllocator

All Implemented Interfaces:

java.lang.Comparable<AbstractSelector>

Direct Known Subclasses:

CheapestCompleter, CheapestResource, CheapestStarter, CheapestToAllocate, DearestResource, FastestResource, FastestToAllocate, FastestToComplete, FastestToStart, GenericAllocator, NewAllocator, RandomChoice, RoundRobinByExperience, RoundRobinByLeastFrequency, RoundRobinByTime, ShortestQueue

public abstract class AbstractAllocator
extends AbstractSelector

The base class for all allocators. Create Date: 03/08/2007. Last Date: 09/11/2007

Version:

2.0

Author:

Michael Adams (BPM Group, QUT Australia)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	AbstractAllocator.EventPair

Field Summary

Fields inherited from class org.yawlfoundation.yawl.resourcing.AbstractSelector

_canonicalName, _description, _displayName, _name, _params

Constructor Summary

Constructors

Constructor and Description
AbstractAllocator() Constructors
AbstractAllocator(java.lang.String name)
AbstractAllocator(java.lang.String name, java.util.HashMap<java.lang.String,java.lang.String> params)
AbstractAllocator(java.lang.String name, java.lang.String description)
AbstractAllocator(java.lang.String name, java.lang.String desc, java.util.HashMap<java.lang.String,java.lang.String> params)

Method Summary

Modifier and Type	Method and Description
protected java.util.Map<java.lang.String,java.lang.Long>	getAvgDurations(java.util.Collection<AbstractAllocator.EventPair> pairs)
protected java.util.Map<java.lang.String,java.lang.Long>	getAvgDurations(EventLogger.event fromEvent, EventLogger.event toEvent, WorkItemRecord wir) Gets the average duration (in msecs) between two events for each participant recorded against those events for a task
protected double	getCost(XNode resNode, java.lang.String duration)
protected java.util.Map<java.lang.String,XNode>	getCostMap(java.util.Set<java.lang.String> pids, WorkItemRecord wir) Gets from the cost service the cost per msec of each of the participants ids listed for the work item
protected java.util.List	getLoggedEvents(WorkItemRecord wir, EventLogger.event event) Gets a list of all resource log rows for a given specification + task + event combination.
protected java.util.Map<java.lang.String,Participant>	participantSetToMap(java.util.Set<Participant> pSet) Converts a set of participants to a map
abstract Participant	performAllocation(java.util.Set<Participant> resources, WorkItemRecord wir) Performs an allocation using some strategy
java.lang.String	toXML() Generates the XML required for the specification file

Methods inherited from class org.yawlfoundation.yawl.resourcing.AbstractSelector

addKey, addParam, addParams, compareTo, equals, evaluate, getCanonicalName, getClassName, getDescription, getDisplayName, getInformation, getKeys, getName, getParamKeys, getParams, getParamValue, hashCode, intersection, reconstitute, setCanonicalName, setDescription, setDisplayName, setKeyValue, setName, setParams, toString, union, unmarshalParams

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

AbstractAllocator

public AbstractAllocator()

Constructors

AbstractAllocator

public AbstractAllocator(java.lang.String name)

AbstractAllocator

public AbstractAllocator(java.lang.String name,
                         java.util.HashMap<java.lang.String,java.lang.String> params)

AbstractAllocator

public AbstractAllocator(java.lang.String name,
                         java.lang.String description)

AbstractAllocator

public AbstractAllocator(java.lang.String name,
                         java.lang.String desc,
                         java.util.HashMap<java.lang.String,java.lang.String> params)

Method Detail

toXML

public java.lang.String toXML()

Generates the XML required for the specification file

Overrides:

toXML in class AbstractSelector

Returns:

an XML'd String containing the member values of an instantiation of this class

getLoggedEvents

protected java.util.List getLoggedEvents(WorkItemRecord wir,
                                         EventLogger.event event)

Gets a list of all resource log rows for a given specification + task + event combination.

Parameters:

wir - a workitem record which is an instance of the specification+task in question.

event - the type of event to get records for

Returns:

the matching list of ResourceEvent objects (each one a row of the log)

participantSetToMap

protected java.util.Map<java.lang.String,Participant> participantSetToMap(java.util.Set<Participant> pSet)

Converts a set of participants to a map

Parameters:

pSet - the set of participants

Returns:

a map of participant id to participant

getCostMap

protected java.util.Map<java.lang.String,XNode> getCostMap(java.util.Set<java.lang.String> pids,
                                                           WorkItemRecord wir)

Gets from the cost service the cost per msec of each of the participants ids listed for the work item

Parameters:

pids - a set of participant ids

wir - the work item to allocate

Returns:

a map containing each participant id and its corresponding cost per msec to perform this work item

getCost

protected double getCost(XNode resNode,
                         java.lang.String duration)

getAvgDurations

protected java.util.Map<java.lang.String,java.lang.Long> getAvgDurations(EventLogger.event fromEvent,
                                                                         EventLogger.event toEvent,
                                                                         WorkItemRecord wir)

Gets the average duration (in msecs) between two events for each participant recorded against those events for a task

Parameters:

fromEvent - the earlier event (start of duration)

toEvent - the later event (end of duration)

wir - a work item to allocate

Returns:

a Map of participant ids and average durations

getAvgDurations

protected java.util.Map<java.lang.String,java.lang.Long> getAvgDurations(java.util.Collection<AbstractAllocator.EventPair> pairs)

performAllocation

public abstract Participant performAllocation(java.util.Set<Participant> resources,
                                              WorkItemRecord wir)

Performs an allocation using some strategy

Parameters:

resources - the distribution set of participants

wir - the work item to allocate

Returns:

the Participant chosen by the allocation strategy