From 750523a4124eb080ed5840c26e18bb0c2161e5fb Mon Sep 17 00:00:00 2001
From: yeg <1347747024@qq.com>
Date: 星期六, 05 九月 2026 00:22:33 +0800
Subject: [PATCH] 整理设备观测接缝验收注释
---
battery-device-api/src/main/java/com/battery/device/model/DeviceObservation.java | 5 +++--
1 files changed, 3 insertions(+), 2 deletions(-)
diff --git a/battery-device-api/src/main/java/com/battery/device/model/DeviceObservation.java b/battery-device-api/src/main/java/com/battery/device/model/DeviceObservation.java
index 0aa6e91..7cb5e9f 100644
--- a/battery-device-api/src/main/java/com/battery/device/model/DeviceObservation.java
+++ b/battery-device-api/src/main/java/com/battery/device/model/DeviceObservation.java
@@ -1,10 +1,10 @@
package com.battery.device.model;
import java.time.Instant;
+import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.Objects;
-import java.util.LinkedHashMap;
/** 厂商无关的一次通道观测结果。不得携带测试、持久化或传输层对象。 */
public record DeviceObservation(
@@ -27,7 +27,6 @@
channelWorkStatus = channelWorkStatus == null ? DeviceWorkStatus.UNOBSERVABLE : channelWorkStatus;
plannedSteps = plannedSteps == null ? List.of() : List.copyOf(plannedSteps);
measurements = measurements == null ? Map.of() : Map.copyOf(measurements);
- failureReason = failureReason;
if (connectionStatus == DeviceConnectionStatus.ONLINE && failureReason != null)
throw new IllegalArgumentException("online observation cannot contain a failure reason");
}
@@ -57,6 +56,7 @@
if (value != null) measurements.putIfAbsent(code, new Measurement(code, value, null, unit, "DEVICE"));
}
+ /** 返回本次观测是否确认设备在线。 */
public boolean online()
{
return connectionStatus == DeviceConnectionStatus.ONLINE;
@@ -68,6 +68,7 @@
return channelWorkStatus;
}
+ /** 创建不携带过期设备事实的离线观测。 */
public static DeviceObservation offline(ChannelIdentity channel, String failureReason)
{
Objects.requireNonNull(channel, "channel");
--
Gitblit v1.7.1