Package io.openems.edge.timedata.test

Class DummyTimedata

java.lang.Object

io.openems.edge.common.component.AbstractOpenemsComponent

io.openems.edge.timedata.test.DummyTimedata

All Implemented Interfaces:

CommonTimedataService, OpenemsComponent, Timedata

public class DummyTimedata
extends AbstractOpenemsComponent
implements Timedata

Provides a simple, simulated Timedata component that can be used together with the OpenEMS Component test framework.

Nested Class Summary

Nested classes/interfaces inherited from interface io.openems.edge.common.component.OpenemsComponent

OpenemsComponent.ChannelId

Nested classes/interfaces inherited from interface io.openems.edge.timedata.api.Timedata

Timedata.ChannelId

Constructor Summary

Constructors

Constructor	Description
DummyTimedata(java.lang.String id)

Method Summary

Modifier and Type	Method	Description
void	add(java.time.ZonedDateTime timestamp, ChannelAddress channelAddress, com.google.gson.JsonElement value)	Adds a value to the Dummy Timedata.
void	add(java.time.ZonedDateTime timestamp, ChannelAddress channelAddress, java.lang.Integer value)	Adds a value to the Dummy Timedata.
java.util.concurrent.CompletableFuture<java.util.Optional<java.lang.Object>>	getLatestValue(ChannelAddress channelAddress)	Gets the latest known value for the given ChannelAddress.
java.util.SortedMap<java.time.ZonedDateTime,java.util.SortedMap<ChannelAddress,com.google.gson.JsonElement>>	queryHistoricData(java.lang.String edgeId, java.time.ZonedDateTime fromDate, java.time.ZonedDateTime toDate, java.util.Set<ChannelAddress> channels, Resolution resolution)	Queries historic data.
java.util.SortedMap<ChannelAddress,com.google.gson.JsonElement>	queryHistoricEnergy(java.lang.String edgeId, java.time.ZonedDateTime fromDate, java.time.ZonedDateTime toDate, java.util.Set<ChannelAddress> channels)	Queries historic energy.
java.util.SortedMap<java.time.ZonedDateTime,java.util.SortedMap<ChannelAddress,com.google.gson.JsonElement>>	queryHistoricEnergyPerPeriod(java.lang.String edgeId, java.time.ZonedDateTime fromDate, java.time.ZonedDateTime toDate, java.util.Set<ChannelAddress> channels, Resolution resolution)	Queries historic energy per period.

Methods inherited from class io.openems.edge.common.component.AbstractOpenemsComponent

_channel, activate, activate, addChannel, addChannels, addChannels, alias, channels, deactivate, getComponentContext, id, isEnabled, logDebug, logError, logInfo, logWarn, modified, removeChannel

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.openems.common.timedata.CommonTimedataService

handleQueryHistoricTimeseriesExportXlxsRequest, queryHistoricData

Methods inherited from interface io.openems.edge.common.component.OpenemsComponent

_channel, _getChannelAs, alias, channel, channel, channels, debugLog, getComponentContext, getState, getStateChannel, hasFaults, id, isEnabled, serviceFactoryPid, servicePid

Constructor Detail

DummyTimedata

public DummyTimedata(java.lang.String id)

Method Detail

add

public void add(java.time.ZonedDateTime timestamp,
                ChannelAddress channelAddress,
                java.lang.Integer value)

Adds a value to the Dummy Timedata.

Parameters:

timestamp - the ZonedDateTime

channelAddress - the ChannelAddress

value - the value as Integer

add

public void add(java.time.ZonedDateTime timestamp,
                ChannelAddress channelAddress,
                com.google.gson.JsonElement value)

Adds a value to the Dummy Timedata.

Parameters:

timestamp - the ZonedDateTime

channelAddress - the ChannelAddress

value - the value as JsonElement

queryHistoricData

public java.util.SortedMap<java.time.ZonedDateTime,java.util.SortedMap<ChannelAddress,com.google.gson.JsonElement>> queryHistoricData(java.lang.String edgeId,
                                                                                                                                                  java.time.ZonedDateTime fromDate,
                                                                                                                                                  java.time.ZonedDateTime toDate,
                                                                                                                                                  java.util.Set<ChannelAddress> channels,
                                                                                                                                                  Resolution resolution)
                                                                                                                                           throws OpenemsError.OpenemsNamedException

Description copied from interface: CommonTimedataService

Queries historic data.

Specified by:

queryHistoricData in interface CommonTimedataService

Parameters:

edgeId - the Edge-ID; or null query all

fromDate - the From-Date

toDate - the To-Date

channels - the Channels

resolution - the Resolution

Returns:

the query result

Throws:

OpenemsError.OpenemsNamedException

queryHistoricEnergy

public java.util.SortedMap<ChannelAddress,com.google.gson.JsonElement> queryHistoricEnergy(java.lang.String edgeId,
                                                                                                 java.time.ZonedDateTime fromDate,
                                                                                                 java.time.ZonedDateTime toDate,
                                                                                                 java.util.Set<ChannelAddress> channels)
                                                                                          throws OpenemsError.OpenemsNamedException

Description copied from interface: CommonTimedataService

Queries historic energy.

Specified by:

queryHistoricEnergy in interface CommonTimedataService

Parameters:

edgeId - the Edge-ID; or null query all

fromDate - the From-Date

toDate - the To-Date

channels - the Channels

Returns:

the query result

Throws:

OpenemsError.OpenemsNamedException

queryHistoricEnergyPerPeriod

public java.util.SortedMap<java.time.ZonedDateTime,java.util.SortedMap<ChannelAddress,com.google.gson.JsonElement>> queryHistoricEnergyPerPeriod(java.lang.String edgeId,
                                                                                                                                                             java.time.ZonedDateTime fromDate,
                                                                                                                                                             java.time.ZonedDateTime toDate,
                                                                                                                                                             java.util.Set<ChannelAddress> channels,
                                                                                                                                                             Resolution resolution)
                                                                                                                                                      throws OpenemsError.OpenemsNamedException

Description copied from interface: CommonTimedataService

Queries historic energy per period.

This is for use-cases where you want to get the energy for each period (with Resolution) per Channel, e.g. to visualize energy in a histogram chart. For each period the energy is calculated by subtracting first value of the period from the last value of the period.

Specified by:

queryHistoricEnergyPerPeriod in interface CommonTimedataService

Parameters:

edgeId - the Edge-ID; or null query all

fromDate - the From-Date

toDate - the To-Date

channels - the Channels

resolution - the Resolution

Returns:

the query result

Throws:

OpenemsError.OpenemsNamedException

getLatestValue

public java.util.concurrent.CompletableFuture<java.util.Optional<java.lang.Object>> getLatestValue(ChannelAddress channelAddress)

Description copied from interface: Timedata

Gets the latest known value for the given ChannelAddress.

Specified by:

getLatestValue in interface Timedata

Parameters:

channelAddress - the ChannelAddress to be queried

Returns:

the latest known value or Empty