AbstractCustomer (Power TAC accounting service 1.4.1 API)

java.lang.Object
- org.powertac.customer.AbstractCustomer

```
public abstract class AbstractCustomer
extends Object
```
Abstract customer implementation

Author:

Antonios Chrysopoulos

Field Summary

Fields
Modifier and Type	Field and Description
`protected List<CustomerInfo>`	`allCustomerInfos`
`protected HashMap<PowerType,List<CustomerInfo>>`	`customerInfos`
`protected static org.apache.logging.log4j.Logger`	`log`
`protected String`	`name`
`protected RandomSeed`	`rs1` Random Number Generator
`protected CustomerServiceAccessor`	`service`

Constructor Summary

Constructors
Constructor and Description
`AbstractCustomer()` Default constructor, requires explicit setting of name
`AbstractCustomer(String name)` Abstract Customer constructor with explicit name.

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addCustomerInfo(CustomerInfo info)` Adds an additional CustomerInfo to the list
`void`	`changeSubscription(Tariff tariff, Tariff newTariff, CustomerInfo customer)` In this overloaded implementation of the changing subscription function, Here we just put the tariff we want to change and the whole population is moved to another random tariff.
`abstract void`	`evaluateTariffs(List<Tariff> tariffs)` Called to evaluate tariffs.
`List<TariffSubscription>`	`getCurrentSubscriptions()` Returns the current tariff subscriptions for the first CustomerInfo.
`List<TariffSubscription>`	`getCurrentSubscriptions(PowerType type)` Returns the current tariff subscriptions for the first CustomerInfo with the given PowerType.
`long`	`getCustId()`
`CustomerInfo`	`getCustomerInfo(PowerType pt)` Returns the first CustomerInfo associated with this instance and PowerType.
`List<CustomerInfo>`	`getCustomerInfoList(PowerType pt)` Returns the list of CustomerInfos associated with this instance and PowerType.
`List<CustomerInfo>`	`getCustomerInfos()` Returns the list of CustomerInfo records associated with this customer model.
`long`	`getId()` Synonym for getCustId()
`String`	`getName()` Returns the name of this model
`int`	`getPopulation(CustomerInfo customer)`
`void`	`initialize()` Initializes the instance.
`protected org.joda.time.Instant`	`lastSunday()`
`protected org.joda.time.Instant`	`nextStartOfDay()`
`void`	`saveBootstrapState()` Saves model data to the bootstrap record.
`void`	`setName(String name)` Sets the name for this model
`void`	`setServiceAccessor(CustomerServiceAccessor csa)` Provides a reference to the service accessor, through which we can get at sim services
`void`	`setTariffMarket(TariffMarket service)`
`protected org.joda.time.Instant`	`startOfDay()`
`abstract void`	`step()` Called to run the model forward one step.
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - log
```
protected static org.apache.logging.log4j.Logger log
```
  - name
```
protected String name
```
  - customerInfos
```
protected HashMap<PowerType,List<CustomerInfo>> customerInfos
```
  - allCustomerInfos
```
protected List<CustomerInfo> allCustomerInfos
```
  - service
```
protected CustomerServiceAccessor service
```
  - rs1
```
protected RandomSeed rs1
```
    Random Number Generator
- Constructor Detail
  - AbstractCustomer
```
public AbstractCustomer()
```
    Default constructor, requires explicit setting of name
  - AbstractCustomer
```
public AbstractCustomer(String name)
```
    Abstract Customer constructor with explicit name.
- Method Detail
  - setServiceAccessor
```
public void setServiceAccessor(CustomerServiceAccessor csa)
```
    Provides a reference to the service accessor, through which we can get at sim services
  - initialize
```
public void initialize()
```
    Initializes the instance. Called after configuration, and after a call to setServices(). TODO -- do we really want this here?
  - saveBootstrapState
```
public void saveBootstrapState()
```
    Saves model data to the bootstrap record. Default implementation does nothing; models may override if they aggregate objects that must save state.
  - addCustomerInfo
```
public void addCustomerInfo(CustomerInfo info)
```
    Adds an additional CustomerInfo to the list
  - getCustomerInfo
```
public CustomerInfo getCustomerInfo(PowerType pt)
```
    Returns the first CustomerInfo associated with this instance and PowerType. It is up to individual models to fill out the fields.
  - getCustomerInfoList
```
public List<CustomerInfo> getCustomerInfoList(PowerType pt)
```
    Returns the list of CustomerInfos associated with this instance and PowerType.
  - getCustomerInfos
```
public List<CustomerInfo> getCustomerInfos()
```
    Returns the list of CustomerInfo records associated with this customer model.
  - getCurrentSubscriptions
```
public List<TariffSubscription> getCurrentSubscriptions()
```
    Returns the current tariff subscriptions for the first CustomerInfo. Useful for customer models with a single CustomerInfo.
  - getCurrentSubscriptions
```
public List<TariffSubscription> getCurrentSubscriptions(PowerType type)
```
    Returns the current tariff subscriptions for the first CustomerInfo with the given PowerType. Useful for customer models with a single CustomerInfo per PowerType.
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - getPopulation
```
public int getPopulation(CustomerInfo customer)
```
  - getCustId
```
public long getCustId()
```
  - getId
```
public long getId()
```
    Synonym for getCustId()
  - setName
```
public void setName(String name)
```
    Sets the name for this model
  - getName
```
public String getName()
```
    Returns the name of this model
  - step
```
public abstract void step()
```
    Called to run the model forward one step.
  - evaluateTariffs
```
public abstract void evaluateTariffs(List<Tariff> tariffs)
```
    Called to evaluate tariffs.
  - lastSunday
```
protected org.joda.time.Instant lastSunday()
```
  - startOfDay
```
protected org.joda.time.Instant startOfDay()
```
  - nextStartOfDay
```
protected org.joda.time.Instant nextStartOfDay()
```
  - setTariffMarket
```
public void setTariffMarket(TariffMarket service)
```
  - changeSubscription
```
public void changeSubscription(Tariff tariff,
                               Tariff newTariff,
                               CustomerInfo customer)
```
    In this overloaded implementation of the changing subscription function, Here we just put the tariff we want to change and the whole population is moved to another random tariff. NOTE: Used only for testing...
    
    Parameters:
    
    tariff -

Class AbstractCustomer

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

log

name

customerInfos

allCustomerInfos

service

rs1

Constructor Detail

AbstractCustomer

AbstractCustomer

Method Detail

setServiceAccessor

initialize

saveBootstrapState

addCustomerInfo

getCustomerInfo

getCustomerInfoList

getCustomerInfos

getCurrentSubscriptions

getCurrentSubscriptions

toString

getPopulation

getCustId

getId

setName

getName

step

evaluateTariffs

lastSunday

startOfDay

nextStartOfDay

setTariffMarket

changeSubscription