Replace the Async coordination primitives

Frameworks/MQTTnet.NetStandard/Internal/AsyncAutoResetEvent.cs

@@ -1,26 +1,109 @@
 using System;
+using System.Collections.Generic;
 using System.Threading;
 using System.Threading.Tasks;
 
 namespace MQTTnet.Internal
 {
-    public sealed class AsyncAutoResetEvent : IDisposable
+    // Inspired from Stephen Toub (https://blogs.msdn.microsoft.com/pfxteam/2012/02/11/building-async-coordination-primitives-part-2-asyncautoresetevent/) and Chris Gillum (https://stackoverflow.com/a/43012490)
+    public class AsyncAutoResetEvent
     {
-        private readonly SemaphoreSlim _semaphore = new SemaphoreSlim(0, 1);
+        private readonly LinkedList<TaskCompletionSource<bool>> waiters = new LinkedList<TaskCompletionSource<bool>>();
 
-        public Task WaitOneAsync(CancellationToken cancellationToken)
+        private bool isSignaled;
+
+        public AsyncAutoResetEvent(bool signaled = false)
         {
-            return _semaphore.WaitAsync(cancellationToken);
+            this.isSignaled = signaled;
+        }
+
+        public Task<bool> WaitOneAsync()
+        {
+            return this.WaitOneAsync(CancellationToken.None);
+        }
+
+        public Task<bool> WaitOneAsync(TimeSpan timeout)
+        {
+            return this.WaitOneAsync(timeout, CancellationToken.None);
+        }
+
+        public Task<bool> WaitOneAsync(CancellationToken cancellationToken)
+        {
+            return this.WaitOneAsync(Timeout.InfiniteTimeSpan, cancellationToken);
+        }
+
+        public async Task<bool> WaitOneAsync(TimeSpan timeout, CancellationToken cancellationToken)
+        {
+            cancellationToken.ThrowIfCancellationRequested();
+
+            TaskCompletionSource<bool> tcs;
+
+            lock (this.waiters)
+            {
+                if (this.isSignaled)
+                {
+                    this.isSignaled = false;
+                    return true;
+                }
+                else if (timeout == TimeSpan.Zero)
+                {
+                    return this.isSignaled;
+                }
+                else
+                {
+                    tcs = new TaskCompletionSource<bool>();
+                    this.waiters.AddLast(tcs);
+                }
+            }
+
+            Task winner = await Task.WhenAny(tcs.Task, Task.Delay(timeout, cancellationToken));
+            if (winner == tcs.Task)
+            {
+                // The task was signaled.
+                return true;
+            }
+            else
+            {
+                // We timed-out; remove our reference to the task.
+                // This is an O(n) operation since waiters is a LinkedList<T>.
+                lock (this.waiters)
+                {
+                    bool removed = this.waiters.Remove(tcs);
+                    if (winner.Status == TaskStatus.Canceled)
+                    {
+                        throw new OperationCanceledException(cancellationToken);
+                    }
+                    else
+                    {
+                        throw new TimeoutException();
+                    }
+                }
+            }
         }
 
         public void Set()
         {
-            _semaphore.Release();
-        }
+            TaskCompletionSource<bool> toRelease = null;
 
-        public void Dispose()
-        {
-            _semaphore?.Dispose();
+            lock (this.waiters)
+            {
+                if (this.waiters.Count > 0)
+                {
+                    // Signal the first task in the waiters list.
+                    toRelease = this.waiters.First.Value;
+                    this.waiters.RemoveFirst();
+                }
+                else if (!this.isSignaled)
+                {
+                    // No tasks are pending
+                    this.isSignaled = true;
+                }
+            }
+
+            if (toRelease != null)
+            {
+                toRelease.SetResult(true);
+            }
         }
     }
 }

Frameworks/MQTTnet.NetStandard/Internal/AsyncLock.cs

@@ -4,23 +4,32 @@ using System.Threading.Tasks;
 
 namespace MQTTnet.Internal
 {
-    public sealed class AsyncLock : IDisposable
+    // From Stephen Toub (https://blogs.msdn.microsoft.com/pfxteam/2012/02/12/building-async-coordination-primitives-part-6-asynclock/)
+    public sealed class AsyncLock
     {
-        private readonly SemaphoreSlim _semaphore = new SemaphoreSlim(1, 1);
+        private readonly SemaphoreSlim m_semaphore = new SemaphoreSlim(1, 1);
+        private readonly Task<IDisposable> m_releaser;
 
-        public Task EnterAsync(CancellationToken cancellationToken)
+        public AsyncLock()
         {
-            return _semaphore.WaitAsync(cancellationToken);
+            m_releaser = Task.FromResult((IDisposable)new Releaser(this));
         }
 
-        public void Exit()
+        public Task<IDisposable> LockAsync(CancellationToken cancellationToken)
         {
-            _semaphore.Release();
+            var wait = m_semaphore.WaitAsync(cancellationToken);
+            return wait.IsCompleted ?
+                        m_releaser :
+                        wait.ContinueWith((_, state) => (IDisposable)state,
+                            m_releaser.Result, cancellationToken,
+                            TaskContinuationOptions.ExecuteSynchronously, TaskScheduler.Default);
         }
 
-        public void Dispose()
+        private sealed class Releaser : IDisposable
         {
-            _semaphore?.Dispose();
+            private readonly AsyncLock m_toRelease;
+            internal Releaser(AsyncLock toRelease) { m_toRelease = toRelease; }
+            public void Dispose() { m_toRelease.m_semaphore.Release(); }
         }
     }
 }

