TaskHub.Shared

TaskHub.Shared.Refactoring

TaskHub.Shared.Refactoring is an internal infrastructure module that provides a lightweight reflection-based approach for resolving and registering dependencies, as well as collecting basic service metadata. This module is intentionally opinionated, minimal, and non-universal.

Core Idea

The module solves a narrow set of problems:

• Reduce repetitive dependency registration code.
• Centralize interface-to-implementation resolution.
• Provide a single, consistent ServiceInfo source.
• Enable controlled assembly scanning with explicit opt-out. It is not intended to be a general-purpose DI container or replacement for existing frameworks.

Assembly Scanning

The module scans application assemblies to discover user-defined interfaces and their concrete implementations. System and vendor assemblies are excluded by default to:

• Reduce startup cost.
• Avoid accidental bindings.
• Improve determinism. Assembly scanning is performed once per application lifetime at startup.

Dependency Resolution

The module supports two explicit dependency resolution modes. The chosen mode is defined by the bootstrap call site, not by the module itself.

Single Implementation Resolution

services.AddAppDependency<T>();

This call scans assemblies for interface T and its single implementation, registering the pair in the DI container. Use this method when:

• The abstraction is expected to have a single concrete implementation.
• Multiple implementations represent an architectural error.
• Deterministic resolution is required. If no implementation is found, or resolution is ambiguous, the application is expected to fail during startup.

Multiple Implementations Resolution

services.AddAppDependencies<T>();

Resolves and registers all matching implementations, registering them in the DI container. Use this method when multiple implementations are expected and valid.

ServiceInfo

A centralized service information provider. Contains metadata from the entry assembly and the current runtime environment. Options:

• Name: The name of the service, derived from the entry assembly. If unavailable, falls back to AppDomain.CurrentDomain.FriendlyName.
• Version: Read from AssemblyInformationalVersionAttribute. If missing, falls back to the assembly version. If both are unavailable, uses unknown.
• VersionDotNet: The version of the .NET runtime the application is running on. Taken from Environment.Version.

Registration

The constructed ServiceInfo instance is registered as a singleton in IServiceCollection.

services.AddServiceInfo();

This site is open source. Improve this page.