HAKOM.Http.Core.Net.Api Namespace
Contains the public API surface for building and configuring HAKOM HTTP services.
Remarks
Section titled “Remarks”The central type in this namespace is Service, an abstract base class that orchestrates Kestrel configuration, dependency injection, logging, compression, CORS, proxy header forwarding and SSL certificate loading. Derive from it to create a new HTTP service with minimal boiler-plate.
For services that require strongly-typed settings read from configuration, use the generic Service<TSettingsClass,TSettingsInterface> variant instead.
Settings interfaces such as IHostingSettings, ICorsSettings,
ICompressionSettings and IProxySettings define the configuration
model and expose static TryRead factory methods together with sensible Defaults.
IServiceInformation provides metadata (title and description) about the running service, typically sourced from the hosting assembly’s attributes.
IConfigurationSection section = configuration.GetSection("MyService:Http:Hosting");IHostingSettings settings = IHostingSettings.TryRead(section).GetValueOrThrow();| Classes | |
|---|---|
| Service | Base class for HTTP services. |
| Service<TSettingsClass,TSettingsInterface> | Base class for HAKOM HTTP services that require strongly-typed settings bound from configuration. |
| Interfaces | |
|---|---|
| ICompressionSettings | Defines settings that control HTTP request decompression and response compression for the service. |
| ICorsSettings | Defines Cross-Origin Resource Sharing (CORS) settings for an HTTP service. |
| IDefaultAcceptHeader | Provides the default Accept media type that should be applied to requests that arrive without one (or with an empty or whitespace-only Accept header). |
| IHealthCheckSettings | Settings that control health check behavior of the service. As for now, these settings only contain ShutdownTimeout, which is used to configure the GracefulShutdown. |
| IHostingSettings | Aggregates all hosting-related settings for an HTTP service including URLs, proxy, CORS and compression configuration. |
| IProxySettings | Defines settings for operating an HTTP service behind a reverse proxy. |
| IServiceInformation | Describes an HTTP API. |