Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/newky2k/portablewebclient
Cross platform web client framework for calling ASP.NET Core RESTful Web Apis and Grpc services
https://github.com/newky2k/portablewebclient
asp-net-core csharp dotnet-core grpc netcore rest-api restful
Last synced: 8 days ago
JSON representation
Cross platform web client framework for calling ASP.NET Core RESTful Web Apis and Grpc services
- Host: GitHub
- URL: https://github.com/newky2k/portablewebclient
- Owner: newky2k
- License: mit
- Created: 2019-06-25T14:40:13.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-11-19T21:15:02.000Z (about 2 months ago)
- Last Synced: 2025-01-01T20:13:21.766Z (8 days ago)
- Topics: asp-net-core, csharp, dotnet-core, grpc, netcore, rest-api, restful
- Language: C#
- Homepage:
- Size: 201 KB
- Stars: 5
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Portable Web Client
Cross platform web client framework for calling ASP.NET Core RESTful Web Apis and gRPC services
## Functionality
The libary provides low level, bootstrapped base classes to simplify the building of client libraries for use with ASP.NET Core Web Apis and now gRPC services too.
- Base web service client classes for RESTful Web APIs and gRPC service clients
- Core Web Client functionality
- Stores Url
- Can check for connectivity
- Stores Default Timeout
- Supports gRPC fpr Web
- Base service client classes for both RESTFul and Grpc services
- Handles RestClient and Grpc channel management functionality
- Helper methods for Get and Post method calls
- Simplifies calls to the services
- Base request and response classes
- Generic methods and extensions for calling RESTful Web APIs
- Secure request and response classes using a `SecurePayload`
- Integrated encryption, with abiltiy provide override with custom implementations.
- Uses 256-bit AES encryption by default
## V3.x and v3.1 breaking changes
With the move to v3 some of the classes have been renamed and moved into different packages, such as `ServiceClientBase` which now exists in `DSoft.Portable.WebClient.Rest` and is now named `RestServiceClientBase`.
### Encryption changes
**v3.0 only!**
You know have to set an InitVector key of your own on `EncryptionProviderFactory` before encrption and decryption will function.
**v3.1 and Above**
In v3.1 and above the InitVector key is passed explicilty to the `IEncryptionProvider` implementation when returned by `EncryptionProviderFactory.Build`. This allows for calls to multiple services using multiple IVs. Check out the test harness for an example.
## Build status
[](https://dev.azure.com/humbatt/Daves%20Projects/_build/latest?definitionId=49&branchName=master)
## Packages
Platform/Feature | Package name | Stable | Beta
-----------------------|-------------------------------------------|------------------------------------------------|----------------
Core | `DSoft.Portable.WebClient.Core` | [](https://www.nuget.org/packages/DSoft.Portable.WebClient.Core/) | [](https://www.nuget.org/packages/DSoft.Portable.WebClient.Core/) |
Encryption | `DSoft.Portable.WebClient.Encryption` | [](https://www.nuget.org/packages/DSoft.Portable.WebClient.Encryption/) | [](https://www.nuget.org/packages/DSoft.Portable.WebClient.Encryption/) |
Grpc | `DSoft.Portable.WebClient.Grpc` | [](https://www.nuget.org/packages/DSoft.Portable.WebClient.Grpc/) |[](https://www.nuget.org/packages/DSoft.Portable.WebClient.Grpc/) |
Grpc Encryption | `DSoft.Portable.WebClient.Grpc.Encryption` | [](https://www.nuget.org/packages/DSoft.Portable.WebClient.Grpc.Encryption/) | [](https://www.nuget.org/packages/DSoft.Portable.WebClient.Grpc.Encryption/) |
Grpc Encryption Build Tools | `DSoft.Portable.WebClient.Grpc.Encryption.Tools` | [](https://www.nuget.org/packages/DSoft.Portable.WebClient.Grpc.Encryption.Tools/) | [](https://www.nuget.org/packages/DSoft.Portable.WebClient.Grpc.Encryption.Tools/) |
Rest | `DSoft.Portable.WebClient.Rest` | [](https://www.nuget.org/packages/DSoft.Portable.WebClient.Rest/) | [](https://www.nuget.org/packages/DSoft.Portable.WebClient.Rest/) |
Rest Encryption | `DSoft.Portable.WebClient.Rest.Encryption` | [](https://www.nuget.org/packages/DSoft.Portable.WebClient.Rest.Encryption/) | [](https://www.nuget.org/packages/DSoft.Portable.WebClient.Rest.Encryption/) |
Rest Extensions | `DSoft.Portable.WebClient.Rest.Extensions` | [](https://www.nuget.org/packages/DSoft.Portable.WebClient.Rest.Extensions/) | [](https://www.nuget.org/packages/DSoft.Portable.WebClient.Rest.Extensions/) |
EF Core Security Entities | `DSoft.Portable.Server.Security.Core` | [](https://www.nuget.org/packages/DSoft.Portable.Server.Security.Core/) | [](https://www.nuget.org/packages/DSoft.Portable.Server.Security.Core/) |
EF Core Secure Database contexts | `DSoft.Portable.EntityFrameworkCore.Security` | [](https://www.nuget.org/packages/DSoft.Portable.EntityFrameworkCore.Security/) | [](https://www.nuget.org/packages/DSoft.Portable.EntityFrameworkCore.Security/) |
## Version History (from 4.0)
- Version 4.1.0
- Updtated to the latest packages
- Version 4.0.0
- Added support for .NET 8.0
- Removed EF Core libraries
- Updated to last RestSharp
- Improved support for Dependency Injecting `GrpcClientOptions`
- Added custom HttpHandler to `GrpcClientOptions`
- Cleaned up `GrpcChannelManager` code and add support for the custom HttpHandler in `GrpcClientOptions`
- This works great for Testing you Grpc Services with WebApplicationFactory
- Updated `AesEncryptionProvider` to use Aes.Create
- Added Unit Test sample