👁 Image
CasCap.Common.Net 4.12.1

CasCap.Common.Net

Abstract base class, extensions, and authentication handlers for building typed HttpClient wrappers and securing ASP.NET Core APIs.

Installation

dotnet add package CasCap.Common.Net

Purpose

Provides HttpClientBase, an abstract class giving derived HTTP clients a consistent surface for GET, POST, PUT, and DELETE operations with automatic JSON (de)serialization. Network-related extension methods for headers and query strings are also included. Additionally provides BasicAuthenticationHandler for HTTP Basic authentication against ApiAuthConfig. The HttpClientBase and BasicAuthenticationHandler implementations are gated behind #if NET8_0_OR_GREATER.

Target frameworks: netstandard2.0, net8.0, net9.0, net10.0

Services

Authentication

HTTP Auditing

Extensions

Class Hierarchy

Abstract base class pattern for typed HTTP clients:

classDiagram
 direction TB

 HttpClientBase <|-- YourCustomClient
 HttpClientBase <|-- AnotherApiClient

 class HttpClientBase {
 <<abstract>>
 #HttpClient HttpClient
 #ILogger Logger
 +PostJsonAsync~T~(uri, body) Task~T~
 +PostBytesAsync(uri, bytes) Task~HttpResponseMessage~
 +GetAsync~T~(uri) Task~T~
 +PutAsync~T~(uri, body) Task~T~
 +DeleteAsync(uri) Task~HttpResponseMessage~
 #HandleError(response) void
 }

 class YourCustomClient {
 +GetUsers() Task~User[]~
 +CreateUser(user) Task~User~
 +UpdateUser(id, user) Task~User~
 +DeleteUser(id) Task
 }

 class AnotherApiClient {
 +GetData() Task~Data~
 +PostData(data) Task~Result~
 }

 HttpClientBase ..> ILogger : uses
 HttpClientBase ..> HttpClient : uses

Usage Pattern:

1. Inherit from HttpClientBase
2. Inject HttpClient and ILogger via constructor
3. Use built-in methods (GetAsync, PostJsonAsync, etc.) for API calls
4. Override HandleError for custom error handling

Dependencies

NuGet Packages

Project References