EfCore.GenericBizRunner 2.0.1

There is a newer version of this package available.
See the version list below for details.
dotnet add package EfCore.GenericBizRunner --version 2.0.1
NuGet\Install-Package EfCore.GenericBizRunner -Version 2.0.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="EfCore.GenericBizRunner" Version="2.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add EfCore.GenericBizRunner --version 2.0.1
#r "nuget: EfCore.GenericBizRunner, 2.0.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install EfCore.GenericBizRunner as a Cake Addin
#addin nuget:?package=EfCore.GenericBizRunner&version=2.0.1

// Install EfCore.GenericBizRunner as a Cake Tool
#tool nuget:?package=EfCore.GenericBizRunner&version=2.0.1

EfCore.GenericBizRunner

EfCore.GenericBizRunner (shorteded to GenericBizRunner) is a framework to help build and run business logic when you are using Entity Framework Core for database accesses. Its aim is to totally isolate the business logic from other parts of the application, especially the user presentation/UI layers.

EfCore.GenericBizRunner is available as a NuGet package, and on the EfCore.GenericBizRunner GitHub repo. It is an open-source project under the MIT licence.

It provides the following features:

  • A standard pattern for writing business logic, including helper classes.
  • An anti-corruption layer feature that act as a barrier between the business logic and the user presentation/UI layers.
  • The BizRunner handles the call to EF Core's SaveChanges, with optional validation.
  • A service, known as a BizRunner, that runs your business logic.
  • Very good use of Dependency Injection (DI), making calls to business logic very easy.

The article A library to run your business logic when using Entity Framework Core gives a good overview about the library, and there is there is good documentation in the project's Wiki. Alos, this project contains a runnable ASP.NET Core application with two business logic examples in it.

Why did I write this library?

I have built quite a few applications that contain business logic, some of it quite complex - things like optimisiers and pricing engines to name but a few. Business logic can be a real challenge, and over the years I have perfected a architecture pattern that isolates the business logic so its easier to write and manage - see this article and chapter 4 of my book, Entity Framework in Action.

Having perfected my pattern for handling business logic, then the next step was to automate the common parts of the pattern into a library. Which is where the EfCore.GenericBizRunner library came from.

More information on the business logic pattern and library

The following links start with general descriptions and get deeper towards the end.

  • This article, which describes my business pattern.
  • Chapter 4 of my book, which covers building of business logic using this pattern.
  • This article that describes the EfCore.GenericBizAction library with examples.
  • Project's Wiki, which has a quick start guide and deeper documentation.
  • Clone this repo, and run the ASP.NET Core application in it to see the business logic in action.
  • Read the example code, in this repo.
Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on EfCore.GenericBizRunner:

Package Downloads
EfCore.GenericServices.AspNetCore

A support library to the EfCore.GenericServices and EfCore.GenericBizRunner libraries. It converts IStatusGeneric into ASP.NET Core's ModelState or Web API response

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
4.1.0 44,482 1/25/2020
4.0.0 4,530 10/12/2019
3.0.0 19,787 1/21/2019
2.0.2 2,458 8/22/2018
2.0.1 19,484 7/29/2018
2.0.0 1,980 7/14/2018
1.1.0 1,468 6/7/2018
1.0.1 1,758 2/10/2018
1.0.0 1,580 1/19/2018

- Bug Fix: Fixed a error in StatusGenericHandler where `CombineErrors` didn't copy over the `Message` properly