chore: 提交所有当前改动

wanshenmean

2026-03-17 737dec3c384f394fd6f9849b4480b697d1ba35d5

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
using Microsoft.Extensions.Options;
using System;
using System.Collections.Generic;
using System.IO;
using System.Net.Sockets;
using System.Text;
using System.Threading;
using System.Threading.Tasks;
using WIDESEAWCS_QuartzJob;
 
namespace WIDESEAWCS_Tasks.SocketServer
{
    /// <summary>
    /// TCP Socket·þÎñ¶Ë£¨»ùÓÚÐÐЭÒ飬°´»»Ðзû·Ö¸îÏûÏ¢£©
    /// </summary>
    public partial class TcpSocketServer : IDisposable
    {
        private readonly SocketServerOptions _options;
 
        /// <summary>
        /// Ìṩһ¸ö¿ÉÓÃÓÚͬ²½¶Ô°üº¬ÊµÀýµÄ·ÃÎʵĶÔÏó¡£
        /// </summary>
        /// <remarks>ÔÚ¶ÔʵÀýʵÏÖḬ̈߳²È«²Ù×÷ʱ£¬¿É½«´Ë¶ÔÏóÓÃ×÷Ëø¶¨Ä¿±ê¡£´Ëģʽͨ³£ÓÃÓÚ±ÜÃâËÀËø²¢È·±£Ò»ÖµÄͬ²½¡£</remarks>
        public readonly object _syncRoot = new();
 
        private TcpListener? _listener;
 
        /// <summary>
        /// ±íʾÓÃÓÚ·¢³ö½øÐÐÖвÙ×÷µÄÈ¡ÏûÇëÇóµÄÈ¡ÏûÁîÅÆÔ´¡£
        /// </summary>
        /// <remarks>Èç¹ûµ±Ç°Ã»ÓлµÄÈ¡Ïû»úÖÆ£¬´Ë×ֶοÉÄÜΪnull¡£Ê¹ÓôËÁîÅÆÔ´È¡ÏûÖ§³ÖÈ¡ÏûµÄÈÎÎñ»ò²Ù×÷¡£</remarks>
        public CancellationTokenSource? _cts;
 
        /// <summary>
        /// Ìṩ±íʾ»î¶¯¿Í»§¶Ë²Ù×÷µÄÈÎÎñÁÐ±í¡£
        /// </summary>
        /// <remarks>´Ë×Ö¶ÎÓÃÓÚÄÚ²¿¸ú×ÙÒì²½¿Í»§¶Ë»î¶¯¡£ËüÊÇÖ»¶ÁµÄ£¬²»Ó¦ÔÚ°üº¬ÀàÍⲿֱ½ÓÐ޸ġ£</remarks>
        public readonly List<Task> _clientTasks = new();
 
        /// <summary>
        /// Ìṩ´Ó¿Í»§¶Ë±êʶ·ûµ½Æä¹ØÁªµÄTCP¿Í»§¶ËÁ¬½ÓµÄÓ³Éä¡£
        /// </summary>
        /// <remarks>´Ë×ÖµäÔÊÐíͨ¹ýΨһ×Ö·û´®±êʶ·û·ÃÎʻµÄTCP¿Í»§¶Ë¡£ÔÚ¶àÏ̳߳¡¾°ÖУ¬¶Ô¼¯ºÏµÄÐÞ¸ÄӦСÐĽøÐÐÒÔ±ÜÃâ²¢·¢ÎÊÌâ¡£</remarks>
        public readonly Dictionary<string, TcpClient> _clients = new();
 
        /// <summary>
        /// Ìṩ´ÓÉ豸±êʶ·ûµ½Æä¶ÔÓ¦°ó¶¨ÖµµÄÓ³Éä¡£
        /// </summary>
        /// <remarks>´Ë×Ö¶ÎÊÇÖ»¶ÁµÄ£¬ÓÃÓÚ°üº¬ÀàÄÚ²¿Ê¹Óá£Ó¦Í¨¹ýÖ¸¶¨µÄ·½·¨»òÊôÐÔ¶Ô×Öµä½øÐÐÐÞ¸ÄÒÔÈ·±£Ò»ÖÂÐÔ¡£</remarks>
        public readonly Dictionary<string, string> _deviceBindings = new();
 
        /// <summary>
        /// Ìṩ´Ó¿Í»§¶Ë±êʶ·ûµ½Æä¹ØÁªËøµÄÓ³É䣬ÓÃÓÚͬ²½¶Ô¿Í»§¶ËÌض¨×ÊÔ´µÄ·ÃÎÊ¡£
        /// </summary>
        /// <remarks>×ÖµäÖеÄÿ¸öÌõÄ¿½«Ò»¸öΨһµÄ¿Í»§¶ËIDÓëÒ»¸ö<see cref="SemaphoreSlim"/>ʵÀý¹ØÁª£¬ÊµÏÖÿ¸ö¿Í»§¶ËµÄḬ̈߳²È«²Ù×÷¡£´Ë¼¯ºÏÓÃÓÚÄÚ²¿Ð­µ÷²¢·¢·ÃÎÊ£¬²»Ó¦Ö±½ÓÐ޸ġ£</remarks>
        public readonly Dictionary<string, SemaphoreSlim> _clientLocks = new();
 
