namespace NewLife.XCoder.Models;
/// <summary>API 服务信息</summary>
/// <remarks>
/// 字段名与服务端 <c>Api/Info</c> 应答保持一致(NewLife.Remoting 内置 ApiController),
/// NewLife 的 JSON 反序列化忽略大小写,因此 PascalCase 与 camelCase 两种应答都能识别。
/// 不同服务端返回的字段可以不同,取不到的字段保持空值,界面按空值跳过。
/// </remarks>
public class ApiServiceInfo
{
#region 属性
/// <summary>服务标识。内置 Api/Info 返回的是进程号,跨设备可能重复,去重时需结合地址</summary>
public Int32 Id { get; set; }
/// <summary>服务名称,如 StarAgent</summary>
public String Name { get; set; } = "";
/// <summary>服务标题,如 Stardust agent</summary>
public String Title { get; set; } = "";
/// <summary>版本号</summary>
public String Version { get; set; } = "";
/// <summary>文件版本</summary>
public String FileVersion { get; set; } = "";
/// <summary>编译时间</summary>
public String Compile { get; set; } = "";
/// <summary>操作系统</summary>
public String OS { get; set; } = "";
/// <summary>机器名</summary>
public String MachineName { get; set; } = "";
/// <summary>接口版本</summary>
public String ApiVersion { get; set; } = "";
/// <summary>设备自报的本机地址,多个地址以逗号分隔</summary>
public String LocalIP { get; set; } = "";
/// <summary>应答包来源地址</summary>
public String RemoteIP { get; set; } = "";
/// <summary>服务端口</summary>
public Int32 Port { get; set; }
/// <summary>服务端时间(应答里的 Time 字段)</summary>
public String Time { get; set; } = "";
/// <summary>在线会话数。内置 Api/Info 在携带令牌时返回</summary>
public Int32 Online { get; set; }
/// <summary>历史最大会话数</summary>
public Int32 MaxOnline { get; set; }
/// <summary>持续运行时长</summary>
public String Uptime { get; set; } = "";
/// <summary>设备编码。StarAgent 通过 Info 动作补充</summary>
public String Code { get; set; } = "";
/// <summary>服务器地址。StarAgent 通过 Info 动作补充</summary>
public String Server { get; set; } = "";
/// <summary>服务器地址。兼容部分服务端直接返回 Address 字段</summary>
public String Address { get; set; } = "";
/// <summary>原始应答 JSON</summary>
public String RawJson { get; set; } = "";
/// <summary>发现时间</summary>
public DateTime FoundTime { get; set; }
#endregion
#region 显示
/// <summary>地址(IP:端口)</summary>
public String EndPoint => Port > 0 ? $"{RemoteIP}:{Port}" : RemoteIP;
/// <summary>显示名称,缺少服务名时退回机器名</summary>
public String DisplayName => !Name.IsNullOrEmpty() ? Name : MachineName;
/// <summary>显示版本,优先 Version,其次 FileVersion</summary>
public String DisplayVersion => !Version.IsNullOrEmpty() ? Version : FileVersion;
/// <summary>服务器地址,兼容 Server 与 Address 两种字段</summary>
public String ServerAddress => !Server.IsNullOrEmpty() ? Server : Address;
/// <summary>显示用服务端时间,能解析时按本地格式输出</summary>
public String TimeText
{
get
{
var dt = Time.ToDateTime();
return dt > DateTime.MinValue ? dt.ToString("yyyy/MM/dd HH:mm:ss") : Time;
}
}
/// <summary>友好文本</summary>
/// <returns>名称与地址</returns>
public override String ToString() => $"{DisplayName} {EndPoint}";
#endregion
#region 归并
/// <summary>生成去重键。同一设备的多条应答归并为一条记录</summary>
/// <param name="info">服务信息</param>
/// <returns>去重键</returns>
public static String GetKey(ApiServiceInfo info)
{
if (info == null) return "";
// 设备自报的本机地址最能标识一台设备;没有地址时只能按应答来源区分
if (info.LocalIP.IsNullOrEmpty()) return $"{info.RemoteIP}|{info.Port}";
return $"{info.Name}|{info.MachineName}|{info.LocalIP}|{info.Id}|{info.Port}";
}
/// <summary>把新应答合并到已有记录。已有字段不被空值覆盖</summary>
/// <param name="target">已保存的记录</param>
/// <param name="source">新到的应答</param>
/// <returns>是否有字段发生变化</returns>
public static Boolean Merge(ApiServiceInfo target, ApiServiceInfo source)
{
if (target == null || source == null) return false;
// 同一设备的多个应答可能在不同线程同时到达,归并时加锁避免字段互相覆盖
lock (target)
{
return MergeCore(target, source);
}
}
private static Boolean MergeCore(ApiServiceInfo target, ApiServiceInfo source)
{
var changed = false;
changed |= Fill(target.Name, source.Name, v => target.Name = v);
changed |= Fill(target.Title, source.Title, v => target.Title = v);
changed |= Fill(target.Version, source.Version, v => target.Version = v);
changed |= Fill(target.FileVersion, source.FileVersion, v => target.FileVersion = v);
changed |= Fill(target.Compile, source.Compile, v => target.Compile = v);
changed |= Fill(target.OS, source.OS, v => target.OS = v);
changed |= Fill(target.MachineName, source.MachineName, v => target.MachineName = v);
changed |= Fill(target.ApiVersion, source.ApiVersion, v => target.ApiVersion = v);
changed |= Fill(target.LocalIP, source.LocalIP, v => target.LocalIP = v);
changed |= Fill(target.Time, source.Time, v => target.Time = v);
changed |= Fill(target.Uptime, source.Uptime, v => target.Uptime = v);
changed |= Fill(target.Code, source.Code, v => target.Code = v);
changed |= Fill(target.Server, source.Server, v => target.Server = v);
changed |= Fill(target.Address, source.Address, v => target.Address = v);
if (target.Id == 0 && source.Id != 0) { target.Id = source.Id; changed = true; }
if (target.Online == 0 && source.Online != 0) { target.Online = source.Online; changed = true; }
if (target.MaxOnline == 0 && source.MaxOnline != 0) { target.MaxOnline = source.MaxOnline; changed = true; }
if (target.Port <= 0 && source.Port > 0) { target.Port = source.Port; changed = true; }
// 广播应答的来源是广播地址,后续拿到真实地址时以真实地址为准
if (IsFakeAddress(target.RemoteIP) && !IsFakeAddress(source.RemoteIP))
{
target.RemoteIP = source.RemoteIP;
changed = true;
}
if (!source.RawJson.IsNullOrEmpty() && source.RawJson != target.RawJson)
{
target.RawJson = source.RawJson;
changed = true;
}
if (source.FoundTime > target.FoundTime) target.FoundTime = source.FoundTime;
return changed;
}
private static Boolean Fill(String current, String value, Action<String> setter)
{
if (!current.IsNullOrEmpty() || value.IsNullOrEmpty()) return false;
setter(value);
return true;
}
private static Boolean IsFakeAddress(String address)
{
if (address.IsNullOrEmpty()) return true;
return address is "0.0.0.0" or "255.255.255.255" or "::";
}
#endregion
}
|