hlaueriksson / commandquery Goto Github PK

View Code? Open in Web Editor NEW

105.0 13.0 17.0 3.1 MB

Command Query Separation for 🌐ASP.NET Core ⚡AWS Lambda ⚡Azure Functions ⚡Google Cloud Functions

License: MIT License

C# 99.56% Batchfile 0.44%

cqs command-query dotnet csharp asp-net-core aws-lambda azure-functions google-cloud-functions

commandquery's Introduction

CommandQuery

Introduction

Command Query Separation (CQS) for .NET and C#

Build services that separate the responsibility of commands and queries
Focus on implementing the handlers for commands and queries
Create APIs with less boilerplate code

Available for:

🌐 ASP.NET Core
⚡ AWS Lambda
⚡ Azure Functions
⚡ Google Cloud Functions

Command Query Separation?

Queries: Return a result and do not change the observable state of the system (are free of side effects).

Commands: Change the state of a system but do not return a value.

— Martin Fowler

In other words:

Commands
- Writes (create, update, delete) data
Queries
- Reads and returns data

The traditional approach that commands do not return a value is a bit inconvenient.

CommandQuery has a pragmatic take and supports both commands with and without result 👍

Packages

`CommandQuery` ⚙️

Command Query Separation for .NET

📃 README: CommandQuery.md
💁 Samples:
- CommandQuery.Sample.Contracts
- CommandQuery.Sample.Handlers

`CommandQuery.AspNetCore` 🌐

Command Query Separation for ASP.NET Core

📃 README: CommandQuery.AspNetCore.md
💁 Samples:
- CommandQuery.Sample.AspNetCore
- CommandQuery.Sample.AspNetCore.Tests

`CommandQuery.AWSLambda` ⚡

Command Query Separation for AWS Lambda

📃 README: CommandQuery.AWSLambda.md
💁 Samples:
- CommandQuery.Sample.AWSLambda
- CommandQuery.Sample.AWSLambda.Tests

`CommandQuery.AzureFunctions` ⚡

Command Query Separation for Azure Functions

📃 README: CommandQuery.AzureFunctions.md
💁 Samples:
- CommandQuery.Sample.AzureFunctions
- CommandQuery.Sample.AzureFunctions.Tests

`CommandQuery.GoogleCloudFunctions` ⚡

Command Query Separation for Google Cloud Functions

📃 README: CommandQuery.GoogleCloudFunctions.md
💁 Samples:
- CommandQuery.Sample.GoogleCloudFunctions
- CommandQuery.Sample.GoogleCloudFunctions.Tests

`CommandQuery.Client` 🧰

Clients for CommandQuery APIs

📃 README: CommandQuery.Client.md
💁 Samples:
- CommandQuery.Sample.Client

Upgrading

⬆️ Upgrading from version 3.0.0 to 4.0.0

Upgrade AspNetCore:

Upgrade the project target framework to net8.0

Upgrade AWSLambda:

Upgrade the project target framework to net8.0

Upgrade AzureFunctions:

Upgrade the project target framework to net8.0
Remove the logger argument from HandleAsync
Consider to use the HttpRequest versions of HandleAsync

Upgrade GoogleCloudFunctions:

Upgrade the project target framework to net8.0
Remove the logger argument from HandleAsync

Acknowledgements

Inspired by Steven van Deursen blog posts:

commandquery's People

Contributors

Stargazers

Watchers

Forkers

commerceintegration adeelrazzaq nanofabricfx thomascayne pro-coded-external linkingas marciogoularte wkrea fabbbiob bubdm kraneesh thejonrutherford advsalahuddinahmed011 gtechsltn fredatgithub fullstackinfo joaofranco91

commandquery's Issues

Command functionality

Hi, I have got acquainted with your source code and it is excellent and easy to use library. But for now, there is no opportunity to return result from command. Is it in plat to implement this functionality or no?

Register ICommandProcessor in .net core DI

