package com.ruoyi.energymeter.provider;
|
|
import com.ruoyi.energymeter.dto.MeterArchive;
|
import com.ruoyi.energymeter.dto.MeterQuarterPoint;
|
import com.ruoyi.energymeter.dto.MeterReadingPoint;
|
import com.ruoyi.energymeter.dto.MeterUsagePoint;
|
|
import java.time.LocalDate;
|
import java.util.List;
|
|
/**
|
* 第三方表计数据源。
|
*/
|
public interface MeterProviderClient {
|
|
/**
|
* 查询并严格匹配一条表计档案；匹配不到时抛出 NOT_FOUND。
|
*/
|
MeterArchive queryArchive(String meterType, String address);
|
|
/**
|
* 查询期间日用量。
|
*
|
* @param providerMeterId 第三方设备ID，气表用量接口要求传 ID 而不是通信地址
|
*/
|
List<MeterUsagePoint> queryDailyUsage(String meterType, String address, String providerMeterId,
|
LocalDate start, LocalDate end);
|
|
/**
|
* 查询时点示值。
|
*/
|
List<MeterReadingPoint> queryReadings(String meterType, String address, String providerMeterId,
|
LocalDate start, LocalDate end);
|
|
/**
|
* 查询 15 分钟粒度电量（当前仅电表支持，来自 ElectricQuantity 的 mi15 数据）。
|
*
|
* <p>返回的时间是时间片结束时间；active / reactive 为该时间片内的电量。</p>
|
*/
|
List<MeterQuarterPoint> queryQuarterUsage(String meterType, String address, String providerMeterId,
|
LocalDate start, LocalDate end);
|
|
/**
|
* 是否处于演示数据模式。
|
*/
|
boolean mockMode();
|
|
/**
|
* 是否已配置第三方授权码；未配置且非演示模式时不允许创建采集任务。
|
*/
|
boolean hasApiKey();
|
}
|
