package com.ruoyi.device.api;
|
|
import java.util.List;
|
import java.util.Map;
|
import java.util.Set;
|
import com.ruoyi.device.model.AdapterCapabilities;
|
import com.ruoyi.device.model.ChannelIdentity;
|
import com.ruoyi.device.model.DetectedChannel;
|
import com.ruoyi.device.model.DeviceControlCommand;
|
import com.ruoyi.device.model.HistoryAvailability;
|
import com.ruoyi.device.model.HistoryPage;
|
import com.ruoyi.device.model.RealtimeSnapshot;
|
|
public interface DeviceAdapter extends AutoCloseable
|
{
|
/** 返回适配器实例的稳定代码。 */
|
String adapterCode();
|
|
/** 返回运行时已启用的设备能力。 */
|
AdapterCapabilities capabilities();
|
|
/** 发现当前端点可见的检测柜通道。 */
|
List<DetectedChannel> discoverChannels();
|
|
/** 批量查询通道实时快照，不形成最终原始采集数据。 */
|
Map<ChannelIdentity, RealtimeSnapshot> inquire(Set<ChannelIdentity> channels);
|
|
/** 查询通道当前 BTS 测试的历史数据上传进度。 */
|
List<HistoryAvailability> inquireHistory(Set<ChannelIdentity> channels);
|
|
/** 分页下载单个通道的最终原始历史数据，每页最多 1000 条。 */
|
HistoryPage downloadHistory(ChannelIdentity channel, String btsTestId, long startPosition, int limit);
|
|
/** 执行设备控制；只读适配器始终拒绝该调用。 */
|
default void control(ChannelIdentity channel, DeviceControlCommand command)
|
{
|
throw new UnsupportedOperationException("Device control is not enabled for this adapter");
|
}
|
|
@Override
|
default void close()
|
{
|
}
|
}
|
