From b78295e8da96c3e5e76befeef9582ce5273dbb74 Mon Sep 17 00:00:00 2001
From: yeg <1347747024@qq.com>
Date: 星期二, 29 九月 2026 13:10:23 +0800
Subject: [PATCH] 按代码规范检查整改实体注释、Service Javadoc 与分层边界
---
battery-device-bts/src/main/java/com/battery/device/bts/BtsDeviceAdapter.java | 29 +++++++++--------------------
1 files changed, 9 insertions(+), 20 deletions(-)
diff --git a/battery-device-bts/src/main/java/com/battery/device/bts/BtsDeviceAdapter.java b/battery-device-bts/src/main/java/com/battery/device/bts/BtsDeviceAdapter.java
index d35c3a0..f18583f 100644
--- a/battery-device-bts/src/main/java/com/battery/device/bts/BtsDeviceAdapter.java
+++ b/battery-device-bts/src/main/java/com/battery/device/bts/BtsDeviceAdapter.java
@@ -5,12 +5,10 @@
import java.util.Map;
import java.util.Set;
import com.battery.device.api.DeviceAdapter;
-import com.battery.device.model.AdapterCapabilities;
-import com.battery.device.model.ChannelIdentity;
-import com.battery.device.model.DetectedChannel;
-import com.battery.device.model.HistoryAvailability;
-import com.battery.device.model.HistoryPage;
-import com.battery.device.model.RealtimeSnapshot;
+import com.battery.device.api.model.AdapterCapabilities;
+import com.battery.device.api.model.ChannelIdentity;
+import com.battery.device.api.model.DetectedChannel;
+import com.battery.device.api.model.RealtimeSnapshot;
public final class BtsDeviceAdapter implements DeviceAdapter
{
@@ -33,24 +31,28 @@
this.capabilities = capabilities;
}
+ /** 返回本实例登记的适配器编码。 */
@Override
public String adapterCode()
{
return adapterCode;
}
+ /** 返回本实例登记的能力标记；BTS 协议路线按只观测装配。 */
@Override
public AdapterCapabilities capabilities()
{
return capabilities;
}
+ /** 通过设备信息命令读取通道登记事实，作为发现候选返回。 */
@Override
public List<DetectedChannel> discoverChannels()
{
return codec.parseDeviceInfo(transport.exchange(codec.getDeviceInfoRequest()));
}
+ /** 按给定通道集合请求一次实时状态；通道为空时不发请求。 */
@Override
public Map<ChannelIdentity, RealtimeSnapshot> inquire(Set<ChannelIdentity> channels)
{
@@ -58,22 +60,9 @@
return codec.parseSnapshots(transport.exchange(codec.inquireRequest(channels, false)), Instant.now());
}
- @Override
- public List<HistoryAvailability> inquireHistory(Set<ChannelIdentity> channels)
- {
- if (!capabilities.historyDownload()) throw new UnsupportedOperationException("History download is not supported");
- if (channels == null || channels.isEmpty()) return List.of();
- return codec.parseHistoryAvailability(transport.exchange(codec.inquireHistoryRequest(channels)));
- }
- @Override
- public HistoryPage downloadHistory(ChannelIdentity channel, String btsTestId, long startPosition, int limit)
- {
- if (!capabilities.historyDownload()) throw new UnsupportedOperationException("History download is not supported");
- return codec.parseHistory(transport.exchange(codec.downloadRequest(channel, btsTestId, startPosition, limit)),
- channel, btsTestId, startPosition);
- }
+ /** 关闭底层传输连接。 */
@Override
public void close()
{
--
Gitblit v1.7.1