| | | 1 | | // Copyright (c) ZeroC, Inc. |
| | | 2 | | |
| | | 3 | | using IceRpc.Internal; |
| | | 4 | | using IceRpc.Transports; |
| | | 5 | | using IceRpc.Transports.Internal; |
| | | 6 | | using Microsoft.Extensions.Logging; |
| | | 7 | | using Microsoft.Extensions.Logging.Abstractions; |
| | | 8 | | using System.Diagnostics; |
| | | 9 | | using System.Net; |
| | | 10 | | using System.Net.Security; |
| | | 11 | | using System.Security.Authentication; |
| | | 12 | | |
| | | 13 | | namespace IceRpc; |
| | | 14 | | |
| | | 15 | | /// <summary>A server accepts connections from clients and dispatches the requests it receives over these connections. |
| | | 16 | | /// </summary> |
| | | 17 | | public sealed class Server : IAsyncDisposable |
| | | 18 | | { |
| | 94 | 19 | | private readonly LinkedList<IProtocolConnection> _connections = new(); |
| | | 20 | | |
| | | 21 | | private readonly TimeSpan _connectTimeout; |
| | | 22 | | |
| | | 23 | | // A detached connection is a protocol connection that we've decided to connect, or that is connecting, shutting |
| | | 24 | | // down or being disposed. It counts towards _maxConnections and both Server.ShutdownAsync and DisposeAsync wait for |
| | | 25 | | // detached connections to reach 0 using _detachedConnectionsTcs. Such a connection is "detached" because it's not |
| | | 26 | | // in _connections. |
| | | 27 | | private int _detachedConnectionCount; |
| | | 28 | | |
| | 94 | 29 | | private readonly TaskCompletionSource _detachedConnectionsTcs = |
| | 94 | 30 | | new(TaskCreationOptions.RunContinuationsAsynchronously); |
| | | 31 | | |
| | | 32 | | // A cancellation token source that is canceled by DisposeAsync. |
| | 94 | 33 | | private readonly CancellationTokenSource _disposedCts = new(); |
| | | 34 | | |
| | | 35 | | private Task? _disposeTask; |
| | | 36 | | |
| | | 37 | | private readonly Func<IConnectorListener> _listenerFactory; |
| | | 38 | | |
| | | 39 | | private Task? _listenTask; |
| | | 40 | | |
| | | 41 | | private readonly int _maxConnections; |
| | | 42 | | |
| | | 43 | | private readonly int _maxPendingConnections; |
| | | 44 | | |
| | 94 | 45 | | private readonly Lock _mutex = new(); |
| | | 46 | | |
| | | 47 | | private readonly ServerAddress _serverAddress; |
| | | 48 | | |
| | | 49 | | // A cancellation token source canceled by ShutdownAsync and DisposeAsync. |
| | | 50 | | private readonly CancellationTokenSource _shutdownCts; |
| | | 51 | | |
| | | 52 | | private Task? _shutdownTask; |
| | | 53 | | |
| | | 54 | | private readonly TimeSpan _shutdownTimeout; |
| | | 55 | | |
| | | 56 | | /// <summary>Constructs a server.</summary> |
| | | 57 | | /// <param name="options">The server options.</param> |
| | | 58 | | /// <param name="duplexServerTransport">The transport used to create ice protocol connections. The <see |
| | | 59 | | /// langword="null" /> value is equivalent to <see cref="IDuplexServerTransport.Default" />.</param> |
| | | 60 | | /// <param name="multiplexedServerTransport">The transport used to create icerpc protocol connections. The <see |
| | | 61 | | /// langword="null" /> value is equivalent to <see cref="IMultiplexedServerTransport.Default" />.</param> |
| | | 62 | | /// <param name="logger">The logger. <see langword="null" /> is equivalent to <see cref="NullLogger.Instance" |
| | | 63 | | /// />.</param> |
| | 94 | 64 | | public Server( |
| | 94 | 65 | | ServerOptions options, |
| | 94 | 66 | | IDuplexServerTransport? duplexServerTransport = null, |
| | 94 | 67 | | IMultiplexedServerTransport? multiplexedServerTransport = null, |
| | 94 | 68 | | ILogger? logger = null) |
| | 94 | 69 | | { |
| | 94 | 70 | | if (options.ConnectionOptions.Dispatcher is null) |
| | 0 | 71 | | { |
| | 0 | 72 | | throw new ArgumentException($"{nameof(ServerOptions.ConnectionOptions.Dispatcher)} cannot be null"); |
| | | 73 | | } |
| | | 74 | | |
| | 94 | 75 | | logger ??= NullLogger.Instance; |
| | | 76 | | |
| | 94 | 77 | | _shutdownCts = CancellationTokenSource.CreateLinkedTokenSource(_disposedCts.Token); |
| | | 78 | | |
| | 94 | 79 | | duplexServerTransport ??= IDuplexServerTransport.Default; |
| | 94 | 80 | | multiplexedServerTransport ??= IMultiplexedServerTransport.Default; |
| | 94 | 81 | | _maxConnections = options.MaxConnections; |
| | 94 | 82 | | _maxPendingConnections = options.MaxPendingConnections; |
| | | 83 | | |
| | 94 | 84 | | _connectTimeout = options.ConnectTimeout; |
| | 94 | 85 | | _shutdownTimeout = options.ShutdownTimeout; |
| | | 86 | | |
| | 94 | 87 | | _serverAddress = options.ServerAddress; |
| | 94 | 88 | | if (_serverAddress.Transport is null) |
| | 83 | 89 | | { |
| | 83 | 90 | | _serverAddress = _serverAddress with |
| | 83 | 91 | | { |
| | 83 | 92 | | Transport = _serverAddress.Protocol == Protocol.Ice ? |
| | 83 | 93 | | duplexServerTransport.DefaultName : multiplexedServerTransport.DefaultName |
| | 83 | 94 | | }; |
| | 83 | 95 | | } |
| | | 96 | | |
| | 94 | 97 | | if (options.ServerAuthenticationOptions?.ApplicationProtocols is not null) |
| | 0 | 98 | | { |
| | 0 | 99 | | throw new ArgumentException( |
| | 0 | 100 | | "The ApplicationProtocols property of the SSL server authentication options must be null. The ALPN is se |
| | 0 | 101 | | nameof(options)); |
| | | 102 | | } |
| | | 103 | | |
| | 94 | 104 | | var transportAddress = new TransportAddress |
| | 94 | 105 | | { |
| | 94 | 106 | | Host = _serverAddress.Host, |
| | 94 | 107 | | Port = _serverAddress.Port, |
| | 94 | 108 | | TransportName = _serverAddress.Transport, |
| | 94 | 109 | | Params = _serverAddress.Params |
| | 94 | 110 | | }; |
| | | 111 | | |
| | 94 | 112 | | _listenerFactory = () => |
| | 93 | 113 | | { |
| | 94 | 114 | | IConnectorListener listener; |
| | 94 | 115 | | |
| | 93 | 116 | | SslServerAuthenticationOptions? serverAuthenticationOptions = options.ServerAuthenticationOptions; |
| | 93 | 117 | | if (serverAuthenticationOptions is not null) |
| | 5 | 118 | | { |
| | 5 | 119 | | serverAuthenticationOptions = serverAuthenticationOptions.ShallowClone(); |
| | 5 | 120 | | serverAuthenticationOptions.ApplicationProtocols = [_serverAddress.Protocol.AlpnProtocol]; |
| | 5 | 121 | | } |
| | 94 | 122 | | |
| | 93 | 123 | | if (_serverAddress.Protocol == Protocol.Ice) |
| | 25 | 124 | | { |
| | 25 | 125 | | IListener<IDuplexConnection> transportListener = duplexServerTransport.Listen( |
| | 25 | 126 | | transportAddress, |
| | 25 | 127 | | new DuplexConnectionOptions |
| | 25 | 128 | | { |
| | 25 | 129 | | MinSegmentSize = options.ConnectionOptions.MinSegmentSize, |
| | 25 | 130 | | Pool = options.ConnectionOptions.Pool, |
| | 25 | 131 | | }, |
| | 25 | 132 | | serverAuthenticationOptions); |
| | 94 | 133 | | |
| | 25 | 134 | | listener = new IceConnectorListener(transportListener, _serverAddress, options.ConnectionOptions); |
| | 25 | 135 | | } |
| | 94 | 136 | | else |
| | 68 | 137 | | { |
| | 68 | 138 | | IListener<IMultiplexedConnection> transportListener = multiplexedServerTransport.Listen( |
| | 68 | 139 | | transportAddress, |
| | 68 | 140 | | new MultiplexedConnectionOptions |
| | 68 | 141 | | { |
| | 68 | 142 | | HandshakeTimeout = options.ConnectTimeout, |
| | 68 | 143 | | MaxBidirectionalStreams = options.ConnectionOptions.MaxIceRpcBidirectionalStreams, |
| | 68 | 144 | | // Add an additional stream for the icerpc protocol control stream. |
| | 68 | 145 | | MaxUnidirectionalStreams = options.ConnectionOptions.MaxIceRpcUnidirectionalStreams + 1, |
| | 68 | 146 | | MinSegmentSize = options.ConnectionOptions.MinSegmentSize, |
| | 68 | 147 | | Pool = options.ConnectionOptions.Pool |
| | 68 | 148 | | }, |
| | 68 | 149 | | serverAuthenticationOptions); |
| | 94 | 150 | | |
| | 68 | 151 | | listener = new IceRpcConnectorListener( |
| | 68 | 152 | | transportListener, |
| | 68 | 153 | | _serverAddress, |
| | 68 | 154 | | options.ConnectionOptions, |
| | 68 | 155 | | logger == NullLogger.Instance ? null : new LogTaskExceptionObserver(logger)); |
| | 68 | 156 | | } |
| | 94 | 157 | | |
| | 93 | 158 | | listener = new MetricsConnectorListenerDecorator(listener); |
| | 93 | 159 | | if (logger != NullLogger.Instance) |
| | 10 | 160 | | { |
| | 10 | 161 | | listener = new LogConnectorListenerDecorator(listener, logger); |
| | 10 | 162 | | } |
| | 93 | 163 | | return listener; |
| | 187 | 164 | | }; |
| | 94 | 165 | | } |
| | | 166 | | |
| | | 167 | | /// <summary>Constructs a server with the specified dispatcher and authentication options. All other properties |
| | | 168 | | /// use the <see cref="ServerOptions" /> defaults.</summary> |
| | | 169 | | /// <param name="dispatcher">The dispatcher of the server.</param> |
| | | 170 | | /// <param name="serverAuthenticationOptions">The SSL server authentication options. When not <see langword="null" |
| | | 171 | | /// />, the server will accept only secure connections.</param> |
| | | 172 | | /// <param name="duplexServerTransport">The transport used to create ice protocol connections. <see langword="null" |
| | | 173 | | /// /> is equivalent to <see cref="IDuplexServerTransport.Default" />.</param> |
| | | 174 | | /// <param name="multiplexedServerTransport">The transport used to create icerpc protocol connections. <see |
| | | 175 | | /// langword="null" /> is equivalent to <see cref="IMultiplexedServerTransport.Default" />.</param> |
| | | 176 | | /// <param name="logger">The logger. <see langword="null" /> is equivalent to <see cref="NullLogger.Instance" |
| | | 177 | | /// />.</param> |
| | | 178 | | public Server( |
| | | 179 | | IDispatcher dispatcher, |
| | | 180 | | SslServerAuthenticationOptions? serverAuthenticationOptions = null, |
| | | 181 | | IDuplexServerTransport? duplexServerTransport = null, |
| | | 182 | | IMultiplexedServerTransport? multiplexedServerTransport = null, |
| | | 183 | | ILogger? logger = null) |
| | 1 | 184 | | : this( |
| | 1 | 185 | | new ServerOptions |
| | 1 | 186 | | { |
| | 1 | 187 | | ServerAuthenticationOptions = serverAuthenticationOptions, |
| | 1 | 188 | | ConnectionOptions = new() |
| | 1 | 189 | | { |
| | 1 | 190 | | Dispatcher = dispatcher, |
| | 1 | 191 | | } |
| | 1 | 192 | | }, |
| | 1 | 193 | | duplexServerTransport, |
| | 1 | 194 | | multiplexedServerTransport, |
| | 1 | 195 | | logger) |
| | 1 | 196 | | { |
| | 1 | 197 | | } |
| | | 198 | | |
| | | 199 | | /// <summary>Constructs a server with the specified dispatcher, server address and authentication options. All |
| | | 200 | | /// other properties use the <see cref="ServerOptions" /> defaults.</summary> |
| | | 201 | | /// <param name="dispatcher">The dispatcher of the server.</param> |
| | | 202 | | /// <param name="serverAddress">The server address of the server.</param> |
| | | 203 | | /// <param name="serverAuthenticationOptions">The SSL server authentication options. When not <see langword="null" |
| | | 204 | | /// />, the server will accept only secure connections.</param> |
| | | 205 | | /// <param name="duplexServerTransport">The transport used to create ice protocol connections. <see langword="null" |
| | | 206 | | /// /> is equivalent to <see cref="IDuplexServerTransport.Default" />.</param> |
| | | 207 | | /// <param name="multiplexedServerTransport">The transport used to create icerpc protocol connections. <see |
| | | 208 | | /// langword="null" /> is equivalent to <see cref="IMultiplexedServerTransport.Default" />.</param> |
| | | 209 | | /// <param name="logger">The logger. <see langword="null" /> is equivalent to <see cref="NullLogger.Instance" |
| | | 210 | | /// />.</param> |
| | | 211 | | public Server( |
| | | 212 | | IDispatcher dispatcher, |
| | | 213 | | ServerAddress serverAddress, |
| | | 214 | | SslServerAuthenticationOptions? serverAuthenticationOptions = null, |
| | | 215 | | IDuplexServerTransport? duplexServerTransport = null, |
| | | 216 | | IMultiplexedServerTransport? multiplexedServerTransport = null, |
| | | 217 | | ILogger? logger = null) |
| | 34 | 218 | | : this( |
| | 34 | 219 | | new ServerOptions |
| | 34 | 220 | | { |
| | 34 | 221 | | ServerAuthenticationOptions = serverAuthenticationOptions, |
| | 34 | 222 | | ConnectionOptions = new() |
| | 34 | 223 | | { |
| | 34 | 224 | | Dispatcher = dispatcher, |
| | 34 | 225 | | }, |
| | 34 | 226 | | ServerAddress = serverAddress |
| | 34 | 227 | | }, |
| | 34 | 228 | | duplexServerTransport, |
| | 34 | 229 | | multiplexedServerTransport, |
| | 34 | 230 | | logger) |
| | 34 | 231 | | { |
| | 34 | 232 | | } |
| | | 233 | | |
| | | 234 | | /// <summary>Constructs a server with the specified dispatcher, server address URI and authentication options. All |
| | | 235 | | /// other properties use the <see cref="ServerOptions" /> defaults.</summary> |
| | | 236 | | /// <param name="dispatcher">The dispatcher of the server.</param> |
| | | 237 | | /// <param name="serverAddressUri">A URI that represents the server address of the server.</param> |
| | | 238 | | /// <param name="serverAuthenticationOptions">The SSL server authentication options. When not <see langword="null" |
| | | 239 | | /// />, the server will accept only secure connections.</param> |
| | | 240 | | /// <param name="duplexServerTransport">The transport used to create ice protocol connections. <see langword="null" |
| | | 241 | | /// /> is equivalent to <see cref="IDuplexServerTransport.Default" />.</param> |
| | | 242 | | /// <param name="multiplexedServerTransport">The transport used to create icerpc protocol connections. <see |
| | | 243 | | /// langword="null" /> is equivalent to <see cref="IMultiplexedServerTransport.Default" />.</param> |
| | | 244 | | /// <param name="logger">The logger. <see langword="null" /> is equivalent to <see cref="NullLogger.Instance" |
| | | 245 | | /// />.</param> |
| | | 246 | | public Server( |
| | | 247 | | IDispatcher dispatcher, |
| | | 248 | | Uri serverAddressUri, |
| | | 249 | | SslServerAuthenticationOptions? serverAuthenticationOptions = null, |
| | | 250 | | IDuplexServerTransport? duplexServerTransport = null, |
| | | 251 | | IMultiplexedServerTransport? multiplexedServerTransport = null, |
| | | 252 | | ILogger? logger = null) |
| | 14 | 253 | | : this( |
| | 14 | 254 | | dispatcher, |
| | 14 | 255 | | new ServerAddress(serverAddressUri), |
| | 14 | 256 | | serverAuthenticationOptions, |
| | 14 | 257 | | duplexServerTransport, |
| | 14 | 258 | | multiplexedServerTransport, |
| | 14 | 259 | | logger) |
| | 14 | 260 | | { |
| | 14 | 261 | | } |
| | | 262 | | |
| | | 263 | | /// <summary>Releases all resources allocated by this server. The server stops listening for new connections and |
| | | 264 | | /// disposes the connections it accepted from clients.</summary> |
| | | 265 | | /// <returns>A value task that completes when the disposal of all connections accepted by the server has completed. |
| | | 266 | | /// This includes connections that were active when this method is called and connections whose disposal was |
| | | 267 | | /// initiated prior to this call.</returns> |
| | | 268 | | /// <remarks>The disposal of an underlying connection of the server aborts invocations, cancels dispatches and |
| | | 269 | | /// disposes the underlying transport connection without waiting for the peer. To wait for invocations and |
| | | 270 | | /// dispatches to complete, call <see cref="ShutdownAsync" /> first. If the configured dispatcher does not complete |
| | | 271 | | /// promptly when its cancellation token is canceled, the disposal can hang.</remarks> |
| | | 272 | | public ValueTask DisposeAsync() |
| | 95 | 273 | | { |
| | | 274 | | lock (_mutex) |
| | 95 | 275 | | { |
| | 95 | 276 | | if (_disposeTask is null) |
| | 94 | 277 | | { |
| | 94 | 278 | | _shutdownTask ??= Task.CompletedTask; |
| | 94 | 279 | | if (_detachedConnectionCount == 0) |
| | 85 | 280 | | { |
| | 85 | 281 | | _ = _detachedConnectionsTcs.TrySetResult(); |
| | 85 | 282 | | } |
| | | 283 | | |
| | 94 | 284 | | _disposeTask = PerformDisposeAsync(); |
| | 94 | 285 | | } |
| | 95 | 286 | | return new(_disposeTask); |
| | | 287 | | } |
| | | 288 | | |
| | | 289 | | async Task PerformDisposeAsync() |
| | 94 | 290 | | { |
| | 94 | 291 | | await Task.Yield(); // exit mutex lock |
| | | 292 | | |
| | 94 | 293 | | _disposedCts.Cancel(); |
| | | 294 | | |
| | | 295 | | // _listenTask etc are immutable when _disposeTask is not null. |
| | | 296 | | |
| | | 297 | | // Wait for shutdown before disposing connections. |
| | | 298 | | try |
| | 94 | 299 | | { |
| | 94 | 300 | | await _shutdownTask.ConfigureAwait(false); |
| | 94 | 301 | | } |
| | 0 | 302 | | catch |
| | 0 | 303 | | { |
| | | 304 | | // Ignore exceptions. |
| | 0 | 305 | | } |
| | | 306 | | |
| | 94 | 307 | | if (_listenTask is not null) |
| | 93 | 308 | | { |
| | | 309 | | try |
| | 93 | 310 | | { |
| | 93 | 311 | | await _listenTask.ConfigureAwait(false); |
| | 93 | 312 | | } |
| | 0 | 313 | | catch |
| | 0 | 314 | | { |
| | | 315 | | // Ignore exceptions. |
| | 0 | 316 | | } |
| | | 317 | | |
| | 93 | 318 | | await Task.WhenAll( |
| | 93 | 319 | | _connections |
| | 49 | 320 | | .Select(connection => connection.DisposeAsync().AsTask()) |
| | 93 | 321 | | .Append(_detachedConnectionsTcs.Task)).ConfigureAwait(false); |
| | 93 | 322 | | } |
| | | 323 | | |
| | 94 | 324 | | _disposedCts.Dispose(); |
| | 94 | 325 | | _shutdownCts.Dispose(); |
| | 94 | 326 | | } |
| | 95 | 327 | | } |
| | | 328 | | |
| | | 329 | | /// <summary>Starts accepting connections on the configured server address. Requests received over these connections |
| | | 330 | | /// are then dispatched by the configured dispatcher.</summary> |
| | | 331 | | /// <returns>The server address this server is listening on and that a client would connect to. This address is the |
| | | 332 | | /// same as the <see cref="ServerOptions.ServerAddress" /> of <see cref="ServerOptions" /> except its |
| | | 333 | | /// <see cref="ServerAddress.Transport" /> property is always non-null and its port number is never 0 when the host |
| | | 334 | | /// is an IP address.</returns> |
| | | 335 | | /// <exception cref="IceRpcException">Thrown when the server transport fails to listen on the configured <see |
| | | 336 | | /// cref="ServerOptions.ServerAddress" />.</exception> |
| | | 337 | | /// <exception cref="InvalidOperationException">Thrown when the server is already listening, shut down or shutting |
| | | 338 | | /// down.</exception> |
| | | 339 | | /// <exception cref="ObjectDisposedException">Throw when the server is disposed.</exception> |
| | | 340 | | /// <remarks><see cref="Listen" /> can also throw exceptions from the transport; for example, the transport can |
| | | 341 | | /// reject the server address.</remarks> |
| | | 342 | | public ServerAddress Listen() |
| | 95 | 343 | | { |
| | | 344 | | lock (_mutex) |
| | 95 | 345 | | { |
| | 95 | 346 | | ObjectDisposedException.ThrowIf(_disposeTask is not null, this); |
| | | 347 | | |
| | 94 | 348 | | if (_shutdownTask is not null) |
| | 0 | 349 | | { |
| | 0 | 350 | | throw new InvalidOperationException($"Server '{this}' is shut down or shutting down."); |
| | | 351 | | } |
| | 94 | 352 | | if (_listenTask is not null) |
| | 1 | 353 | | { |
| | 1 | 354 | | throw new InvalidOperationException($"Server '{this}' is already listening."); |
| | | 355 | | } |
| | | 356 | | |
| | 93 | 357 | | IConnectorListener listener = _listenerFactory(); |
| | 93 | 358 | | _listenTask = ListenAsync(listener); // _listenTask owns listener and must dispose it |
| | 93 | 359 | | return listener.ServerAddress; |
| | | 360 | | } |
| | | 361 | | |
| | | 362 | | async Task ListenAsync(IConnectorListener listener) |
| | 93 | 363 | | { |
| | 93 | 364 | | await Task.Yield(); // exit mutex lock |
| | | 365 | | |
| | | 366 | | try |
| | 93 | 367 | | { |
| | 93 | 368 | | using var pendingConnectionSemaphore = new SemaphoreSlim( |
| | 93 | 369 | | _maxPendingConnections, |
| | 93 | 370 | | _maxPendingConnections); |
| | | 371 | | |
| | 185 | 372 | | while (!_shutdownCts.IsCancellationRequested) |
| | 185 | 373 | | { |
| | 185 | 374 | | await pendingConnectionSemaphore.WaitAsync(_shutdownCts.Token).ConfigureAwait(false); |
| | | 375 | | |
| | 184 | 376 | | IConnector? connector = null; |
| | | 377 | | do |
| | 199 | 378 | | { |
| | | 379 | | try |
| | 199 | 380 | | { |
| | 199 | 381 | | (connector, _) = await listener.AcceptAsync(_shutdownCts.Token).ConfigureAwait(false); |
| | 92 | 382 | | } |
| | 107 | 383 | | catch (Exception exception) when (IsRetryableAcceptException(exception)) |
| | 15 | 384 | | { |
| | | 385 | | // continue |
| | 15 | 386 | | } |
| | 107 | 387 | | } |
| | 107 | 388 | | while (connector is null); |
| | | 389 | | |
| | | 390 | | // We don't wait for the connection to be activated or shutdown. This could take a while for some |
| | | 391 | | // transports such as TLS based transports where the handshake requires few round trips between the |
| | | 392 | | // client and server. Waiting could also cause a security issue if the client doesn't respond to the |
| | | 393 | | // connection initialization as we wouldn't be able to accept new connections in the meantime. The |
| | | 394 | | // call will eventually timeout if the ConnectTimeout expires. |
| | 92 | 395 | | CancellationToken cancellationToken = _disposedCts.Token; |
| | 92 | 396 | | _ = Task.Run( |
| | 92 | 397 | | async () => |
| | 92 | 398 | | { |
| | 92 | 399 | | try |
| | 92 | 400 | | { |
| | 92 | 401 | | await ConnectAsync(connector, cancellationToken).ConfigureAwait(false); |
| | 87 | 402 | | } |
| | 5 | 403 | | catch |
| | 5 | 404 | | { |
| | 92 | 405 | | // Ignore connection establishment failure. This failures are logged by the |
| | 92 | 406 | | // LogConnectorDecorator |
| | 5 | 407 | | } |
| | 92 | 408 | | finally |
| | 92 | 409 | | { |
| | 92 | 410 | | // The connection dispose will dispose the transport connection if it has not been |
| | 92 | 411 | | // adopted by the protocol connection. |
| | 92 | 412 | | await connector.DisposeAsync().ConfigureAwait(false); |
| | 92 | 413 | | |
| | 92 | 414 | | // The pending connection semaphore is disposed by the listen task completion once |
| | 92 | 415 | | // shutdown / dispose is initiated. |
| | 92 | 416 | | lock (_mutex) |
| | 92 | 417 | | { |
| | 92 | 418 | | if (_shutdownTask is null) |
| | 88 | 419 | | { |
| | 88 | 420 | | pendingConnectionSemaphore.Release(); |
| | 88 | 421 | | } |
| | 92 | 422 | | } |
| | 92 | 423 | | } |
| | 92 | 424 | | }, |
| | 92 | 425 | | CancellationToken.None); // the task must run to dispose the connector. |
| | 92 | 426 | | } |
| | 0 | 427 | | } |
| | 93 | 428 | | catch |
| | 93 | 429 | | { |
| | | 430 | | // Ignore. Exceptions thrown by listener.AcceptAsync are logged by the log decorator when appropriate. |
| | 93 | 431 | | } |
| | | 432 | | finally |
| | 93 | 433 | | { |
| | 93 | 434 | | await listener.DisposeAsync().ConfigureAwait(false); |
| | 93 | 435 | | } |
| | | 436 | | |
| | | 437 | | async Task ConnectAsync(IConnector connector, CancellationToken cancellationToken) |
| | 92 | 438 | | { |
| | 92 | 439 | | using var connectCts = CancellationTokenSource.CreateLinkedTokenSource(cancellationToken); |
| | 92 | 440 | | connectCts.CancelAfter(_connectTimeout); |
| | | 441 | | |
| | | 442 | | // Connect the transport connection first. This connection establishment can be interrupted by the |
| | | 443 | | // connect timeout or the server ShutdownAsync/DisposeAsync. |
| | 92 | 444 | | TransportConnectionInformation transportConnectionInformation = |
| | 92 | 445 | | await connector.ConnectTransportConnectionAsync(connectCts.Token).ConfigureAwait(false); |
| | | 446 | | |
| | 87 | 447 | | IProtocolConnection? protocolConnection = null; |
| | 87 | 448 | | bool serverBusy = false; |
| | | 449 | | |
| | | 450 | | lock (_mutex) |
| | 87 | 451 | | { |
| | 87 | 452 | | Debug.Assert( |
| | 87 | 453 | | _maxConnections == 0 || _connections.Count + _detachedConnectionCount <= _maxConnections); |
| | | 454 | | |
| | 87 | 455 | | if (_shutdownTask is null) |
| | 87 | 456 | | { |
| | 87 | 457 | | if (_maxConnections > 0 && (_connections.Count + _detachedConnectionCount) == _maxConnections) |
| | 7 | 458 | | { |
| | 7 | 459 | | serverBusy = true; |
| | 7 | 460 | | } |
| | | 461 | | else |
| | 80 | 462 | | { |
| | | 463 | | // The protocol connection adopts the transport connection from the connector and it's |
| | | 464 | | // now responsible for disposing of it. |
| | 80 | 465 | | protocolConnection = connector.CreateProtocolConnection(transportConnectionInformation); |
| | 80 | 466 | | _detachedConnectionCount++; |
| | 80 | 467 | | } |
| | 87 | 468 | | } |
| | 87 | 469 | | } |
| | | 470 | | |
| | 87 | 471 | | if (protocolConnection is null) |
| | 7 | 472 | | { |
| | | 473 | | try |
| | 7 | 474 | | { |
| | 7 | 475 | | await connector.RefuseTransportConnectionAsync(serverBusy, connectCts.Token) |
| | 7 | 476 | | .ConfigureAwait(false); |
| | 5 | 477 | | } |
| | 2 | 478 | | catch |
| | 2 | 479 | | { |
| | | 480 | | // ignore and continue |
| | 2 | 481 | | } |
| | | 482 | | // The transport connection is disposed by the disposal of the connector. |
| | 7 | 483 | | } |
| | | 484 | | else |
| | 80 | 485 | | { |
| | | 486 | | Task shutdownRequested; |
| | | 487 | | try |
| | 80 | 488 | | { |
| | 80 | 489 | | (_, shutdownRequested) = await protocolConnection.ConnectAsync(connectCts.Token) |
| | 80 | 490 | | .ConfigureAwait(false); |
| | 80 | 491 | | } |
| | 0 | 492 | | catch |
| | 0 | 493 | | { |
| | 0 | 494 | | await DisposeDetachedConnectionAsync(protocolConnection, withShutdown: false) |
| | 0 | 495 | | .ConfigureAwait(false); |
| | 0 | 496 | | throw; |
| | | 497 | | } |
| | | 498 | | |
| | 80 | 499 | | LinkedListNode<IProtocolConnection>? listNode = null; |
| | | 500 | | |
| | | 501 | | lock (_mutex) |
| | | 502 | | { |
| | 80 | 503 | | if (_shutdownTask is null) |
| | | 504 | | { |
| | 79 | 505 | | listNode = _connections.AddLast(protocolConnection); |
| | | 506 | | |
| | | 507 | | // protocolConnection is no longer a detached connection since it's now "attached" in |
| | | 508 | | // _connections. |
| | 79 | 509 | | _detachedConnectionCount--; |
| | | 510 | | } |
| | 80 | 511 | | } |
| | | 512 | | |
| | 80 | 513 | | if (listNode is null) |
| | | 514 | | { |
| | 1 | 515 | | await DisposeDetachedConnectionAsync(protocolConnection, withShutdown: true) |
| | 1 | 516 | | .ConfigureAwait(false); |
| | | 517 | | } |
| | | 518 | | else |
| | 79 | 519 | | { |
| | | 520 | | // Schedule removal after successful ConnectAsync. |
| | 79 | 521 | | _ = ShutdownWhenRequestedAsync(protocolConnection, shutdownRequested, listNode); |
| | | 522 | | } |
| | 80 | 523 | | } |
| | | 524 | | } |
| | | 525 | | } |
| | | 526 | | |
| | | 527 | | async Task DisposeDetachedConnectionAsync(IProtocolConnection connection, bool withShutdown) |
| | 31 | 528 | | { |
| | 31 | 529 | | if (withShutdown) |
| | 31 | 530 | | { |
| | | 531 | | // _disposedCts is not disposed since we own a _backgroundConnectionDisposeCount. |
| | 31 | 532 | | using var cts = CancellationTokenSource.CreateLinkedTokenSource(_disposedCts.Token); |
| | 31 | 533 | | cts.CancelAfter(_shutdownTimeout); |
| | | 534 | | |
| | | 535 | | try |
| | 31 | 536 | | { |
| | | 537 | | // Can be canceled by DisposeAsync or the shutdown timeout. |
| | 31 | 538 | | await connection.ShutdownAsync(cts.Token).ConfigureAwait(false); |
| | 21 | 539 | | } |
| | 10 | 540 | | catch |
| | 10 | 541 | | { |
| | | 542 | | // Ignore connection shutdown failures. connection.ShutdownAsync makes sure it's an "expected" |
| | | 543 | | // exception. |
| | 10 | 544 | | } |
| | 31 | 545 | | } |
| | | 546 | | |
| | 31 | 547 | | await connection.DisposeAsync().ConfigureAwait(false); |
| | | 548 | | lock (_mutex) |
| | 31 | 549 | | { |
| | 31 | 550 | | if (--_detachedConnectionCount == 0 && _shutdownTask is not null) |
| | 15 | 551 | | { |
| | 15 | 552 | | _detachedConnectionsTcs.SetResult(); |
| | 15 | 553 | | } |
| | 31 | 554 | | } |
| | 31 | 555 | | } |
| | | 556 | | |
| | | 557 | | // Remove the connection from _connections after a successful ConnectAsync. |
| | | 558 | | async Task ShutdownWhenRequestedAsync( |
| | | 559 | | IProtocolConnection connection, |
| | | 560 | | Task shutdownRequested, |
| | | 561 | | LinkedListNode<IProtocolConnection> listNode) |
| | 79 | 562 | | { |
| | 79 | 563 | | await shutdownRequested.ConfigureAwait(false); |
| | | 564 | | |
| | | 565 | | lock (_mutex) |
| | 69 | 566 | | { |
| | 69 | 567 | | if (_shutdownTask is null) |
| | 30 | 568 | | { |
| | 30 | 569 | | _connections.Remove(listNode); |
| | 30 | 570 | | _detachedConnectionCount++; |
| | 30 | 571 | | } |
| | | 572 | | else |
| | 39 | 573 | | { |
| | | 574 | | // _connections is immutable and ShutdownAsync/DisposeAsync is responsible to shutdown/dispose |
| | | 575 | | // this connection. |
| | 39 | 576 | | return; |
| | | 577 | | } |
| | 30 | 578 | | } |
| | | 579 | | |
| | 30 | 580 | | await DisposeDetachedConnectionAsync(connection, withShutdown: true).ConfigureAwait(false); |
| | 69 | 581 | | } |
| | 273 | 582 | | } |
| | | 583 | | |
| | | 584 | | /// <summary>Gracefully shuts down this server: the server stops accepting new connections and shuts down gracefully |
| | | 585 | | /// all its connections.</summary> |
| | | 586 | | /// <param name="cancellationToken">A cancellation token that receives the cancellation requests.</param> |
| | | 587 | | /// <returns>A task that completes successfully once the shutdown of all connections accepted by the server has |
| | | 588 | | /// completed. This includes connections that were active when this method is called and connections whose shutdown |
| | | 589 | | /// was initiated prior to this call.</returns> |
| | | 590 | | /// <exception cref="InvalidOperationException">Thrown if this method is called more than once.</exception> |
| | | 591 | | /// <exception cref="ObjectDisposedException">Thrown if the server is disposed.</exception> |
| | | 592 | | /// <remarks><para>The returned task can also complete with one of the following exceptions:</para> |
| | | 593 | | /// <list type="bullet"> |
| | | 594 | | /// <item><description><see cref="IceRpcException" /> with error <see cref="IceRpcError.OperationAborted" /> if the |
| | | 595 | | /// server is disposed while being shut down.</description></item> |
| | | 596 | | /// <item><description><see cref="OperationCanceledException" /> if cancellation was requested through the |
| | | 597 | | /// cancellation token.</description></item> |
| | | 598 | | /// <item><description><see cref="TimeoutException" /> if the shutdown timed out.</description></item> |
| | | 599 | | /// </list> |
| | | 600 | | /// </remarks> |
| | | 601 | | public Task ShutdownAsync(CancellationToken cancellationToken = default) |
| | 34 | 602 | | { |
| | | 603 | | lock (_mutex) |
| | 34 | 604 | | { |
| | 34 | 605 | | ObjectDisposedException.ThrowIf(_disposeTask is not null, this); |
| | | 606 | | |
| | 34 | 607 | | if (_shutdownTask is not null) |
| | 0 | 608 | | { |
| | 0 | 609 | | throw new InvalidOperationException($"Server '{this}' is shut down or shutting down."); |
| | | 610 | | } |
| | | 611 | | |
| | 34 | 612 | | if (_detachedConnectionCount == 0) |
| | 28 | 613 | | { |
| | 28 | 614 | | _detachedConnectionsTcs.SetResult(); |
| | 28 | 615 | | } |
| | | 616 | | |
| | 34 | 617 | | _shutdownTask = PerformShutdownAsync(); |
| | 34 | 618 | | } |
| | 34 | 619 | | return _shutdownTask; |
| | | 620 | | |
| | | 621 | | async Task PerformShutdownAsync() |
| | 34 | 622 | | { |
| | 34 | 623 | | await Task.Yield(); // exit mutex lock |
| | | 624 | | |
| | 34 | 625 | | _shutdownCts.Cancel(); |
| | | 626 | | |
| | | 627 | | // _listenTask is immutable once _shutdownTask is not null. |
| | 34 | 628 | | if (_listenTask is not null) |
| | 34 | 629 | | { |
| | | 630 | | try |
| | 34 | 631 | | { |
| | 34 | 632 | | using var cts = CancellationTokenSource.CreateLinkedTokenSource( |
| | 34 | 633 | | cancellationToken, |
| | 34 | 634 | | _disposedCts.Token); |
| | | 635 | | |
| | 34 | 636 | | cts.CancelAfter(_shutdownTimeout); |
| | | 637 | | |
| | | 638 | | try |
| | 34 | 639 | | { |
| | 34 | 640 | | await Task.WhenAll( |
| | 34 | 641 | | _connections |
| | 14 | 642 | | .Select(connection => connection.ShutdownAsync(cts.Token)) |
| | 34 | 643 | | .Append(_listenTask.WaitAsync(cts.Token)) |
| | 34 | 644 | | .Append(_detachedConnectionsTcs.Task.WaitAsync(cts.Token))) |
| | 34 | 645 | | .ConfigureAwait(false); |
| | 33 | 646 | | } |
| | 0 | 647 | | catch (OperationCanceledException) |
| | 0 | 648 | | { |
| | 0 | 649 | | throw; |
| | | 650 | | } |
| | 1 | 651 | | catch |
| | 1 | 652 | | { |
| | | 653 | | // Ignore _listenTask and connection shutdown exceptions |
| | | 654 | | |
| | | 655 | | // Throw OperationCanceledException if this WhenAll exception is hiding an OCE. |
| | 1 | 656 | | cts.Token.ThrowIfCancellationRequested(); |
| | 1 | 657 | | } |
| | 34 | 658 | | } |
| | 0 | 659 | | catch (OperationCanceledException) |
| | 0 | 660 | | { |
| | 0 | 661 | | cancellationToken.ThrowIfCancellationRequested(); |
| | | 662 | | |
| | 0 | 663 | | if (_disposedCts.IsCancellationRequested) |
| | 0 | 664 | | { |
| | 0 | 665 | | throw new IceRpcException( |
| | 0 | 666 | | IceRpcError.OperationAborted, |
| | 0 | 667 | | "The shutdown was aborted because the server was disposed."); |
| | | 668 | | } |
| | | 669 | | else |
| | 0 | 670 | | { |
| | 0 | 671 | | throw new TimeoutException( |
| | 0 | 672 | | $"The server shut down timed out after {_shutdownTimeout.TotalSeconds} s."); |
| | | 673 | | } |
| | | 674 | | } |
| | 34 | 675 | | } |
| | 34 | 676 | | } |
| | 34 | 677 | | } |
| | | 678 | | |
| | | 679 | | /// <summary>Returns a string that represents this server.</summary> |
| | | 680 | | /// <returns>A string that represents this server.</returns> |
| | 1 | 681 | | public override string ToString() => _serverAddress.ToString(); |
| | | 682 | | |
| | | 683 | | /// <summary>Returns true if the <see cref="IConnectorListener.AcceptAsync" /> failure can be retried.</summary> |
| | | 684 | | private static bool IsRetryableAcceptException(Exception exception) => |
| | | 685 | | // Transports such as QUIC do the SSL handshake when the connection is accepted, this can throw |
| | | 686 | | // AuthenticationException if it fails. |
| | 107 | 687 | | exception is IceRpcException or AuthenticationException; |
| | | 688 | | |
| | | 689 | | /// <summary>Provides a decorator that adds logging to a <see cref="IConnectorListener" />.</summary> |
| | | 690 | | private class LogConnectorListenerDecorator : IConnectorListener |
| | | 691 | | { |
| | 46 | 692 | | public ServerAddress ServerAddress => _decoratee.ServerAddress; |
| | | 693 | | |
| | | 694 | | private readonly IConnectorListener _decoratee; |
| | | 695 | | private readonly ILogger _logger; |
| | | 696 | | |
| | | 697 | | public async Task<(IConnector, EndPoint)> AcceptAsync(CancellationToken cancellationToken) |
| | 18 | 698 | | { |
| | | 699 | | try |
| | 18 | 700 | | { |
| | 18 | 701 | | (IConnector connector, EndPoint remoteNetworkAddress) = |
| | 18 | 702 | | await _decoratee.AcceptAsync(cancellationToken).ConfigureAwait(false); |
| | | 703 | | |
| | 8 | 704 | | _logger.LogConnectionAccepted(ServerAddress, remoteNetworkAddress); |
| | 8 | 705 | | return ( |
| | 8 | 706 | | new LogConnectorDecorator(connector, ServerAddress, remoteNetworkAddress, _logger), |
| | 8 | 707 | | remoteNetworkAddress); |
| | | 708 | | } |
| | 10 | 709 | | catch (OperationCanceledException exception) when (exception.CancellationToken == cancellationToken) |
| | 10 | 710 | | { |
| | | 711 | | // Do not log this exception. The AcceptAsync call can fail with OperationCanceledException during |
| | | 712 | | // shutdown once the shutdown cancellation token is canceled. |
| | 10 | 713 | | throw; |
| | | 714 | | } |
| | 0 | 715 | | catch (ObjectDisposedException) |
| | 0 | 716 | | { |
| | | 717 | | // Do not log this exception. The AcceptAsync call can fail with ObjectDisposedException during |
| | | 718 | | // shutdown once the listener is disposed or if it is accepting a connection while the listener is |
| | | 719 | | // disposed. |
| | 0 | 720 | | throw; |
| | | 721 | | } |
| | 0 | 722 | | catch (Exception exception) when (IsRetryableAcceptException(exception)) |
| | 0 | 723 | | { |
| | 0 | 724 | | _logger.LogConnectionAcceptFailedWithRetryableException(ServerAddress, exception); |
| | 0 | 725 | | throw; |
| | | 726 | | } |
| | 0 | 727 | | catch (Exception exception) |
| | 0 | 728 | | { |
| | 0 | 729 | | _logger.LogConnectionAcceptFailed(ServerAddress, exception); |
| | 0 | 730 | | throw; |
| | | 731 | | } |
| | 8 | 732 | | } |
| | | 733 | | |
| | | 734 | | public ValueTask DisposeAsync() |
| | 10 | 735 | | { |
| | 10 | 736 | | _logger.LogStopAcceptingConnections(ServerAddress); |
| | 10 | 737 | | return _decoratee.DisposeAsync(); |
| | 10 | 738 | | } |
| | | 739 | | |
| | 10 | 740 | | internal LogConnectorListenerDecorator(IConnectorListener decoratee, ILogger logger) |
| | 10 | 741 | | { |
| | 10 | 742 | | _decoratee = decoratee; |
| | 10 | 743 | | _logger = logger; |
| | 10 | 744 | | _logger.LogStartAcceptingConnections(ServerAddress); |
| | 10 | 745 | | } |
| | | 746 | | } |
| | | 747 | | |
| | | 748 | | private class LogConnectorDecorator : IConnector |
| | | 749 | | { |
| | | 750 | | private readonly IConnector _decoratee; |
| | | 751 | | private readonly ILogger _logger; |
| | | 752 | | private readonly EndPoint _remoteNetworkAddress; |
| | | 753 | | private readonly ServerAddress _serverAddress; |
| | | 754 | | |
| | | 755 | | public async Task<TransportConnectionInformation> ConnectTransportConnectionAsync( |
| | | 756 | | CancellationToken cancellationToken) |
| | 8 | 757 | | { |
| | | 758 | | try |
| | 8 | 759 | | { |
| | 8 | 760 | | return await _decoratee.ConnectTransportConnectionAsync(cancellationToken).ConfigureAwait(false); |
| | | 761 | | } |
| | 2 | 762 | | catch (Exception exception) |
| | 2 | 763 | | { |
| | 2 | 764 | | _logger.LogConnectionConnectFailed(_serverAddress, _remoteNetworkAddress, exception); |
| | 2 | 765 | | throw; |
| | | 766 | | } |
| | 6 | 767 | | } |
| | | 768 | | |
| | | 769 | | public IProtocolConnection CreateProtocolConnection( |
| | | 770 | | TransportConnectionInformation transportConnectionInformation) => |
| | 6 | 771 | | new LogProtocolConnectionDecorator( |
| | 6 | 772 | | _decoratee.CreateProtocolConnection(transportConnectionInformation), |
| | 6 | 773 | | _serverAddress, |
| | 6 | 774 | | _remoteNetworkAddress, |
| | 6 | 775 | | _logger); |
| | | 776 | | |
| | 8 | 777 | | public ValueTask DisposeAsync() => _decoratee.DisposeAsync(); |
| | | 778 | | |
| | | 779 | | public Task RefuseTransportConnectionAsync(bool serverBusy, CancellationToken cancel) => |
| | 0 | 780 | | _decoratee.RefuseTransportConnectionAsync(serverBusy, cancel); |
| | | 781 | | |
| | 8 | 782 | | internal LogConnectorDecorator( |
| | 8 | 783 | | IConnector decoratee, |
| | 8 | 784 | | ServerAddress serverAddress, |
| | 8 | 785 | | EndPoint remoteNetworkAddress, |
| | 8 | 786 | | ILogger logger) |
| | 8 | 787 | | { |
| | 8 | 788 | | _decoratee = decoratee; |
| | 8 | 789 | | _logger = logger; |
| | 8 | 790 | | _serverAddress = serverAddress; |
| | 8 | 791 | | _remoteNetworkAddress = remoteNetworkAddress; |
| | 8 | 792 | | } |
| | | 793 | | } |
| | | 794 | | |
| | | 795 | | /// <summary>Provides a decorator that adds metrics to a <see cref="IConnectorListener" />.</summary> |
| | | 796 | | private class MetricsConnectorListenerDecorator : IConnectorListener |
| | | 797 | | { |
| | 129 | 798 | | public ServerAddress ServerAddress => _decoratee.ServerAddress; |
| | | 799 | | |
| | | 800 | | private readonly IConnectorListener _decoratee; |
| | | 801 | | |
| | | 802 | | public async Task<(IConnector, EndPoint)> AcceptAsync( |
| | | 803 | | CancellationToken cancellationToken) |
| | 199 | 804 | | { |
| | 199 | 805 | | (IConnector connector, EndPoint remoteNetworkAddress) = |
| | 199 | 806 | | await _decoratee.AcceptAsync(cancellationToken).ConfigureAwait(false); |
| | 92 | 807 | | return (new MetricsConnectorDecorator(connector), remoteNetworkAddress); |
| | 92 | 808 | | } |
| | | 809 | | |
| | 93 | 810 | | public ValueTask DisposeAsync() => _decoratee.DisposeAsync(); |
| | | 811 | | |
| | 93 | 812 | | internal MetricsConnectorListenerDecorator(IConnectorListener decoratee) => |
| | 93 | 813 | | _decoratee = decoratee; |
| | | 814 | | } |
| | | 815 | | |
| | | 816 | | private class MetricsConnectorDecorator : IConnector |
| | | 817 | | { |
| | | 818 | | private readonly IConnector _decoratee; |
| | | 819 | | |
| | | 820 | | public async Task<TransportConnectionInformation> ConnectTransportConnectionAsync( |
| | | 821 | | CancellationToken cancellationToken) |
| | 92 | 822 | | { |
| | 92 | 823 | | Metrics.ServerMetrics.ConnectStart(); |
| | | 824 | | try |
| | 92 | 825 | | { |
| | 92 | 826 | | return await _decoratee.ConnectTransportConnectionAsync(cancellationToken).ConfigureAwait(false); |
| | | 827 | | } |
| | 5 | 828 | | catch |
| | 5 | 829 | | { |
| | 5 | 830 | | Metrics.ServerMetrics.ConnectStop(); |
| | 5 | 831 | | Metrics.ServerMetrics.ConnectionFailure(); |
| | 5 | 832 | | throw; |
| | | 833 | | } |
| | 87 | 834 | | } |
| | | 835 | | |
| | | 836 | | public IProtocolConnection CreateProtocolConnection( |
| | | 837 | | TransportConnectionInformation transportConnectionInformation) => |
| | 80 | 838 | | new MetricsProtocolConnectionDecorator( |
| | 80 | 839 | | _decoratee.CreateProtocolConnection(transportConnectionInformation), |
| | 80 | 840 | | Metrics.ServerMetrics, |
| | 80 | 841 | | connectStarted: true); |
| | | 842 | | |
| | 92 | 843 | | public ValueTask DisposeAsync() => _decoratee.DisposeAsync(); |
| | | 844 | | |
| | | 845 | | public async Task RefuseTransportConnectionAsync(bool serverBusy, CancellationToken cancel) |
| | 7 | 846 | | { |
| | | 847 | | try |
| | 7 | 848 | | { |
| | 7 | 849 | | await _decoratee.RefuseTransportConnectionAsync(serverBusy, cancel).ConfigureAwait(false); |
| | 5 | 850 | | } |
| | | 851 | | finally |
| | 7 | 852 | | { |
| | 7 | 853 | | Metrics.ServerMetrics.ConnectionFailure(); |
| | 7 | 854 | | Metrics.ServerMetrics.ConnectStop(); |
| | 7 | 855 | | } |
| | 5 | 856 | | } |
| | | 857 | | |
| | 184 | 858 | | internal MetricsConnectorDecorator(IConnector decoratee) => _decoratee = decoratee; |
| | | 859 | | } |
| | | 860 | | |
| | | 861 | | /// <summary>A connector listener accepts a transport connection and returns a <see cref="IConnector" />. The |
| | | 862 | | /// connector is used to refuse the transport connection or obtain a protocol connection once the transport |
| | | 863 | | /// connection is connected.</summary> |
| | | 864 | | private interface IConnectorListener : IAsyncDisposable |
| | | 865 | | { |
| | | 866 | | ServerAddress ServerAddress { get; } |
| | | 867 | | |
| | | 868 | | Task<(IConnector, EndPoint)> AcceptAsync(CancellationToken cancel); |
| | | 869 | | } |
| | | 870 | | |
| | | 871 | | /// <summary>A connector is returned by <see cref="IConnectorListener" />. The connector allows to connect the |
| | | 872 | | /// transport connection. If successful, the transport connection can either be refused or accepted by creating the |
| | | 873 | | /// protocol connection out of it.</summary> |
| | | 874 | | private interface IConnector : IAsyncDisposable |
| | | 875 | | { |
| | | 876 | | Task<TransportConnectionInformation> ConnectTransportConnectionAsync(CancellationToken cancellationToken); |
| | | 877 | | |
| | | 878 | | IProtocolConnection CreateProtocolConnection(TransportConnectionInformation transportConnectionInformation); |
| | | 879 | | |
| | | 880 | | Task RefuseTransportConnectionAsync(bool serverBusy, CancellationToken cancel); |
| | | 881 | | } |
| | | 882 | | |
| | | 883 | | private class IceConnectorListener : IConnectorListener |
| | | 884 | | { |
| | 43 | 885 | | public ServerAddress ServerAddress { get; } |
| | | 886 | | |
| | | 887 | | private readonly IListener<IDuplexConnection> _listener; |
| | | 888 | | private readonly ConnectionOptions _options; |
| | | 889 | | |
| | 25 | 890 | | public ValueTask DisposeAsync() => _listener.DisposeAsync(); |
| | | 891 | | |
| | | 892 | | public async Task<(IConnector, EndPoint)> AcceptAsync(CancellationToken cancel) |
| | 51 | 893 | | { |
| | 51 | 894 | | (IDuplexConnection transportConnection, EndPoint remoteNetworkAddress) = await _listener.AcceptAsync( |
| | 51 | 895 | | cancel).ConfigureAwait(false); |
| | 26 | 896 | | return (new IceConnector(transportConnection, _options), remoteNetworkAddress); |
| | 26 | 897 | | } |
| | | 898 | | |
| | 25 | 899 | | internal IceConnectorListener( |
| | 25 | 900 | | IListener<IDuplexConnection> listener, |
| | 25 | 901 | | ServerAddress serverAddress, |
| | 25 | 902 | | ConnectionOptions options) |
| | 25 | 903 | | { |
| | 25 | 904 | | _listener = listener; |
| | 25 | 905 | | ServerAddress = serverAddress with { Port = listener.TransportAddress.Port }; |
| | 25 | 906 | | _options = options; |
| | 25 | 907 | | } |
| | | 908 | | } |
| | | 909 | | |
| | | 910 | | private class IceConnector : IConnector |
| | | 911 | | { |
| | | 912 | | private readonly ConnectionOptions _options; |
| | | 913 | | private IDuplexConnection? _transportConnection; |
| | | 914 | | |
| | | 915 | | public Task<TransportConnectionInformation> ConnectTransportConnectionAsync( |
| | | 916 | | CancellationToken cancellationToken) => |
| | 26 | 917 | | _transportConnection!.ConnectAsync(cancellationToken); |
| | | 918 | | |
| | | 919 | | public IProtocolConnection CreateProtocolConnection( |
| | | 920 | | TransportConnectionInformation transportConnectionInformation) |
| | 23 | 921 | | { |
| | | 922 | | // The protocol connection takes ownership of the transport connection. |
| | 23 | 923 | | var protocolConnection = new IceProtocolConnection( |
| | 23 | 924 | | _transportConnection!, |
| | 23 | 925 | | transportConnectionInformation, |
| | 23 | 926 | | _options); |
| | 23 | 927 | | _transportConnection = null; |
| | 23 | 928 | | return protocolConnection; |
| | 23 | 929 | | } |
| | | 930 | | |
| | | 931 | | public ValueTask DisposeAsync() |
| | 26 | 932 | | { |
| | 26 | 933 | | _transportConnection?.Dispose(); |
| | 26 | 934 | | return new(); |
| | 26 | 935 | | } |
| | | 936 | | |
| | | 937 | | public Task RefuseTransportConnectionAsync(bool serverBusy, CancellationToken cancellationToken) |
| | 2 | 938 | | { |
| | 2 | 939 | | _transportConnection!.Dispose(); |
| | 2 | 940 | | return Task.CompletedTask; |
| | 2 | 941 | | } |
| | | 942 | | |
| | 26 | 943 | | internal IceConnector(IDuplexConnection transportConnection, ConnectionOptions options) |
| | 26 | 944 | | { |
| | 26 | 945 | | _transportConnection = transportConnection; |
| | 26 | 946 | | _options = options; |
| | 26 | 947 | | } |
| | | 948 | | } |
| | | 949 | | |
| | | 950 | | private class IceRpcConnectorListener : IConnectorListener |
| | | 951 | | { |
| | 86 | 952 | | public ServerAddress ServerAddress { get; } |
| | | 953 | | |
| | | 954 | | private readonly IListener<IMultiplexedConnection> _listener; |
| | | 955 | | private readonly ConnectionOptions _options; |
| | | 956 | | private readonly ITaskExceptionObserver? _taskExceptionObserver; |
| | | 957 | | |
| | | 958 | | public async Task<(IConnector, EndPoint)> AcceptAsync(CancellationToken cancel) |
| | 148 | 959 | | { |
| | 148 | 960 | | (IMultiplexedConnection transportConnection, EndPoint remoteNetworkAddress) = await _listener.AcceptAsync( |
| | 148 | 961 | | cancel).ConfigureAwait(false); |
| | 66 | 962 | | return (new IceRpcConnector(transportConnection, _options, _taskExceptionObserver), remoteNetworkAddress); |
| | 66 | 963 | | } |
| | | 964 | | |
| | 68 | 965 | | public ValueTask DisposeAsync() => _listener.DisposeAsync(); |
| | | 966 | | |
| | 68 | 967 | | internal IceRpcConnectorListener( |
| | 68 | 968 | | IListener<IMultiplexedConnection> listener, |
| | 68 | 969 | | ServerAddress serverAddress, |
| | 68 | 970 | | ConnectionOptions options, |
| | 68 | 971 | | ITaskExceptionObserver? taskExceptionObserver) |
| | 68 | 972 | | { |
| | 68 | 973 | | _listener = listener; |
| | 68 | 974 | | ServerAddress = serverAddress with { Port = listener.TransportAddress.Port }; |
| | 68 | 975 | | _options = options; |
| | 68 | 976 | | _taskExceptionObserver = taskExceptionObserver; |
| | 68 | 977 | | } |
| | | 978 | | } |
| | | 979 | | |
| | | 980 | | private class IceRpcConnector : IConnector |
| | | 981 | | { |
| | | 982 | | private readonly ConnectionOptions _options; |
| | | 983 | | private readonly ITaskExceptionObserver? _taskExceptionObserver; |
| | | 984 | | private IMultiplexedConnection? _transportConnection; |
| | | 985 | | |
| | | 986 | | public Task<TransportConnectionInformation> ConnectTransportConnectionAsync( |
| | | 987 | | CancellationToken cancellationToken) => |
| | 66 | 988 | | _transportConnection!.ConnectAsync(cancellationToken); |
| | | 989 | | |
| | | 990 | | public IProtocolConnection CreateProtocolConnection( |
| | | 991 | | TransportConnectionInformation transportConnectionInformation) |
| | 57 | 992 | | { |
| | | 993 | | // The protocol connection takes ownership of the transport connection. |
| | 57 | 994 | | var protocolConnection = new IceRpcProtocolConnection( |
| | 57 | 995 | | _transportConnection!, |
| | 57 | 996 | | transportConnectionInformation, |
| | 57 | 997 | | _options, |
| | 57 | 998 | | _taskExceptionObserver); |
| | 57 | 999 | | _transportConnection = null; |
| | 57 | 1000 | | return protocolConnection; |
| | 57 | 1001 | | } |
| | | 1002 | | |
| | 66 | 1003 | | public ValueTask DisposeAsync() => _transportConnection?.DisposeAsync() ?? new(); |
| | | 1004 | | |
| | | 1005 | | public Task RefuseTransportConnectionAsync(bool serverBusy, CancellationToken cancellationToken) => |
| | 5 | 1006 | | _transportConnection!.CloseAsync( |
| | 5 | 1007 | | serverBusy ? MultiplexedConnectionCloseError.ServerBusy : MultiplexedConnectionCloseError.Refused, |
| | 5 | 1008 | | cancellationToken); |
| | | 1009 | | |
| | 66 | 1010 | | internal IceRpcConnector( |
| | 66 | 1011 | | IMultiplexedConnection transportConnection, |
| | 66 | 1012 | | ConnectionOptions options, |
| | 66 | 1013 | | ITaskExceptionObserver? taskExceptionObserver) |
| | 66 | 1014 | | { |
| | 66 | 1015 | | _transportConnection = transportConnection; |
| | 66 | 1016 | | _options = options; |
| | 66 | 1017 | | _taskExceptionObserver = taskExceptionObserver; |
| | 66 | 1018 | | } |
| | | 1019 | | } |
| | | 1020 | | } |