org.powertac.common.interfaces
Interface TariffMarket

public interface TariffMarket

Tariff Market Receives, validates, and stores new tariffs, enforces tariff validity rules. Generates transactions to represent tariff publication fees. Provides convenience methods to find tariffs that might be of interest to Customers.

Note that all methods driven by messages from the incoming message channel are polymorphic methods that select by argument type at runtime. They all return a TariffStatus instance that can be routed back to the originating broker.

Author:

John Collins

Method Summary

List<org.powertac.common.Tariff>	getActiveTariffList(org.powertac.common.enumerations.PowerType type) Returns the list of currently active tariffs for the given PowerType.
org.powertac.common.Tariff	getDefaultTariff(org.powertac.common.enumerations.PowerType type) Returns the default tariff.
void	processRevokedTariffs() Revokes tariffs for which TariffRevoke messages have been received since the last time this method was called in an earlier timeslot.
void	registerNewTariffListener(NewTariffListener listener) Registers a listener for publication of new Tariffs.
boolean	setDefaultTariff(org.powertac.common.TariffSpecification newTariff) Convenience method to set the default tariff at the beginning of the game.
TariffSubscription	subscribeToTariff(org.powertac.common.Tariff tariff, org.powertac.common.CustomerInfo customer, int customerCount) Subscribes a block of Customers from a single Customer model to the specified Tariff, as long as the Tariff has not expired.

Method Detail

subscribeToTariff

TariffSubscription subscribeToTariff(org.powertac.common.Tariff tariff,
                                     org.powertac.common.CustomerInfo customer,
                                     int customerCount)

Subscribes a block of Customers from a single Customer model to the specified Tariff, as long as the Tariff has not expired. If the subscription succeeds, then the TariffSubscription instance is return, otherwise null.

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.

getActiveTariffList

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

Returns the list of currently active tariffs for the given PowerType. The list contains only non-expired tariffs that cover the given type.

getDefaultTariff

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

Returns the default tariff.

setDefaultTariff

boolean setDefaultTariff(org.powertac.common.TariffSpecification newTariff)

Convenience method to set the default tariff at the beginning of the game. Returns true just in case the tariff was valid and was successfully saved.

registerNewTariffListener

void registerNewTariffListener(NewTariffListener listener)

Registers a listener for publication of new Tariffs.

processRevokedTariffs

void processRevokedTariffs()

Revokes tariffs for which TariffRevoke messages have been received since the last time this method was called in an earlier timeslot.