Frameworks/MQTTnet.NetStandard/Server/MqttClientPendingMessagesQueue.cs

@@ -154,7 +154,6 @@ namespace MQTTnet.Server
 
         public void Dispose()
         {
-            _queueAutoResetEvent?.Dispose();
         }
     }
 }

Frameworks/MQTTnet.NetStandard/Server/MqttClientSessionsManager.cs

@@ -119,8 +119,7 @@ namespace MQTTnet.Server
 
         public async Task StopAsync()
         {
-            await _sessionsLock.EnterAsync(CancellationToken.None).ConfigureAwait(false);
-            try
+            using (var releaser = await _sessionsLock.LockAsync(CancellationToken.None).ConfigureAwait(false))
             {
                 foreach (var session in _sessions)
                 {
@@ -129,16 +128,11 @@ namespace MQTTnet.Server
 
                 _sessions.Clear();
             }
-            finally
-            {
-                _sessionsLock.Exit();
-            }
         }
 
         public async Task<IList<ConnectedMqttClient>> GetConnectedClientsAsync()
         {
-            await _sessionsLock.EnterAsync(CancellationToken.None).ConfigureAwait(false);
-            try
+            using (var releaser = await _sessionsLock.LockAsync(CancellationToken.None).ConfigureAwait(false))
             {
                 return _sessions.Where(s => s.Value.IsConnected).Select(s => new ConnectedMqttClient
                 {
@@ -149,10 +143,6 @@ namespace MQTTnet.Server
                     PendingApplicationMessages = s.Value.PendingMessagesQueue.Count
                 }).ToList();
             }
-            finally
-            {
-                _sessionsLock.Exit();
-            }
         }
 
         public void StartDispatchApplicationMessage(MqttClientSession senderClientSession, MqttApplicationMessage applicationMessage)
@@ -165,8 +155,7 @@ namespace MQTTnet.Server
             if (clientId == null) throw new ArgumentNullException(nameof(clientId));
             if (topicFilters == null) throw new ArgumentNullException(nameof(topicFilters));
 
-            await _sessionsLock.EnterAsync(CancellationToken.None).ConfigureAwait(false);
-            try
+            using (var releaser = await _sessionsLock.LockAsync(CancellationToken.None).ConfigureAwait(false))
             {
                 if (!_sessions.TryGetValue(clientId, out var session))
                 {
@@ -175,10 +164,6 @@ namespace MQTTnet.Server
 
                 await session.SubscribeAsync(topicFilters).ConfigureAwait(false);
             }
-            finally
-            {
-                _sessionsLock.Exit();
-            }
         }
 
         public async Task UnsubscribeAsync(string clientId, IList<string> topicFilters)
@@ -186,8 +171,7 @@ namespace MQTTnet.Server
             if (clientId == null) throw new ArgumentNullException(nameof(clientId));
             if (topicFilters == null) throw new ArgumentNullException(nameof(topicFilters));
 
-            await _sessionsLock.EnterAsync(CancellationToken.None).ConfigureAwait(false);
-            try
+            using (var releaser = await _sessionsLock.LockAsync(CancellationToken.None).ConfigureAwait(false))
             {
                 if (!_sessions.TryGetValue(clientId, out var session))
                 {
@@ -196,15 +180,10 @@ namespace MQTTnet.Server
 
                 await session.UnsubscribeAsync(topicFilters).ConfigureAwait(false);
             }
-            finally
-            {
-                _sessionsLock.Exit();
-            }
         }
 
         public void Dispose()
         {
-            _sessionsLock?.Dispose();
         }
 
         private MqttConnectReturnCode ValidateConnection(MqttConnectPacket connectPacket)
@@ -226,8 +205,8 @@ namespace MQTTnet.Server
 
         private async Task<GetOrCreateClientSessionResult> PrepareClientSessionAsync(MqttConnectPacket connectPacket)
         {
-            await _sessionsLock.EnterAsync(CancellationToken.None).ConfigureAwait(false);
-            try
+            using (var releaser = await _sessionsLock.LockAsync(CancellationToken.None).ConfigureAwait(false))
+
             {
                 var isSessionPresent = _sessions.TryGetValue(connectPacket.ClientId, out var clientSession);
                 if (isSessionPresent)
@@ -261,10 +240,6 @@ namespace MQTTnet.Server
 
                 return new GetOrCreateClientSessionResult { IsExistingSession = isExistingSession, Session = clientSession };
             }
-            finally
-            {
-                _sessionsLock.Exit();
-            }
         }
 
         private async Task DispatchApplicationMessageAsync(MqttClientSession senderClientSession, MqttApplicationMessage applicationMessage)
@@ -294,18 +269,13 @@ namespace MQTTnet.Server
                 _logger.Error(exception, "Error while processing application message");
             }
 
