Apps.Contextsphere 1.3.4

Overview

Contextsphere facilitates clean separation of concerns by encapsulating app's functionalities in each its own context.

This design pattern is primarily aimed at front-end development usage. Whence a developer can write code in CQRS-oriented fashion without the bulk of using message buses/hubs.

Usage

Build your app's contexts in the root node class of your choice.

    public class MyRootNode : IRootNode, IHandle<MyHandledObject1>, IHandleAsync<MyHandledAsyncObject1> ...  
    {  
        ...
    }

In the root node's constructor:

    public MyRootNode(IContext context, IRootNodeObject rootNodeObject, IChildNode1Object childNode1Object, IChildNode2Object childNode2Object ...)
    {
        // 01.  core app context
         var rootContext = context.CreateContext(this, ContextType.Permanent);
    
        // 02.  first child context
        rootContext.CreateContext(new MyChildNode1(childNode1Object), ContextType.Permanent)
    
        // 03.  second child context (subsequent creation can be chained)
        .CreateContext(new MyChildNode2(childNode2Object), ContextType.Permanent)
    
        ...
        
        this.Context = rootContext;
    }

In the consuming classes, use dependency injection to access instance of IRootNode.

private readonly IRootNode root;

...

// send calls thru the root node.
MyObject? result1 = root.Context.Handle<MyObject>();
MyObject? result2 = await root.Context.HandleAsync<MyObject>();
MyObject? result3 = root.Context.Handle<MyParam, MyObject>(myParamInstance);
MyObject? result4 = await root.Context.HandleAsync<MyParam, MyObject>(myParamInstance);

// void or Task
root.Context.Handle<MyObject>(myObjectInstance);
await root.Context.HandleAsync<MyObject>(myObjectInstance);

// validation
bool isValid = root.Context.Validate<MyObject>(myObjectInstance);  
bool isValid = await root.Context.ValidateAsync<MyObject>(myObjectInstance);  
IValidationDetail<MyObject> validationDetails1 = root.Context.ValidateDetailed<MyObject>(myObjectInstance);  
IValidationDetail<MyObject> validationDetails2 = await root.Context.ValidateDetailedAsync<MyObject>(myObjectInstance);  

Context node classes provides the handling logic

public class MyContextNode1 : IHandleNoParamAsync<IEnumerable<MyObject>>, ...
{
    public async Task<IEnumerable<MyObject>?> HandleAsync()
    {
        ...
    }
}  

Concerns/Feedbacks?

You may reach me thru jakes_parane@hotmail.ph. Happy coding!