aboutsummaryrefslogtreecommitdiff
path: root/lib/Plugins.Essentials.ServiceStack/src/HttpServiceStack.cs
blob: 2f1bb0baa1965618938854ea313c93c5c8b5eede (plain)
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
126
127
128
129
130
131
132
133
134
135
136
/*
* Copyright (c) 2024 Vaughn Nugent
* 
* Library: VNLib
* Package: VNLib.Plugins.Essentials.ServiceStack
* File: HttpServiceStack.cs 
*
* HttpServiceStack.cs is part of VNLib.Plugins.Essentials.ServiceStack which is part of the larger 
* VNLib collection of libraries and utilities.
*
* VNLib.Plugins.Essentials.ServiceStack is free software: you can redistribute it and/or modify 
* it under the terms of the GNU Affero General Public License as 
* published by the Free Software Foundation, either version 2 of the
* License, or (at your option) any later version.
*
* VNLib.Plugins.Essentials.ServiceStack is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program.  If not, see https://www.gnu.org/licenses/.
*/

using System.Linq;
using System.Threading;
using System.Threading.Tasks;
using System.Collections.Generic;

using VNLib.Utils;
using VNLib.Net.Http;
using VNLib.Utils.Logging;
using VNLib.Plugins.Essentials.ServiceStack.Plugins;

namespace VNLib.Plugins.Essentials.ServiceStack
{
    /// <summary>
    /// An HTTP servicing stack that manages a collection of HTTP servers
    /// their service domain
    /// </summary>
    public sealed class HttpServiceStack : VnDisposeable
    {
        private readonly IReadOnlyCollection<IHttpServer> _servers;
        private readonly ServiceDomain _serviceDomain;
        private readonly PluginManager _plugins;

        private CancellationTokenSource? _cts;
        private Task WaitForAllTask;

        /// <summary>
        /// A collection of all loaded servers
        /// </summary>
        public IEnumerable<IHttpServer> Servers => _servers;

        /// <summary>
        /// Gets the internal <see cref="IHttpPluginManager"/> that manages plugins for the entire
        /// <see cref="HttpServiceStack"/>
        /// </summary>
        public IHttpPluginManager PluginManager => _plugins;        

        /// <summary>
        /// Initializes a new <see cref="HttpServiceStack"/> that will 
        /// generate servers to listen for services exposed by the 
        /// specified host context
        /// </summary>
        internal HttpServiceStack(IReadOnlyCollection<IHttpServer> servers, ServiceDomain serviceDomain, IPluginInitializer plugins)
        {
            _servers = servers;
            _serviceDomain = serviceDomain;
            _plugins = new(plugins);
            WaitForAllTask = Task.CompletedTask;
        }

        /// <summary>
        /// Starts all configured servers that observe a cancellation
        /// token to cancel
        /// </summary>
        /// <param name="parentToken">The token to observe which may stop servers and cleanup the provider</param>
        public void StartServers(CancellationToken parentToken = default)
        {
            Check();

            //Init new linked cts to stop all servers if cancelled
            _cts = CancellationTokenSource.CreateLinkedTokenSource(parentToken);

            //Start all servers
            Task[] runners = _servers.Select(s => s.Start(_cts.Token)).ToArray();

            //Check for failed startups
            Task? firstFault = runners.Where(static t => t.IsFaulted).FirstOrDefault();
           
            //Raise first exception
            firstFault?.GetAwaiter().GetResult();

            //Task that waits for all to exit then cleans up
            WaitForAllTask = Task.WhenAll(runners)
                .ContinueWith(OnAllServerExit, CancellationToken.None, TaskContinuationOptions.RunContinuationsAsynchronously, TaskScheduler.Default);
        }

        /// <summary>
        /// Loads all plugins into the service stack
        /// </summary>
        /// <param name="logProvider">A log provider for writing loading logs to</param>
        public void LoadPlugins(ILogProvider logProvider) => _plugins.LoadPlugins(logProvider);

        /// <summary>
        /// Stops listening on all configured servers and returns a task that completes 
        /// when the service host has stopped all servers and unloaded resources
        /// </summary>
        /// <returns>The task that completes when</returns>
        public Task StopAndWaitAsync()
        {
            Check();

            _cts?.Cancel();
            return WaitForAllTask;
        }

        private void OnAllServerExit(Task allExit)
        {
            //Unload plugins
            _plugins.UnloadPlugins();

            //Unload the hosts
            _serviceDomain.TearDown();
        }

        ///<inheritdoc/>
        protected override void Free()
        {
            _cts?.Dispose();

            _plugins.Dispose();
        }
    }
}