-            await _sessionsLock.EnterAsync(CancellationToken.None).ConfigureAwait(false);
-            try
+            using (var releaser = await _sessionsLock.LockAsync(CancellationToken.None).ConfigureAwait(false))
             {
                 foreach (var clientSession in _sessions.Values)
                 {
                     await clientSession.EnqueueApplicationMessageAsync(applicationMessage).ConfigureAwait(false);
                 }
             }
-            finally
-            {
-                _sessionsLock.Exit();
-            }
         }
 
         private MqttApplicationMessageInterceptorContext InterceptApplicationMessage(MqttClientSession senderClientSession, MqttApplicationMessage applicationMessage)

Frameworks/MQTTnet.NetStandard/Server/MqttRetainedMessagesManager.cs

@@ -29,24 +29,22 @@ namespace MQTTnet.Server
                 return;
             }
 
-            await _messagesLock.EnterAsync(CancellationToken.None).ConfigureAwait(false);
-            try
+            using (var releaser = await _messagesLock.LockAsync(CancellationToken.None).ConfigureAwait(false))
             {
-                var retainedMessages = await _options.Storage.LoadRetainedMessagesAsync().ConfigureAwait(false);
-
-                _messages.Clear();
-                foreach (var retainedMessage in retainedMessages)
+                try
                 {
-                    _messages[retainedMessage.Topic] = retainedMessage;
+                    var retainedMessages = await _options.Storage.LoadRetainedMessagesAsync().ConfigureAwait(false);
+
+                    _messages.Clear();
+                    foreach (var retainedMessage in retainedMessages)
+                    {
+                        _messages[retainedMessage.Topic] = retainedMessage;
+                    }
+                }
+                catch (Exception exception)
+                {
+                    _logger.Error(exception, "Unhandled exception while loading retained messages.");
                 }
-            }
-            catch (Exception exception)
-            {
-                _logger.Error(exception, "Unhandled exception while loading retained messages.");
-            }
-            finally
-            {
-                _messagesLock.Exit();
             }
         }
 
@@ -54,18 +52,16 @@ namespace MQTTnet.Server
         {
             if (applicationMessage == null) throw new ArgumentNullException(nameof(applicationMessage));
 
-            await _messagesLock.EnterAsync(CancellationToken.None).ConfigureAwait(false);
-            try
+            using (var releaser = await _messagesLock.LockAsync(CancellationToken.None).ConfigureAwait(false))
             {
-                await HandleMessageInternalAsync(clientId, applicationMessage);
-            }
-            catch (Exception exception)
-            {
-                _logger.Error(exception, "Unhandled exception while handling retained messages.");
-            }
-            finally
-            {
-                _messagesLock.Exit();
+                try
+                {
+                    await HandleMessageInternalAsync(clientId, applicationMessage);
+                }
+                catch (Exception exception)
+                {
+                    _logger.Error(exception, "Unhandled exception while handling retained messages.");
+                }
             }
         }
 
@@ -73,8 +69,7 @@ namespace MQTTnet.Server
         {
             var retainedMessages = new List<MqttApplicationMessage>();
 
-            await _messagesLock.EnterAsync(CancellationToken.None).ConfigureAwait(false);
-            try
+            using (var releaser = await _messagesLock.LockAsync(CancellationToken.None).ConfigureAwait(false))
             {
                 foreach (var retainedMessage in _messages.Values)
                 {
@@ -90,17 +85,12 @@ namespace MQTTnet.Server
                     }
                 }
             }
-            finally
-            {
-                _messagesLock.Exit();
-            }
 
             return retainedMessages;
         }
 
         public void Dispose()
         {
-            _messagesLock?.Dispose();
         }
 
         private async Task HandleMessageInternalAsync(string clientId, MqttApplicationMessage applicationMessage)