Soullies/ichni_Official
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

add all

Browse Source
This commit is contained in:
stevesensei
2026-06-15 18:18:16 +08:00
parent 97c9fba14e
commit 2b9f134e5f
4164 changed files with 386922 additions and 79 deletions
Download Patch File Download Diff File Expand all files Collapse all files

150
Packages/com.tivadar.best.http/Runtime/HTTP/Hosts/Manager/HostManager.cs Normal file
View File

@@ -0,0 +1,150 @@
using System.Collections.Generic;
using Best.HTTP.Hosts.Connections;
using Best.HTTP.Shared;
namespace Best.HTTP.HostSetting
{
/*
┌───────────────┐
┌──────┤ HostManager ├──────────────────────┐
│ └───────────────┘ │
│ │
┌──────────▼───────┐ ┌──────────▼────────┐
│ HostVariant │ │ HostVariant │
│(http://host:port)│ │(https://host:port)│
┌────┴──────┬──────────┬┘ ┌────┴──────┬───────────┬┘
│ │ │ │ │ │
┌──────▼──────┐ ┌──▼──┐ ▼ ┌──────▼──────┐ ┌──▼──┐ ▼
│ Connections │ │Queue│ ProtocolSupport │ Connections │ │Queue│ ProtocolSupport
├─────────────┤ ├─────┤ (http/1.1) ├─────────────┤ ├─────┤ (http/1.1, h2)
│ ... │ │ ... │ │ ... │ │ ... │
│ ... │ │ ... │ │ ... │ │ ... │
│ ... │ │ ... │ │ ... │ │ ... │
│ ... │ │ ... │ │ ... │ │ ... │
└─────────────┘ └─────┘ └─────────────┘ └─────┘
*/
/// <summary>
/// The <see cref="HostManager"/> class provides centralized management for <see cref="HostVariant"/> objects associated with HTTP requests and connections.
/// </summary>
/// <remarks>
/// <para>
/// The <see cref="HostManager"/> class acts as a central registry for managing <see cref="HostVariant"/> objects, each associated with a unique <see cref="HostKey"/>.
/// It facilitates the creation, retrieval, and management of <see cref="HostVariant"/> instances based on HTTP requests and connections.
/// </para>
/// <para>
/// A <see cref="HostVariant"/> represents a specific host and port combination (e.g., "http://example.com:80" or "https://example.com:443") and
/// manages the connections and request queues for that host. The class ensures that a single <see cref="HostVariant"/> instance is used for
/// each unique host, helping optimize resource usage and connection pooling.
/// </para>
/// <para>
/// Key features of the <see cref="HostManager"/> class include:
/// </para>
/// <list type="bullet">
/// <item>
/// <term>Creation and Retrieval</term>
/// <description>
/// The class allows you to create and retrieve <see cref="HostVariant"/> instances based on HTTP requests, connections, or <see cref="HostKey"/>.
/// It ensures that a single <see cref="HostVariant"/> is used for each unique host.
/// </description>
/// </item>
/// <item>
/// <term>Queue Management</term>
/// <description>
/// The <see cref="HostManager"/> manages the queue of pending requests for each <see cref="HostVariant"/>, ensuring efficient request processing.
/// </description>
/// </item>
/// <item>
/// <term>Connection Management</term>
/// <description>
/// The class handles the management of connections associated with <see cref="HostVariant"/> objects, including recycling idle connections,
/// removing idle connections, and shutting down connections when needed.
/// </description>
/// </item>
/// </list>
/// <para>
/// Usage of the <see cref="HostManager"/> class is typically transparent to developers and is handled internally by the Best HTTP library. However,
/// it provides a convenient and efficient way to manage connections and requests when needed.
/// </para>
/// </remarks>
public static class HostManager
{
/// <summary>
/// Dictionary to store <see cref="HostKey"/>-<see cref="HostVariant"/> mappings.
/// </summary>
private static Dictionary<HostKey, HostVariant> hosts = new Dictionary<HostKey, HostVariant>(new HostKeyEqualityComparer());
/// <summary>
/// Gets the <see cref="HostVariant"/> associated with an HTTP request.
/// </summary>
/// <param name="request">The HTTP request.</param>
/// <returns>The <see cref="HostVariant"/> for the request's host.</returns>
public static HostVariant GetHostVariant(HTTPRequest request) => GetHostVariant(request.CurrentHostKey);
/// <summary>
/// Gets the <see cref="HostVariant"/> associated with a connection.
/// </summary>
/// <param name="connection">The HTTP connection.</param>
/// <returns>The <see cref="HostVariant"/> for the connection's host.</returns>
public static HostVariant GetHostVariant(ConnectionBase connection) => GetHostVariant(connection.HostKey);
/// <summary>
/// Gets the <see cref="HostVariant"/> associated with a HostKey.
/// </summary>
/// <param name="key">The HostKey for which to get the HostVariant.</param>
/// <returns>The <see cref="HostVariant"/> for the specified HostKey.</returns>
public static HostVariant GetHostVariant(HostKey key)
{
if (!hosts.TryGetValue(key, out var variant))
{
var settings = HTTPManager.PerHostSettings.Get(key).HostVariantSettings;
variant = settings?.VariantFactory?.Invoke(settings, key) ?? new HostVariant(key);
hosts.Add(key, variant);
HTTPManager.Logger.Information("HostManager", $"Variant added with key: {key}");
}
return variant;
}
/// <summary>
/// Removes all idle connections for all hosts.
/// </summary>
public static void RemoveAllIdleConnections()
{
HTTPManager.Logger.Information("HostManager", "RemoveAllIdleConnections");
foreach (var host in hosts)
host.Value.RemoveAllIdleConnections();
}
/// <summary>
/// Tries to send queued requests for all hosts.
/// </summary>
public static void TryToSendQueuedRequests()
{
foreach (var kvp in hosts)
kvp.Value.TryToSendQueuedRequests();
}
/// <summary>
/// Shuts down all connections for all hosts.
/// </summary>
public static void Shutdown()
{
HTTPManager.Logger.Information("HostManager", "Shutdown()");
foreach (var kvp in hosts)
kvp.Value.Shutdown();
}
/// <summary>
/// Clears all hosts and their associated variants.
/// </summary>
public static void Clear()
{
HTTPManager.Logger.Information("HostManager", "Clearing()");
hosts.Clear();
}
}
}