Display_D_HP/TeamAAS-VM/Services/MesService.cs

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Text;
using System.Threading;
using System.Threading.Tasks;
using TeamAAS_VP.Interfaces;
using TeamAAS_VP.Models;

namespace TeamAAS_VP.Services
{
    /// <summary>
    /// 基于 <see cref="HttpClient"/> 的 MES 通信服务实现。
    /// <para>
    /// 本服务通过注入的 <see cref="IConfigService"/> 获取设备配置（包含 MES 接口地址），
    /// 提供对站点查询（StationGetAsync）和提交（SubmitGetAsync）的 GET 请求封装并带有重试逻辑。
    /// </para>
    /// <para>
    /// 注意：
    /// - <see cref="_httpClient"/> 为可复用的单一实例，建议在服务生命周期内重用以避免端口耗尽。
    /// - 本类实现了显式的 <see cref="Dispose"/> 方法以释放内部 <see cref="HttpClient"/> 资源，调用后实例不可再用。
    /// </para>
    /// </summary>
    public class MesService : IMesService
    {
        /// <summary>
        /// 用于执行 HTTP 请求的客户端实例。建议在服务生命周期内重用，避免频繁创建导致套接字/端口耗尽。
        /// </summary>
        private readonly HttpClient _httpClient;

        /// <summary>
        /// 配置服务，用于获取设备信息（包含 MES URL、是否启用 MES 等）。
        /// </summary>
        private readonly IConfigService _configService;

        /// <summary>
        /// 标记实例是否已释放，防止重复释放和在释放后继续使用导致未定义行为。
        /// </summary>
        private bool _disposed;

        /// <summary>
        /// 使用指定的配置服务创建 <see cref="MesService"/> 实例。
        /// </summary>
        /// <param name="configService">用于获取设备配置信息的实现，不能为空。</param>
        /// <exception cref="ArgumentNullException">当 <paramref name="configService"/> 为 null 时抛出。</exception>
        public MesService(IConfigService configService)
        {
            _configService = configService ?? throw new ArgumentNullException(nameof(configService));
            _httpClient = new HttpClient();
            _disposed = false;
        }


        /// <summary>
        /// 向配置中指定的 MES 站点 URL 发起 GET 请求（用于过站查询）。
        /// </summary>
        /// <param name="sn">要查询的序列号（SN）。</param>
        /// <param name="cancellationToken">可选的取消令牌，用于请求超时或取消。</param>
        /// <returns>
        /// 返回元组 (IsSuccess, Response)：
        /// - IsSuccess: 请求是否视为成功（即 MES 返回了预期的 "SFC_OK" 且包含 "unit_process_check=OK"）。
        /// - Response: 原始响应文本或错误信息说明（如 "MES功能未启用!"、"Missing MES station URL"、"Canceled" 等）。
        /// </returns>
        /// <remarks>
        /// 行为说明：
        /// - 从配置获取设备信息，若 MES 未启用则直接返回 IsSuccess=true 且 Response 为提示文本（不视为错误）。
        /// - 若未配置 MES URL 则返回 IsSuccess=false 与错误文本。
        /// - 使用配置的 URL（通过 <see cref="string.Format"/> 填充 sn）发起 GET 请求，最多重试 10 次。
        /// - 只有当响应包含 "SFC_OK" 且包含 "unit_process_check=OK" 时视为成功并立即返回。
        /// - 捕获 <see cref="OperationCanceledException"/> 返回 "Canceled"，捕获其它异常则返回异常消息。
        /// - 若实例已被释放则抛出 <see cref="ObjectDisposedException"/>。
        /// </remarks>
        public async Task<(bool IsSuccess, string Response)> StationGetAsync(string sn, CancellationToken cancellationToken = default)
        {
            // 如果已经释放，则抛出异常，防止在已释放资源上继续操作。
            if (_disposed) throw new ObjectDisposedException(nameof(MesService));

            var device = _configService.GetDeviceInfo();
            if (device == null || !device.EnableMES)
            {
                return (true, "MES功能未启用!");
            }
            if (string.IsNullOrWhiteSpace(device.MesStationUrl))
                return (false, "Missing MES station URL");

            var url = string.Format(device.MesStationUrl, sn);

            (bool IsSuccess, string Response) result = (false, string.Empty);
            for (int i = 0; i < 5; i++)
            {
                try
                {
                    using (var rsp = await _httpClient.GetAsync(url, cancellationToken))
                    {
                        var text = await rsp.Content.ReadAsStringAsync();
                        // "SFC_OK" 代表和 MES 连接成功
                        if (text.Contains("SFC_OK"))
                        {
                            if (text.Contains("unit_process_check=OK"))
                            {
                                return (true, text);
                            }
                        }
                        result = (false, text);
                    }
                }
                catch (OperationCanceledException)
                {
                    result = (false, "Canceled");
                }
                catch (Exception ex)
                {
                    result = (false, ex.Message);
                }
            }
            return result;
        }

        /// <summary>
        /// 向 MES 发起站点查询请求，使用超时（秒）作为便捷重载。
        /// </summary>
        /// <param name="sn">序列号（SN）。</param>
        /// <param name="timeoutInSeconds">请求超时，单位为秒。</param>
        /// <returns>与 <see cref="StationGetAsync(string, CancellationToken)"/> 相同的返回语义。</returns>
        public async Task<(bool IsSuccess, string Response)> StationGetAsync(string sn, double timeoutInSeconds)
        {
            using (var cts = new CancellationTokenSource(TimeSpan.FromSeconds(timeoutInSeconds)))
            {
                return await StationGetAsync(sn, cts.Token);
            }
        }

