SeoPatterns 1.0.1.1

NuGet Package: Business Layer Separation

This library allows you to separate your business layer from your controllers.

1. Create two concrete classes per endpoint in your controller:

• One implementing SeoPatterns.IBizReq<TResponse>
• Another implementing SeoPatterns.IBizHandle<TRequest, TResponse>

2. Register dependencies using the following line:

• builder.Services.AddBizExec(Assembly.GetExecutingAssembly()); with "using SeoPatterns;"
• This will register IBizExec and all your IBizHandle classes.

3. In your controller, inject IBizExec and use it in your endpoint.

• Create an IBizReq instance by passing all required inputs.
• Call IBizExec.Process(IBizReq).
• This will invoke the corresponding business layer (IBizHandle).

4. Use one BusinessHandler per endpoint.

• Consider adding a "Features" folder.
• Inside this folder, create a subfolder for each endpoint, containing its IBizReq and IBizHandle.
• This makes it easier to manage your business logic.

Many developers create a single large business or service layer that handles logic for all endpoints, which can be difficult to maintain and violates the Single Responsibility Principle. This approach keeps your code modular and maintainable.

=============================================================================

In your Program.cs or StartUp.cs where you register all your dependencies

using SeoPatterns;

builder.Services.AddBizExec(Assembly.GetExecutingAssembly());

=============================================================================

using SeoPatterns;

public class TestController : ControllerBase
{
        private readonly IBizExec _exec;

        public TestController(IBizExec exec)
        {
            _exec = exec;
        }

        [HttpPost()]
        public async Task<ActionResult> Sample([FromBody] SampleInput input)
        {
            if (request == null) return BadRequest("Invalid data");

            var result = await _exec.Process(new SampleBusinessRequest(input));

            return result.Success ? Ok() : StatusCode(result.StatusCode, result);
        }
}

=============================================================================

using SeoPatterns;

/// <summary>
/// The generic type 'TResponse' represents the return type of IBizHandle. You can use any object type you need (e.g., ServiceResult).
/// You can create as many properties as required.
/// The goal is to pass the input object from the controller endpoint through the constructor of this class and assign it to the internal properties.
/// These inputs will then be exposed to IBizHandle, where your business logic will be applied.
/// </summary>
public class SampleBusinessRequest : IBizReq<ServiceResult>
{
    public SampleInput SampleInput { get; set; }

    public SampleBusinessRequest(SampleInput input)
    {
        SampleInput = input;
    }
}

=============================================================================

using SeoPatterns;

/// <summary>
/// The IBizHandle<TRequest, TResponse> interface represents the business layer.
/// The input objects from the controller are exposed through the 'request' object.
/// </summary>
public class SampleBusinessHandler : IBizHandle<SampleBusinessRequest, ServiceResult>
{
    public async Task<ServiceResult> Process(SampleBusinessRequest request, CancellationToken cancellationToken)
    {
        // Your business logic

        return ServiceResult.Ok();
    }
}