#371 Improve reference management.

doc/namespaces/RapidField.SolidInstruments.Core.Concurrency.md

@@ -54,7 +54,7 @@ public class ExampleClass : IDisposable
 
     public void Dispose()
     {
-        Control.Dispose();
+        Control?.Dispose();
     }
 
     public void ExecuteActions(Action[] actions)

example/RapidField.SolidInstruments.Example.BeaconService/ApplicationServiceExecutor.cs

@@ -25,7 +25,7 @@ public ApplicationServiceExecutor()
         /// Releases all resources consumed by the current <see cref="ApplicationServiceExecutor" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
 

example/RapidField.SolidInstruments.Example.Domain.AccessControl.HttpApi/ApplicationDependencyModule.cs

@@ -38,6 +38,8 @@ public ApplicationDependencyModule(IConfiguration applicationConfiguration)
         /// <param name="applicationConfiguration">
         /// Configuration information for the application.
         /// </param>
-        protected override void Configure(ServiceCollection configurator, IConfiguration applicationConfiguration) => _ = configurator.AddControllers();
+        protected override void Configure(ServiceCollection configurator, IConfiguration applicationConfiguration) => _ = configurator
+            .AddOptions()
+            .AddControllers();
     }
 }

example/RapidField.SolidInstruments.Example.Domain.AccessControl.HttpApi/ApplicationWebExecutor.cs

@@ -48,7 +48,6 @@ protected override void ConfigureApplication(IApplicationBuilder application, IC
             try
             {
                 application = application
-                    .UseAuthorization()
                     .UseRouting()
                     .UseEndpoints(endpoints =>
                     {
@@ -79,7 +78,7 @@ protected override void ConfigureApplication(IApplicationBuilder application, IC
         /// Releases all resources consumed by the current <see cref="ApplicationWebExecutor" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
 

example/RapidField.SolidInstruments.Example.Domain.AccessControl.Service/ApplicationServiceExecutor.cs

@@ -68,7 +68,7 @@ protected override void AddListeners(IMessageListeningProfile listeningProfile,
         /// Releases all resources consumed by the current <see cref="ApplicationServiceExecutor" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
 

example/RapidField.SolidInstruments.Example.Domain.AccessControl/CommandHandlers/ModelState/User/CreateDomainModelCommandHandler.cs

@@ -35,7 +35,7 @@ public CreateDomainModelCommandHandler(ICommandMediator mediator)
         /// Releases all resources consumed by the current <see cref="CreateDomainModelCommandHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
     }

example/RapidField.SolidInstruments.Example.Domain.AccessControl/CommandHandlers/ModelState/User/DeleteDomainModelCommandHandler.cs

@@ -35,7 +35,7 @@ public DeleteDomainModelCommandHandler(ICommandMediator mediator)
         /// Releases all resources consumed by the current <see cref="DeleteDomainModelCommandHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
     }

example/RapidField.SolidInstruments.Example.Domain.AccessControl/CommandHandlers/ModelState/User/FindDomainModelByIdentifierCommandHandler.cs

@@ -35,7 +35,7 @@ public FindDomainModelByIdentifierCommandHandler(ICommandMediator mediator)
         /// Releases all resources consumed by the current <see cref="FindDomainModelByIdentifierCommandHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
     }

example/RapidField.SolidInstruments.Example.Domain.AccessControl/CommandHandlers/ModelState/User/UpdateDomainModelCommandHandler.cs

@@ -35,7 +35,7 @@ public UpdateDomainModelCommandHandler(ICommandMediator mediator)
         /// Releases all resources consumed by the current <see cref="UpdateDomainModelCommandHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
     }

example/RapidField.SolidInstruments.Example.Domain.AccessControl/CommandHandlers/ModelState/UserRole/CreateDomainModelCommandHandler.cs

@@ -35,7 +35,7 @@ public CreateDomainModelCommandHandler(ICommandMediator mediator)
         /// Releases all resources consumed by the current <see cref="CreateDomainModelCommandHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
     }

example/RapidField.SolidInstruments.Example.Domain.AccessControl/CommandHandlers/ModelState/UserRole/DeleteDomainModelCommandHandler.cs

@@ -35,7 +35,7 @@ public DeleteDomainModelCommandHandler(ICommandMediator mediator)
         /// Releases all resources consumed by the current <see cref="DeleteDomainModelCommandHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
     }

example/RapidField.SolidInstruments.Example.Domain.AccessControl/CommandHandlers/ModelState/UserRole/FindDomainModelByIdentifierCommandHandler.cs

@@ -35,7 +35,7 @@ public FindDomainModelByIdentifierCommandHandler(ICommandMediator mediator)
         /// Releases all resources consumed by the current <see cref="FindDomainModelByIdentifierCommandHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
     }