        /// <summary>
        /// 向配置中指定的 MES 提交 URL 发起 GET 请求（用于提交测试结果/记录）。
        /// </summary>
        /// <param name="sn">要提交的序列号（SN）。</param>
        /// <param name="isSuccess">表示此次记录是否通过（true => PASS，false => FAIL）。</param>
        /// <param name="start_time">开始时间，提交时使用 "yyyy-MM-dd HH:mm:ss" 格式。</param>
        /// <param name="stop_time">结束时间，提交时使用 "yyyy-MM-dd HH:mm:ss" 格式。</param>
        /// <param name="cancellationToken">可选的取消令牌，用于请求超时或取消。</param>
        /// <returns>
        /// 返回元组 (IsSuccess, Response)：
        /// - IsSuccess: 提交是否被 MES 视为成功（收到 "SFC_OK" 且响应中无额外多行信息）。
        /// - Response: MES 返回文本或错误说明；当 MES 返回 "SFC_OK" 但包含额外多行信息（代表 SN 数据问题）时，IsSuccess 为 false 且 Response 为该文本。
        /// </returns>
        /// <remarks>
        /// 行为说明：
        /// - 从配置获取设备信息，若 MES 未启用则直接返回 IsSuccess=true 且 Response 为提示文本（不视为错误）。
        /// - 若未配置 MES 提交 URL 则返回 IsSuccess=false 与错误文本。
        /// - 使用配置的 URL（通过 <see cref="string.Format"/> 按顺序填充 sn、PASS/FAIL、start_time、stop_time）发起 GET 请求，最多重试 10 次。
        /// - 在收到包含 "SFC_OK" 的响应时，如果返回文本包含多行（有附加信息）则视为提交失败并返回该文本，否则视为提交成功。
        /// - 捕获 <see cref="OperationCanceledException"/> 返回 "Canceled"，捕获其它异常则返回异常消息。
        /// - 若实例已被释放则抛出 <see cref="ObjectDisposedException"/>。
        /// </remarks>
        public async Task<(bool IsSuccess, string Response)> SubmitGetAsync(string sn, bool isSuccess, DateTime start_time, DateTime stop_time, CancellationToken cancellationToken = default)
        {
            // 如果已经释放，则抛出异常，防止在已释放资源上继续操作。
            if (_disposed) throw new ObjectDisposedException(nameof(MesService));

            var device = _configService.GetDeviceInfo();
            if (device == null || !device.EnableMES)
            {
                return (true, "MES功能未启用!");
            }
            if (string.IsNullOrWhiteSpace(device.MesStationUrl))
                return (false, "Missing MES submit URL");

            var url = string.Format(device.MesStationUrl, sn, isSuccess ? "PASS" : "FAIL", start_time.ToString("yyyy-MM-dd HH:mm:ss"), stop_time.ToString("yyyy-MM-dd HH:mm:ss"));

            (bool IsSuccess, string Response) result = (false, string.Empty);
            for (int i = 0; i < 5; i++)
            {
                try
                {
                    using (var rsp = await _httpClient.GetAsync(url, cancellationToken))
                    {
                        var text = await rsp.Content.ReadAsStringAsync();
                        // "SFC_OK" 代表和 MES 连接成功
                        if (text.Contains("SFC_OK"))
                        {
                            // 如果有附加信息（多行），代表此 SN 数据有问题，视为失败并返回该文本
                            if (text.Split(new[] { '\n' }, StringSplitOptions.RemoveEmptyEntries).Length > 1)
                            {
                                return (false, text);
                            }
                            return (true, text);
                        }
                        result = (false, text);
                    }
                }
                catch (OperationCanceledException)
                {
                    result = (false, "Canceled");
                }
                catch (Exception ex)
                {
                    result = (false, ex.Message);
                }
            }
            return result;
        }

        /// <summary>
        /// 向 MES 提交请求的超时重载，使用超时（秒）作为便捷参数。
        /// </summary>
        /// <param name="sn">序列号（SN）。</param>
        /// <param name="isSuccess">是否通过（PASS/FAIL）。</param>
        /// <param name="start_time">开始时间。</param>
        /// <param name="stop_time">结束时间。</param>
        /// <param name="timeoutInSeconds">请求超时，单位为秒。</param>
        /// <returns>与 <see cref="SubmitGetAsync(string, bool, DateTime, DateTime, CancellationToken)"/> 相同的返回语义。</returns>
        public async Task<(bool IsSuccess, string Response)> SubmitGetAsync(string sn, bool isSuccess, DateTime start_time, DateTime stop_time, double timeoutInSeconds)
        {
            using (var cts = new CancellationTokenSource(TimeSpan.FromSeconds(timeoutInSeconds)))
            {
                return await SubmitGetAsync(sn, isSuccess, start_time, stop_time, cts.Token);
            }
        }

        /// <summary>
        /// 释放服务占用的托管资源（当前仅 <see cref="_httpClient"/>）。
        /// <para>本方法为幂等操作，重复调用不会产生异常。调用后实例不可再用于发起请求，尝试使用将抛出 <see cref="ObjectDisposedException"/>。</para>
        /// </summary>
        public void Dispose()
        {
            if (!_disposed)
            {
                _httpClient.Dispose();
                _disposed = true;
            }
        }
    }
}