Package io.openems.common.jsonrpc.request

Class QueryHistoricTimeseriesEnergyRequest

java.lang.Object

io.openems.common.jsonrpc.base.JsonrpcMessage

io.openems.common.jsonrpc.base.AbstractJsonrpcRequest

io.openems.common.jsonrpc.base.JsonrpcRequest

io.openems.common.jsonrpc.request.QueryHistoricTimeseriesEnergyRequest

public class QueryHistoricTimeseriesEnergyRequest
extends JsonrpcRequest

Represents a JSON-RPC Request for 'queryHistoricTimeseriesEnergy'.

This Request is for use-cases where you want to get the energy for one period per Channel, e.g. to show the entire energy over a period as a text. The energy is calculated by subtracting first value of the period ('fromDate') from the last value of the period ('toDate').

 {
   "jsonrpc": "2.0",
   "id": "UUID",
   "method": "queryHistoricTimeseriesEnergy",
   "params": {
     "fromDate": YYYY-MM-DD,
     "toDate": YYYY-MM-DD,
     "channels": ChannelAddress[],
     "timezone": String,
     "resolution": {
       "value": Number,
       "unit": ChronoUnit
     }
   }
 }
 

Field Summary

Fields

Modifier and Type	Field	Description
static final String	METHOD

Fields inherited from class io.openems.common.jsonrpc.base.JsonrpcRequest

DEFAULT_TIMEOUT_SECONDS, id, NO_TIMEOUT, timeoutOpt

Fields inherited from class io.openems.common.jsonrpc.base.JsonrpcMessage

JSONRPC_VERSION

Constructor Summary

Constructors

Constructor	Description
QueryHistoricTimeseriesEnergyRequest(ZonedDateTime fromDate, ZonedDateTime toDate)

Method Summary

Modifier and Type	Method	Description
static QueryHistoricTimeseriesEnergyRequest	from(JsonrpcRequest r)	Create AuthenticateWithPasswordRequest from a template JsonrpcRequest.
TreeSet<ChannelAddress>	getChannels()	Gets the ChannelAddresses.
ZonedDateTime	getFromDate()	Gets the From-Date.
com.google.gson.JsonObject	getParams()	Gets the params JsonObject of the JsonrpcRequest.
ZonedDateTime	getToDate()	Gets the To-Date.

Methods inherited from class io.openems.common.jsonrpc.base.JsonrpcRequest

getId, getTimeout, toJsonObject

Methods inherited from class io.openems.common.jsonrpc.base.AbstractJsonrpcRequest

getFullyQualifiedMethod, getMethod

Methods inherited from class io.openems.common.jsonrpc.base.JsonrpcMessage

from, from, toString

Methods inherited from class java.lang.Object

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

Field Details

METHOD

public static final String METHOD

See Also:

• Constant Field Values

Constructor Details

QueryHistoricTimeseriesEnergyRequest

public QueryHistoricTimeseriesEnergyRequest(ZonedDateTime fromDate,
 ZonedDateTime toDate)
                                     throws OpenemsError.OpenemsNamedException

Throws:

OpenemsError.OpenemsNamedException

Method Details

from

public static QueryHistoricTimeseriesEnergyRequest from(JsonrpcRequest r)
                                                 throws OpenemsError.OpenemsNamedException

Create AuthenticateWithPasswordRequest from a template JsonrpcRequest.

Parameters:

r - the template JsonrpcRequest

Returns:

the AuthenticateWithPasswordRequest

Throws:

OpenemsError.OpenemsNamedException - on parse error

getParams

public com.google.gson.JsonObject getParams()

Description copied from class: AbstractJsonrpcRequest

Gets the params JsonObject of the JsonrpcRequest.

Specified by:

getParams in class AbstractJsonrpcRequest

Returns:

the params as JsonObject

getFromDate

public ZonedDateTime getFromDate()

Gets the From-Date.

Returns:

From-Date

getToDate

public ZonedDateTime getToDate()

Gets the To-Date.

Returns:

To-Date

getChannels

public TreeSet<ChannelAddress> getChannels()

Gets the ChannelAddresses.

Returns:

Set of ChannelAddress