        /// <summary>
        /// Ìṩ´Ó¿Í»§¶Ë±êʶ·ûµ½Æä¹ØÁªÎı¾±àÂëµÄÓ³Éä¡£
        /// </summary>
        /// <remarks>´Ë×ÖµäÓÃÓÚÄÚ²¿¸ú×ÙÒÑÁ¬½Ó¿Í»§¶ËµÄ±àÂëÆ«ºÃ¡£¼ü±íʾ¿Í»§¶Ë±êʶ·û£¬ÖµÖ¸¶¨ÓÃÓÚÎı¾²Ù×÷µÄ¶ÔÓ¦<see cref="System.Text.Encoding"/>¡£</remarks>
        public readonly Dictionary<string, Encoding> _clientEncodings = new();
 
        /// <summary>
        /// ´æ´¢Ã¿¸ö¿Í»§¶Ë×îºó»î¶¯µÄʱ¼ä´Á£¬ÒÔ¿Í»§¶Ë±êʶ·ûΪ¼ü¡£
        /// </summary>
        /// <remarks>´Ë×Ö¶ÎÓÃÓÚÄÚ²¿¸ú×Ù¿Í»§¶Ë»î¶¯¡£×ֵ佫¿Í»§¶Ë±êʶ·ûÓ³Éäµ½¶ÔÓ¦µÄ×îºó»î¶¯Ê±¼ä£¨UTC£©¡£Ö±½ÓÐ޸Ĵ˼¯ºÏ¿ÉÄÜÓ°Ïì¿Í»§¶Ë»á»°¹ÜÀíÂß¼­¡£</remarks>
        public readonly Dictionary<string, DateTime> _clientLastActive = new();
 
        /// <summary>
        /// Ö¸¶¨°üº¬ÀàÐÍÖÐ×Ö·ûÊý¾ÝʹÓõÄÎı¾±àÂë¡£
        /// </summary>
        /// <remarks>ʹÓôË×Ö¶ÎÈ·¶¨´¦Àí×Ö·ûÊý¾ÝʱÈçºÎ±àÂë»ò½âÂëÎı¾¡£±àÂëÓ°Ïì×Ö½ÚÈçºÎ±»½âÊÍΪ×Ö·û£¬·´Ö®ÒàÈ»¡£³£¼ûµÄ±àÂë°üÀ¨UTF8¡¢ASCIIºÍUnicode¡£</remarks>
        public readonly Encoding _textEncoding;
 
        /// <summary>
        /// ±íʾ×Ô¶¯¼ì²âµ½µÄGB2312±àÂ루Èç¹û¿ÉÓã©¡£
        /// </summary>
        /// <remarks>ͨ³£´ÓÊäÈëÊý¾ÝÈ·¶¨±àÂëʱÉèÖôË×ֶΡ£Èç¹û¼ì²âʧ°Ü»òδִÐмì²â£¬Öµ¿ÉÄÜΪnull¡£</remarks>
        public readonly Encoding? _autoDetectedGb2312;
 
        private readonly string _logFile;
 
        private Task? _monitorTask;
 
        /// <summary>
        /// Ê¹ÓÃÖ¸¶¨µÄ·þÎñÆ÷Ñ¡Ïî³õʼ»¯ TcpSocketServer ÀàµÄÐÂʵÀý¡£
        /// </summary>
        /// <remarks>Èç¹ûÆôÓÃÁË AutoDetectEncoding Ñ¡Ï·þÎñÆ÷½«Ä¬ÈÏʹÓàUTF-8 ±àÂ룬
        /// ²¢³¢ÊÔÖ§³Ö GBK ±àÂë½øÐÐ×Ô¶¯¼ì²â¡£Èç¹û±àÂë¼ì²âʧ°Ü»òÌṩÁËÎÞЧµÄ±àÂëÃû³Æ£¬
        /// ½«»ØÍËʹÓàUTF-8 ±àÂë¡£ÈÕÖ¾Îļþ·¾¶ÓÉ LogFilePath Ñ¡Ïî¾ö¶¨£¬
        /// Èç¹ûδָ¶¨£¬ÔòĬÈÏΪӦÓóÌÐò»ùĿ¼ÏµĠ'socketserver.log' Îļþ¡£</remarks>
        /// <param name="options">Ì×½Ó×Ö·þÎñÆ÷µÄÅäÖÃÑ¡Ïî¡£²»ÄÜΪ null¡£Ìṩ±àÂëÉèÖá¢ÈÕÖ¾Îļþ·¾¶ºÍ×Ô¶¯¼ì²âÐÐΪµÈÅäÖá£</param>
        public TcpSocketServer(IOptions<SocketServerOptions> options)
        {
            _options = options.Value;
            if (_options.AutoDetectEncoding)
            {
                _textEncoding = Encoding.UTF8;
                try { _autoDetectedGb2312 = Encoding.GetEncoding("GBK"); } catch { _autoDetectedGb2312 = null; }
            }
            else
            {
                try { _textEncoding = Encoding.GetEncoding(_options.EncodingName ?? "utf-8"); }
                catch { _textEncoding = Encoding.UTF8; }
                _autoDetectedGb2312 = null;
            }
 
            _logFile = Path.Combine(AppContext.BaseDirectory ?? ".", _options.LogFilePath ?? "socketserver.log");
            Log($"[{DateTime.Now}] TcpSocketServer starting");
        }
 
        public bool IsRunning { get; private set; }
 
        public event Func<string, bool, TcpClient, RobotSocketState, Task<string?>>? MessageReceived;
 
        public event Func<string, Task<string?>>? RobotReceived;
 
        private void Log(string message)
        {
            Console.WriteLine(message);
            try { File.AppendAllText(_logFile, message + Environment.NewLine); } catch { }
        }
    }
}