org.powertac.server
Class CompetitionControlService

java.lang.Object
  org.powertac.server.CompetitionControlService

All Implemented Interfaces:

org.powertac.common.interfaces.CompetitionControl

@Service
public class CompetitionControlService
extends Object
implements org.powertac.common.interfaces.CompetitionControl

This is the competition controller. It has two major roles in the server:

1. Once the game is configured, the init() method must be called. There are two versions of this method; the init() version runs a "bootstrap" simulation that runs the customer models and the wholesale market for a limited period of time to collect an initial dataset from which brokers can bootstrap their internal models. During a bootstrap simulation, external brokers cannot log in; only the default broker is active. The init(filename) version loads bootstrap data from the named file, validates it, and then opens up the broker login process, most of which is delegated to the BrokerProxy.
2. Once the simulation starts, the step() method is called every timeslotLength seconds. This runs through timeslotPhaseCount phases, calling the activate() methods on registered components. Phases start at 1; by default there are four phases.
3. When the number of timeslots equals timeslotCount, the simulation is ended.

Author:

John Collins

Constructor Summary

CompetitionControlService()

Method Summary

void	handleMessage(org.powertac.common.msg.BrokerAuthentication msg) Authenticate Broker.
void	handleMessage(org.powertac.common.msg.PauseRelease msg) Releases a broker-initiated pause.
void	handleMessage(org.powertac.common.msg.PauseRequest msg) Allows a broker to request a pause.
void	init() Initializes the service in preparation for a new simulation
boolean	isBootstrapMode() True just in case the sim is running in bootstrap mode
boolean	isRunning() Expose simulation-running flag
boolean	loginBroker(String username) Logs in a broker, just in case the broker is on the authorizedBrokerMap.
void	pause() Signals that the clock is paused due to server overrun.
void	registerTimeslotPhase(org.powertac.common.interfaces.TimeslotPhaseProcessor thing, int phase) Allows instances of TimeslotPhaseProcessor to register themselves to be activated during one of the processing phases in each timeslot.
void	resume(long newStart) Signals that the clock is resumed.
void	runOnce(boolean bootstrapMode) Runs a simulation that is already set up.
void	setAlwaysAuthorizedBrokers(List<String> brokerList) Sets the list of broker usernames that are always authorized, even in bootstrap mode.
void	setAuthorizedBrokerList(List<String> brokerList) Sets the list of brokers allowed and expected to log in before starting a simulation.
void	setBootstrapTimeslotMillis(long length) Allows Spring to set the boostrap timeslot length
void	setTimeslotPhaseCount(int count) Sets the number of phases into which a timeslot is divided for processing.
void	shutDown() Shuts down the simulation and cleans up.
void	stop() Signals the simulation thread to stop after processing is completed in the current timeslot.

Methods inherited from class java.lang.Object

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

Constructor Detail

CompetitionControlService

public CompetitionControlService()

Method Detail

init

public void init()

Initializes the service in preparation for a new simulation

setTimeslotPhaseCount

public void setTimeslotPhaseCount(int count)

Sets the number of phases into which a timeslot is divided for processing. Intended to be called by Spring initialization. The value must be at least as large as the maximum value of timeslotPhase among the service modules.

setAlwaysAuthorizedBrokers

public void setAlwaysAuthorizedBrokers(List<String> brokerList)

Sets the list of broker usernames that are always authorized, even in bootstrap mode. Normally this is just "defaultBroker". This method is intended to be called by Spring initialization.

setAuthorizedBrokerList

public void setAuthorizedBrokerList(List<String> brokerList)

Sets the list of brokers allowed and expected to log in before starting a simulation. The simulation will not start until all brokers in the list are logged in, unless a timeout is configured.

Specified by:

setAuthorizedBrokerList in interface org.powertac.common.interfaces.CompetitionControl

runOnce

public void runOnce(boolean bootstrapMode)

Runs a simulation that is already set up. This is intended to be called from a method that knows whether we are running a bootstrap sim or a normal sim.

Specified by:

runOnce in interface org.powertac.common.interfaces.CompetitionControl

loginBroker

public boolean loginBroker(String username)

Logs in a broker, just in case the broker is on the authorizedBrokerMap. Returns true if the broker is authorized, otherwise false.

Specified by:

loginBroker in interface org.powertac.common.interfaces.CompetitionControl

isRunning

public boolean isRunning()

Expose simulation-running flag

Specified by:

isRunning in interface org.powertac.common.interfaces.CompetitionControl

stop

public void stop()

Signals the simulation thread to stop after processing is completed in the current timeslot.

shutDown

public void shutDown()

Shuts down the simulation and cleans up.

Specified by:

shutDown in interface org.powertac.common.interfaces.CompetitionControl

registerTimeslotPhase

public void registerTimeslotPhase(org.powertac.common.interfaces.TimeslotPhaseProcessor thing,
                                  int phase)

Allows instances of TimeslotPhaseProcessor to register themselves to be activated during one of the processing phases in each timeslot.

Specified by:

registerTimeslotPhase in interface org.powertac.common.interfaces.CompetitionControl

isBootstrapMode

public boolean isBootstrapMode()

True just in case the sim is running in bootstrap mode

Specified by:

isBootstrapMode in interface org.powertac.common.interfaces.CompetitionControl

pause

public void pause()

Signals that the clock is paused due to server overrun. The pause must be communicated to brokers.

resume

public void resume(long newStart)

Signals that the clock is resumed. Brokers must be informed of the new start time in order to sync their own clocks.

handleMessage

public void handleMessage(org.powertac.common.msg.PauseRequest msg)

Allows a broker to request a pause. It may or may not be allowed. If allowed, then the pause will take effect when the current simulation cycle has finished, or immediately if no simulation cycle is currently in progress.

handleMessage

public void handleMessage(org.powertac.common.msg.PauseRelease msg)

Releases a broker-initiated pause. After the clock is re-started, the resume() method will be called to communicate a new start time.

handleMessage

public void handleMessage(org.powertac.common.msg.BrokerAuthentication msg)

Authenticate Broker. TODO: add auth-token processing

setBootstrapTimeslotMillis

public void setBootstrapTimeslotMillis(long length)

Allows Spring to set the boostrap timeslot length