fix: repair decompiled sources and add exhaustive documentation

- restore generic signatures, scoped variables and missing code from original bytecode
- remove decompiler artifacts and document classes, methods, fields and packages
- restore resources, add Batik/BouncyCastle dependencies and build/runtime docs
This commit is contained in:
rick committed 2026-11-16 17:28:23 +08:00
1 parent 9d7e42eda8
commit 10aa1829f5
346 files changed
+42404 -622

No files matched your search

@@ -6,23 +6,78 @@ import java.util.UUID;
import org.springframework.data.annotation.Transient;
import org.springframework.data.mongodb.core.mapping.Document;
/**
* 【MongoDB 文档实体】{@code DeviceGroup}
*
* 类职责:
* <ul>
* <li>作为 MongoDB 集合文档,承载该领域对象的持久化字段与索引。</li>
* <li>通过字段/依赖注入持有运行期状态,字段含义见下方“核心字段”。</li>
* </ul>
*
* 核心字段(按声明顺序):
* <ul>
* <li>{@code siteUuid}(UUID):用户所属站点 UUID</li>
* <li>{@code parentUuid}(UUID):父级UUID</li>
* <li>{@code order}(Integer):字段 order</li>
* <li>{@code deviceNumbers}(Integer):设备Numbers</li>
* <li>{@code children}(List<DeviceGroup>):子级</li>
* </ul>
*
* 持久化/框架标记:{@code @Document} 映射为 MongoDB 集合。
*
* 学习提示:先看字段与 @Field/@Indexed,再看对应 Service/Repository 如何构造查询条件。
*/
@Document
public class DeviceGroup extends GeneralProfile implements Comparable {
public class DeviceGroup extends GeneralProfile implements Comparable<Object> {
/**
* 用户所属站点 UUID。
*/
private UUID siteUuid;
/**
* 父级UUID。
*/
private UUID parentUuid;
/**
* 字段 order。
*/
private Integer order;
/**
* 设备Numbers;不持久化到 MongoDB,仅运行时使用。
*
* 注解:{@code @Transient}。
*/
@Transient
private Integer deviceNumbers;
private List children;
/**
* 子级。
*/
private List<DeviceGroup> children;
/**
* 构造 {@code DeviceGroup} 实例。
* 使用默认字段值,后续通常由 Spring/Mongo 或调用方填充。
*/
public DeviceGroup() {
this.deviceNumbers = 0;
}
/**
* 构造 {@code DeviceGroup} 实例。
*
* @param uuid 对象 UUID({@code UUID})
*/
public DeviceGroup(UUID uuid) {
this.uuid = uuid;
}
/**
* 构造 {@code DeviceGroup} 实例。
*
* @param siteUuid 站点 UUID({@code UUID})
* @param parentUuid 参数 {@code parentUuid}({@code UUID})
* @param name 参数 {@code name}({@code String})
*/
public DeviceGroup(UUID siteUuid, UUID parentUuid, String name) {
this.init();
this.siteUuid = siteUuid;
@@ -30,50 +85,109 @@ public class DeviceGroup extends GeneralProfile implements Comparable {
this.setName(name);
}
/**
* 获取 {@code siteUuid}。
* @return UUID
*/
public UUID getSiteUuid() {
return this.siteUuid;
}
/**
* 设置 {@code siteUuid}。
*
* @param siteUuid 站点 UUID({@code UUID})
*/
public void setSiteUuid(UUID siteUuid) {
this.siteUuid = siteUuid;
}
/**
* 获取 {@code parentUuid}。
* @return UUID
*/
public UUID getParentUuid() {
return this.parentUuid;
}
/**
* 设置 {@code parentUuid}。
*
* @param parentUuid 参数 {@code parentUuid}({@code UUID})
*/
public void setParentUuid(UUID parentUuid) {
this.parentUuid = parentUuid;
}
/**
* 获取 {@code order}。
* @return 数量/长度
*/
public Integer getOrder() {
return this.order;
}
/**
* 设置 {@code order}。
*
* @param order 参数 {@code order}({@code Integer})
*/
public void setOrder(Integer order) {
this.order = order;
}
/**
* 获取 {@code deviceNumbers}。
* @return 数量/长度
*/
public Integer getDeviceNumbers() {
return this.deviceNumbers;
}
/**
* 设置 {@code deviceNumbers}。
*
* @param numbers 参数 {@code numbers}({@code Integer})
*/
public void setDeviceNumbers(Integer numbers) {
this.deviceNumbers = numbers == null ? 0 : numbers;
}
public List getChildren() {
/**
* 获取 {@code children}。
* @return 设备分组列表,可能为空
*/
public List<DeviceGroup> getChildren() {
return this.children;
}
public void setChildren(List children) {
/**
* 设置 {@code children}。
*
* @param children 参数 {@code children}({@code List<DeviceGroup>})
*/
public void setChildren(List<DeviceGroup> children) {
this.children = children;
}
/**
* 比较当前对象与另一个对象是否相等。
*
* @param uuid 对象 UUID({@code UUID})
* @return 条件成立返回 {@code true},否则返回 {@code false}
*/
public boolean equals(UUID uuid) {
return this.uuid != null && this.uuid.equals(uuid);
}
/**
* 按业务字段比较两个对象的顺序。
*
* 实现要点:包含 3 个条件分支、0 个循环。
*
* @param target 参数 {@code target}({@code Object})
* @return 数量/长度
*/
public int compareTo(Object target) {
UUID targetUuid = null;
if (target instanceof UUID) {