Package org.powertac.tariffmarket

Class TariffMarketService

java.lang.Object

org.powertac.common.interfaces.TimeslotPhaseProcessor

org.powertac.tariffmarket.TariffMarketService

All Implemented Interfaces:

InitializationService, TariffMarket

@Service
public class TariffMarketService
extends TimeslotPhaseProcessor
implements TariffMarket, InitializationService

Implements the Tariff Market abstraction. Incoming tariff-related messages from brokers are received and processed, tariffs are published periodically, and subscriptions are processed on behalf of customers.

Author:

John Collins

Constructor Summary

Constructors

Constructor	Description
TariffMarketService()	Default constructor

Method Summary

Modifier and Type	Method	Description
void	activate(org.joda.time.Instant time, int phase)
List<Tariff>	getActiveTariffList(org.powertac.common.enumerations.PowerType type)
Tariff	getDefaultTariff(org.powertac.common.enumerations.PowerType type)	Returns the default tariff
double	getMaxPublicationFee()
double	getMaxRevocationFee()
double	getMinPublicationFee()
double	getMinRevocationFee()
Double	getPublicationFee()
int	getPublicationInterval()
int	getPublicationOffset()
Double	getRevocationFee()
void	handleMessage(org.powertac.common.msg.BalancingOrder msg)	Processes an incoming BalancingOrder by storing it in the tariffRepo.
void	handleMessage(org.powertac.common.msg.EconomicControlEvent msg)	Processes an incoming ControlEvent from a broker
void	handleMessage(org.powertac.common.msg.TariffExpire update)	Handles changes in tariff expiration date.
void	handleMessage(org.powertac.common.msg.TariffRevoke update)	Handles tariff revocation.
void	handleMessage(org.powertac.common.msg.VariableRateUpdate update)	Applies a new HourlyCharge to an existing Tariff with a variable Rate.
void	handleMessage(TariffSpecification spec)	Processes a newly-published tariff.
String	initialize(Competition competition, List<String> completedInits)	Reads configuration parameters, registers for timeslot phase activation.
void	processRevokedTariffs()	Runs through the list of pending tariff revocations, marking the tariffs and their subscriptions.
void	registerNewTariffListener(NewTariffListener listener)
boolean	setDefaultTariff(TariffSpecification newSpec)
void	setPublicationInterval(int interval)
void	setPublicationOffset(int offset)
void	subscribeToTariff(Tariff tariff, CustomerInfo customer, int customerCount)	If customerCount is positive, subscribes a block of Customers from a single Customer model to the specified Tariff, as long as the Tariff is not expired or revoked.

Methods inherited from class org.powertac.common.interfaces.TimeslotPhaseProcessor

init, setTimeslotPhase

Methods inherited from class java.lang.Object

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

Constructor Detail

TariffMarketService

public TariffMarketService()

Default constructor

Method Detail

initialize

public String initialize(Competition competition,
                         List<String> completedInits)

Reads configuration parameters, registers for timeslot phase activation.

Specified by:

initialize in interface InitializationService

getMinPublicationFee

public double getMinPublicationFee()

getMaxPublicationFee

public double getMaxPublicationFee()

getPublicationFee

public Double getPublicationFee()

getMinRevocationFee

public double getMinRevocationFee()

getMaxRevocationFee

public double getMaxRevocationFee()

getRevocationFee

public Double getRevocationFee()

getPublicationInterval

public int getPublicationInterval()

setPublicationInterval

@ConfigurableValue(valueType="Integer",
                   description="Number of timeslots between tariff publication events. Must be at most 24.")
public void setPublicationInterval(int interval)

getPublicationOffset

public int getPublicationOffset()

setPublicationOffset

@ConfigurableValue(valueType="Integer",
                   description="Number of timeslots from the first timeslot to delay the first publication event. It does not work well to make this zero, because brokers do not have an opportunity to post tariffs in timeslot 0.")
public void setPublicationOffset(int offset)

handleMessage

public void handleMessage(TariffSpecification spec)

Processes a newly-published tariff.

handleMessage

public void handleMessage(org.powertac.common.msg.TariffExpire update)

Handles changes in tariff expiration date.

handleMessage

public void handleMessage(org.powertac.common.msg.TariffRevoke update)

Handles tariff revocation.

handleMessage

public void handleMessage(org.powertac.common.msg.VariableRateUpdate update)

Applies a new HourlyCharge to an existing Tariff with a variable Rate.

handleMessage

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

Processes an incoming ControlEvent from a broker

handleMessage

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

Processes an incoming BalancingOrder by storing it in the tariffRepo. Balancing orders can be used for interruptible tariffs, but not in the presence of RegulationRates. For tariffs with RegulationRates, the BalancingOrders are automatically constructed from the RRs. In other words, BalancingOrders can be used to permit up-regulation through curtailment, but not if the customer expects to be paid for the balancing events.

processRevokedTariffs

public void processRevokedTariffs()

Runs through the list of pending tariff revocations, marking the tariffs and their subscriptions.

Specified by:

processRevokedTariffs in interface TariffMarket

registerNewTariffListener

public void registerNewTariffListener(NewTariffListener listener)

Specified by:

registerNewTariffListener in interface TariffMarket

activate

public void activate(org.joda.time.Instant time,
                     int phase)

Specified by:

activate in class TimeslotPhaseProcessor

getActiveTariffList

public List<Tariff> getActiveTariffList(org.powertac.common.enumerations.PowerType type)

Specified by:

getActiveTariffList in interface TariffMarket

getDefaultTariff

public Tariff getDefaultTariff(org.powertac.common.enumerations.PowerType type)

Returns the default tariff

Specified by:

getDefaultTariff in interface TariffMarket

setDefaultTariff

public boolean setDefaultTariff(TariffSpecification newSpec)

Specified by:

setDefaultTariff in interface TariffMarket

subscribeToTariff

public void subscribeToTariff(Tariff tariff,
                              CustomerInfo customer,
                              int customerCount)

If customerCount is positive, subscribes a block of Customers from a single Customer model to the specified Tariff, as long as the Tariff is not expired or revoked. If customerCount is negative, unsubscribes a block of customers from the specified tariff. Processing is deferred unless the customer has no subscriptions, which should only be true at the start of a boot or sim session.

Note that you cannot unsubscribe directly from a Tariff -- you have to do that from the TariffSubscription that represents the Tariff you want to unsubscribe from.

Specified by:

subscribeToTariff in interface TariffMarket