example/RapidField.SolidInstruments.Example.Domain.AccessControl/CommandHandlers/ModelState/UserRole/UpdateDomainModelCommandHandler.cs

@@ -35,7 +35,7 @@ public UpdateDomainModelCommandHandler(ICommandMediator mediator)
         /// Releases all resources consumed by the current <see cref="UpdateDomainModelCommandHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
     }

example/RapidField.SolidInstruments.Example.Domain.AccessControl/CommandHandlers/ModelState/UserRoleAssignment/CreateDomainModelCommandHandler.cs

@@ -35,7 +35,7 @@ public CreateDomainModelCommandHandler(ICommandMediator mediator)
         /// Releases all resources consumed by the current <see cref="CreateDomainModelCommandHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
     }

example/RapidField.SolidInstruments.Example.Domain.AccessControl/CommandHandlers/ModelState/UserRoleAssignment/DeleteDomainModelCommandHandler.cs

@@ -35,7 +35,7 @@ public DeleteDomainModelCommandHandler(ICommandMediator mediator)
         /// Releases all resources consumed by the current <see cref="DeleteDomainModelCommandHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
     }

example/RapidField.SolidInstruments.Example.Domain.AccessControl/CommandHandlers/ModelState/UserRoleAssignment/FindDomainModelByIdentifierCommandHandler.cs

@@ -35,7 +35,7 @@ public FindDomainModelByIdentifierCommandHandler(ICommandMediator mediator)
         /// Releases all resources consumed by the current <see cref="FindDomainModelByIdentifierCommandHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
     }

example/RapidField.SolidInstruments.Example.Domain.AccessControl/CommandHandlers/ModelState/UserRoleAssignment/UpdateDomainModelCommandHandler.cs

@@ -35,7 +35,7 @@ public UpdateDomainModelCommandHandler(ICommandMediator mediator)
         /// Releases all resources consumed by the current <see cref="UpdateDomainModelCommandHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
     }

example/RapidField.SolidInstruments.Example.Domain.AccessControl/DatabaseContextRepositoryFactory.cs

@@ -54,7 +54,7 @@ protected override void Configure(ObjectFactoryConfiguration<IDataAccessReposito
         /// Releases all resources consumed by the current <see cref="DatabaseContextRepositoryFactory" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
     }

example/RapidField.SolidInstruments.Example.Domain.AccessControl/EventHandlers/ModelState/User/DomainModelCreatedEventHandler.cs

@@ -37,7 +37,7 @@ public DomainModelCreatedEventHandler(ICommandMediator mediator)
         /// Releases all resources consumed by the current <see cref="DomainModelCreatedEventHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
 

example/RapidField.SolidInstruments.Example.Domain.AccessControl/EventHandlers/ModelState/User/DomainModelDeletedEventHandler.cs

@@ -37,7 +37,7 @@ public DomainModelDeletedEventHandler(ICommandMediator mediator)
         /// Releases all resources consumed by the current <see cref="DomainModelDeletedEventHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
 

example/RapidField.SolidInstruments.Example.Domain.AccessControl/EventHandlers/ModelState/User/DomainModelUpdatedEventHandler.cs

@@ -37,7 +37,7 @@ public DomainModelUpdatedEventHandler(ICommandMediator mediator)
         /// Releases all resources consumed by the current <see cref="DomainModelUpdatedEventHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
 

example/RapidField.SolidInstruments.Example.Domain.AccessControl/EventHandlers/ModelState/UserRole/DomainModelCreatedEventHandler.cs

@@ -37,7 +37,7 @@ public DomainModelCreatedEventHandler(ICommandMediator mediator)
         /// Releases all resources consumed by the current <see cref="DomainModelCreatedEventHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
 

example/RapidField.SolidInstruments.Example.Domain.AccessControl/EventHandlers/ModelState/UserRole/DomainModelDeletedEventHandler.cs

@@ -37,7 +37,7 @@ public DomainModelDeletedEventHandler(ICommandMediator mediator)
         /// Releases all resources consumed by the current <see cref="DomainModelDeletedEventHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
 

example/RapidField.SolidInstruments.Example.Domain.AccessControl/EventHandlers/ModelState/UserRole/DomainModelUpdatedEventHandler.cs

@@ -37,7 +37,7 @@ public DomainModelUpdatedEventHandler(ICommandMediator mediator)
         /// Releases all resources consumed by the current <see cref="DomainModelUpdatedEventHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
 

example/RapidField.SolidInstruments.Example.Domain.AccessControl/EventHandlers/ModelState/UserRoleAssignment/DomainModelCreatedEventHandler.cs

@@ -37,7 +37,7 @@ public DomainModelCreatedEventHandler(ICommandMediator mediator)
         /// Releases all resources consumed by the current <see cref="DomainModelCreatedEventHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
 

