TaskHub.Shared

Netwoking

TaskHub.Shared.Networking module provides a centralized and declarative approach to configuring HTTP communication between services.

Core Idea

The module addresses common networking concerns in microservice-based systems:

• Consistent HttpClient configuration via dependency injection.
• Controlled timeouts and retries.
• Support for multiple internal and external services.
• Authorization propagation.
• Elimination of duplicated networking logic.

Configuration

Networking configuration is built around two concepts:

• Global defaults: common networking behavior shared across all HTTP clients.
• Network nodes: individual remote services with optional overrides. This allows defining a consistent baseline while still tuning behavior for specific dependencies.

NetworkDefaults

NetworkDefaults define the baseline networking policy applied to all outbound HTTP requests. Use defaults to express system-wide expectations, not service-specific behavior. Options:

• RetryCount: The number of retry attempts performed after the initial request failure.
• RetryDelayInMilliseconds: The base delay (in milliseconds) between retry attempts.
• TimeoutInMilliseconds: The maximum amount of time (in milliseconds) a single HTTP request is allowed to run.
• UserAgent: The User-Agent HTTP header value sent with outgoing requests.
• RetryStrategy: Defines how retry delays are calculated between retry attempts.

Retry Strategies

• Fixed: Uses a constant delay between retries.
• Exponential: Increases the delay between retries after each failed attempt.

NetworkNode

NetworkNode represents an individual remote service with its own configuration. All retry, timeout, user-agent, and retry-strategy properties have the same meaning as in NetworkDefaults and act as per-node overrides. Below are only the properties that do not exist in NetworkDefaults:

• BaseUrl: The base URL of the remote service.

AppSettings Configuration

Networking settings are defined in the appsettings.json file under the Networking section. example:

"Networking": {
    "Defaults": {
      "RetryCount": 3,
      "TimeoutInMilliseconds": 5000,
      "RetryDelayInMilliseconds": 100,
      "RetryStrategy": "Exponential",
      "UserAgent": "TaskHub-Offer"
    },
    "Services": {
      "Google": {
        "BaseUrl": "https://google.com"
      }
    }
  }

Dependency Injection

To use the TaskHub.Shared.Networking module, register it in the dependency injection container:

builder.Services.AddAppNetworkingSettings(Builder.Configuration.GetSection("Networking").Bind);

This registers configured HttpClients for each defined NetworkNode, applying global defaults and per-node overrides.

Usage

Inject IHttpClientFactory into your services to obtain configured HttpClients:

public class MyService(IHttpClientFactory _httpClientFactory)
{
    private readonly HttpClient Client = _httpClientFactory.CreateClient("Google");
}

This site is open source. Improve this page.