SW.HttpExtensions

A lightweight .NET library that provides useful extensions for HTTP operations, including JSON serialization/deserialization, HTTP client factory helpers, and API client abstractions.

Features

• HttpContent Extensions: Easy JSON deserialization from HTTP responses
• HttpClient Extensions: Simplified HTTP operations with automatic JSON serialization
• HttpClientFactory Extensions: Streamlined client creation with authentication and base address setup
• API Client Framework: Base classes and builders for creating structured API clients
• JWT Token Support: Built-in JWT authentication helpers
• Service Collection Extensions: Easy dependency injection setup

Installation

Install via NuGet Package Manager:

dotnet add package SimplyWorks.HttpExtensions

Or via Package Manager Console:

Install-Package SimplyWorks.HttpExtensions

Quick Start

HttpContent Extensions

using SW.HttpExtensions; // Deserialize JSON response to strongly typed object var response = await httpClient.GetAsync("api/users"); var users = await response.Content.ReadAsAsync<List<User>>();

HttpClient Extensions

using SW.HttpExtensions; // POST with automatic JSON serialization var user = new User { Name = "John", Email = "john@example.com" }; var response = await httpClient.PostAsync("api/users", user); // POST with automatic deserialization var createdUser = await httpClient.PostAsync<User>("api/users", user); // GET with automatic deserialization var users = await httpClient.GetAsync<List<User>>("api/users"); // PUT with automatic JSON serialization await httpClient.PutAsync("api/users/1", user);

HttpClientFactory Extensions

using SW.HttpExtensions; // Create client with base address and JWT authentication var client = httpClientFactory.CreateClient( new Uri("https://api.example.com"), jwt: "your-jwt-token" );

Service Collection Extensions

using SW.HttpExtensions; // Add JWT token parameters from configuration services.AddJwtTokenParameters(options => { // Configure JWT options }); // Add API client with options services.AddApiClient<IUserApi, UserApiClient, UserApiMock, UserApiOptions>(options => { options.BaseUrl = "https://api.example.com"; options.Mock = false; });

Dependencies

• .NET 8.0
• Microsoft.AspNetCore.Http.Abstractions (≥2.3.0)
• Microsoft.Extensions.Configuration.Binder (≥8.0.2)
• Microsoft.Extensions.Http (≥8.0.1)
• Newtonsoft.Json (≥13.0.3)
• SimplyWorks.PrimitiveTypes (≥8.0.0)
• System.IdentityModel.Tokens.Jwt (≥8.3.1)

License

This project is licensed under the MIT License - see the LICENSE for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

If you encounter any bugs or have feature requests, please submit an issue.