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

Modifier and Type	Method and Description
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() Deprecated.
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.
void	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

void 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. The actual subscription processing is deferred until the TariffMarket is next activated. Unsubscribe is indicated by a negative value for customerCount.

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

@Deprecated
void processRevokedTariffs()

Deprecated.

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