I am having an issue to register ICommandProcessor in WorkerProcess .net core DI

stack trace:
System.AggregateException: Some services are not able to be constructed (Error while validating the service descriptor 'ServiceType: CommandQuery.ICommandProcessor Lifetime: Transient ImplementationType: CommandQuery.CommandProcessor': Unable to resolve service for type 'CommandQuery.ICommandTypeCollection' while attempting to activate 'CommandQuery.CommandProcessor'.)
---> System.InvalidOperationException: Error while validating the service descriptor 'ServiceType: CommandQuery.ICommandProcessor Lifetime: Transient ImplementationType: CommandQuery.CommandProcessor': Unable to resolve service for type 'CommandQuery.ICommandTypeCollection' while attempting to activate 'CommandQuery.CommandProcessor'.
---> System.InvalidOperationException: Unable to resolve service for type 'CommandQuery.ICommandTypeCollection' while attempting to activate 'CommandQuery.CommandProcessor'.
at Microsoft.Extensions.DependencyInjection.ServiceLookup.CallSiteFactory.CreateArgumentCallSites(Type serviceType, Type implementationType, CallSiteChain callSiteChain, ParameterInfo[] parameters, Boolean throwIfCallSiteNotFound)
at Microsoft.Extensions.DependencyInjection.ServiceLookup.CallSiteFactory.CreateConstructorCallSite(ResultCache lifetime, Type serviceType, Type implementationType, CallSiteChain callSiteChain)
at Microsoft.Extensions.DependencyInjection.ServiceLookup.CallSiteFactory.TryCreateExact(ServiceDescriptor descriptor, Type serviceType, CallSiteChain callSiteChain, Int32 slot)
at Microsoft.Extensions.DependencyInjection.ServiceLookup.CallSiteFactory.GetCallSite(ServiceDescriptor serviceDescriptor, CallSiteChain callSiteChain)
at Microsoft.Extensions.DependencyInjection.ServiceLookup.ServiceProviderEngine.ValidateService(ServiceDescriptor descriptor)
--- End of inner exception stack trace ---
at Microsoft.Extensions.DependencyInjection.ServiceLookup.ServiceProviderEngine.ValidateService(ServiceDescriptor descriptor)
at Microsoft.Extensions.DependencyInjection.ServiceProvider..ctor(IEnumerable1 serviceDescriptors, ServiceProviderOptions options) --- End of inner exception stack trace --- at Microsoft.Extensions.DependencyInjection.ServiceProvider..ctor(IEnumerable1 serviceDescriptors, ServiceProviderOptions options)
at Microsoft.Extensions.DependencyInjection.ServiceCollectionContainerBuilderExtensions.BuildServiceProvider(IServiceCollection services, ServiceProviderOptions options)
at Microsoft.Extensions.DependencyInjection.DefaultServiceProviderFactory.CreateServiceProvider(IServiceCollection containerBuilder)
at Microsoft.Extensions.Hosting.Internal.ServiceFactoryAdapter`1.CreateServiceProvider(Object containerBuilder)
at Microsoft.Extensions.Hosting.HostBuilder.CreateServiceProvider()
at Microsoft.Extensions.Hosting.HostBuilder.Build()
at WorkerWithCommandProcessor.Program.Main(String[] args) in C:\Users\atran1\source\repos\WorkerWithCommandProcessor\WorkerWithCommandProcessor\Program.cs:line 15

How to reproduce:
fetch repo https://github.com/TNMephaGroup/WorkerWithCommandProcessor
run the solution

hlaueriksson / commandquery Goto Github PK

commandquery's Introduction

CommandQuery

Content

Introduction

Packages

CommandQuery ⚙️

CommandQuery.AspNetCore 🌐

CommandQuery.AWSLambda ⚡

CommandQuery.AzureFunctions ⚡

CommandQuery.GoogleCloudFunctions ⚡

CommandQuery.Client 🧰