Реализация команды disconnect отладчика

Author: EvilBeaver

src/OneScript.DebugProtocol/Abstractions/ICommunicationServer.cs

@@ -9,6 +9,9 @@ This Source Code Form is subject to the terms of the
 
 namespace OneScript.DebugProtocol.Abstractions
 {
+    /// <summary>
+    /// Сервис прослушивания сетевого канала и отправки в него сообщений 
+    /// </summary>
     public interface ICommunicationServer
     {
         void Start();

src/OneScript.DebugProtocol/IDebugEventListener.cs

@@ -10,6 +10,9 @@ This Source Code Form is subject to the terms of the
 
 namespace OneScript.DebugProtocol
 {
+    /// <summary>
+    /// Интерфейс слушателя событий отладки (сообщений, инициируемых со стороны BSL)       
+    /// </summary>
     public interface IDebugEventListener
     {
 #if NETFRAMEWORK

src/OneScript.DebugProtocol/IDebuggerService.cs

@@ -11,6 +11,9 @@ This Source Code Form is subject to the terms of the
 
 namespace OneScript.DebugProtocol
 {
+    /// <summary>
+    /// Сервис непосредственной работы с командами отладки, шагами, брейкпоинтами и пр. 
+    /// </summary>
 #if NETFRAMEWORK
     [ServiceContract(
         Namespace = "http://oscript.io/services/debugger", 
@@ -95,6 +98,14 @@ public interface IDebuggerService
         [OperationContract(IsOneWay = true)]
 #endif
         void StepOut(int threadId);
+        
+        /// <summary>
+        /// Отключение сеанса отладки по инициативе IDE
+        /// </summary>
+#if NETFRAMEWORK
+        [OperationContract(IsOneWay = true)]
+#endif
+        void Disconnect();
 
 #if NETFRAMEWORK
         [OperationContract]

src/OneScript.DebugProtocol/TcpServer/BinaryChannel.cs

@@ -5,7 +5,6 @@ This Source Code Form is subject to the terms of the
 at http://mozilla.org/MPL/2.0/.
 ----------------------------------------------------------*/
 
-using System;
 using System.IO;
 using System.Net.Sockets;
 using System.Runtime.Serialization;
@@ -14,7 +13,10 @@ This Source Code Form is subject to the terms of the
 
 namespace OneScript.DebugProtocol
 {
-    public class BinaryChannel : ICommunicationChannel, IDisposable
+    /// <summary>
+    /// TCP-канал, использующий стандартную Binary-сериализацию .NET
+    /// </summary>
+    public class BinaryChannel : ICommunicationChannel
     {
         private readonly TcpClient _client;
         private readonly NetworkStream _clientStream;

src/OneScript.DebugProtocol/TcpServer/DefaultMessageServer.cs

@@ -71,7 +71,7 @@ private void RunCommandsLoop()
                             // Считаем, что факап подписчика - его проблемы.
                         }
 
-                        // свойство в исключении может быть утановлено в обработчике евента
+                        // свойство в исключении может быть установлено в обработчике евента
                         _serverStopped = e.StopChannel;
                     }
                     catch (Exception)

src/OneScript.DebugServices/BinaryTcpDebugServer.cs

@@ -24,7 +24,10 @@ public IDebugController CreateDebugController()
         {
             var listener = TcpListener.Create(_port);
             var channel = new DelayedConnectionChannel(listener);
-            var ipcServer = new DefaultMessageServer<RpcCall>(channel);
+            var ipcServer = new DefaultMessageServer<RpcCall>(channel)
+            {
+                ServerThreadName = "debug-server"
+            };
             var callback = new TcpEventCallbackChannel(channel);
             var threadManager = new ThreadManager();
             var breakpoints = new DefaultBreakpointManager();

src/OneScript.DebugServices/DefaultBreakpointManager.cs

@@ -32,5 +32,10 @@ public bool Find(string module, int line)
             var found = _breakpoints.Find(x => x.Module.Equals(module) && x.LineNumber == line);
             return found != null;
         }
+
+        public void Clear()
+        {
+            _breakpoints.Clear();
+        }
     }
 }

src/OneScript.DebugServices/DefaultDebugController.cs

@@ -13,6 +13,11 @@ This Source Code Form is subject to the terms of the
 
 namespace OneScript.DebugServices
 {
+    /// <summary>
+    /// Простой односессионный контроллер отладки. Поддерживает только один сеанс отладки на процесс.
+    /// Также поддерживает только один BSL-процесс на приложение. При получении NotifyProcessExited отключает отладчик
+    /// и к нему нельзя подключиться еще раз.
+    /// </summary>
     public class DefaultDebugController : IDebugController
     {
         private readonly ICommunicationServer _server;

src/OneScript.DebugServices/DefaultDebugService.cs

@@ -184,6 +184,12 @@ public virtual void StepOut(int threadId)
             t.Set();
         }
 
+        public void Disconnect()
+        {
+            _breakpointManager.Clear();
+            _threadManager.ReleaseAllThreads();
+        }
+
         public virtual int[] GetThreads()
         {
             return _threadManager.GetAllThreadIds();

src/OneScript.DebugServices/ThreadManager.cs

@@ -80,8 +80,8 @@ public int[] GetAllThreadIds()
         {
             return _machinesOnThreads.Keys.ToArray();
         }
-        
-        public void Dispose()
+
+        public void ReleaseAllThreads()
         {
             var tokens = GetAllTokens();
             foreach (var machineWaitToken in tokens)
@@ -92,5 +92,10 @@ public void Dispose()
 
             _machinesOnThreads.Clear();
         }
+        
+        public void Dispose()
+        {
+            ReleaseAllThreads();
+        }
     }
 }