example/RapidField.SolidInstruments.Example.Domain.AccessControl/EventHandlers/ModelState/UserRoleAssignment/DomainModelDeletedEventHandler.cs

@@ -37,7 +37,7 @@ public DomainModelDeletedEventHandler(ICommandMediator mediator)
         /// Releases all resources consumed by the current <see cref="DomainModelDeletedEventHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
 

example/RapidField.SolidInstruments.Example.Domain.AccessControl/EventHandlers/ModelState/UserRoleAssignment/DomainModelUpdatedEventHandler.cs

@@ -37,7 +37,7 @@ public DomainModelUpdatedEventHandler(ICommandMediator mediator)
         /// Releases all resources consumed by the current <see cref="DomainModelUpdatedEventHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
 

example/RapidField.SolidInstruments.Example.Domain.Identity.Service/ApplicationServiceExecutor.cs

@@ -68,7 +68,7 @@ protected override void AddListeners(IMessageListeningProfile listeningProfile,
         /// Releases all resources consumed by the current <see cref="ApplicationServiceExecutor" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
 

example/RapidField.SolidInstruments.Example.Domain.Identity/EventHandlers/ModelState/User/DomainModelCreatedEventHandler.cs

@@ -43,7 +43,7 @@ public DomainModelCreatedEventHandler(ICommandMediator mediator, DatabaseContext
         /// Releases all resources consumed by the current <see cref="DomainModelCreatedEventHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
 

example/RapidField.SolidInstruments.Example.Domain.Identity/EventHandlers/ModelState/User/DomainModelDeletedEventHandler.cs

@@ -42,7 +42,7 @@ public DomainModelDeletedEventHandler(ICommandMediator mediator, DatabaseContext
         /// Releases all resources consumed by the current <see cref="DomainModelDeletedEventHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
 

example/RapidField.SolidInstruments.Example.Domain.Identity/EventHandlers/ModelState/User/DomainModelUpdatedEventHandler.cs

@@ -43,7 +43,7 @@ public DomainModelUpdatedEventHandler(ICommandMediator mediator, DatabaseContext
         /// Releases all resources consumed by the current <see cref="DomainModelUpdatedEventHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
 

example/RapidField.SolidInstruments.Example.Domain.Identity/EventHandlers/ModelState/UserRole/DomainModelCreatedEventHandler.cs

@@ -43,7 +43,7 @@ public DomainModelCreatedEventHandler(ICommandMediator mediator, DatabaseContext
         /// Releases all resources consumed by the current <see cref="DomainModelCreatedEventHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
 

example/RapidField.SolidInstruments.Example.Domain.Identity/EventHandlers/ModelState/UserRole/DomainModelDeletedEventHandler.cs

@@ -42,7 +42,7 @@ public DomainModelDeletedEventHandler(ICommandMediator mediator, DatabaseContext
         /// Releases all resources consumed by the current <see cref="DomainModelDeletedEventHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
 

example/RapidField.SolidInstruments.Example.Domain.Identity/EventHandlers/ModelState/UserRole/DomainModelUpdatedEventHandler.cs

@@ -43,7 +43,7 @@ public DomainModelUpdatedEventHandler(ICommandMediator mediator, DatabaseContext
         /// Releases all resources consumed by the current <see cref="DomainModelUpdatedEventHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
 

example/RapidField.SolidInstruments.Example.Domain.Identity/EventHandlers/ModelState/UserRoleAssignment/DomainModelCreatedEventHandler.cs

@@ -43,7 +43,7 @@ public DomainModelCreatedEventHandler(ICommandMediator mediator, DatabaseContext
         /// Releases all resources consumed by the current <see cref="DomainModelCreatedEventHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
 

example/RapidField.SolidInstruments.Example.Domain.Identity/EventHandlers/ModelState/UserRoleAssignment/DomainModelDeletedEventHandler.cs

@@ -42,7 +42,7 @@ public DomainModelDeletedEventHandler(ICommandMediator mediator, DatabaseContext
         /// Releases all resources consumed by the current <see cref="DomainModelDeletedEventHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);
 

example/RapidField.SolidInstruments.Example.Domain.Identity/EventHandlers/ModelState/UserRoleAssignment/DomainModelUpdatedEventHandler.cs

@@ -43,7 +43,7 @@ public DomainModelUpdatedEventHandler(ICommandMediator mediator, DatabaseContext
         /// Releases all resources consumed by the current <see cref="DomainModelUpdatedEventHandler" />.
         /// </summary>
         /// <param name="disposing">
-        /// A value indicating whether or not managed resources should be released.
+        /// A value indicating whether or not disposal was invoked by user code.
         /// </param>
         protected override void Dispose(Boolean disposing) => base.Dispose(disposing);