Apps.Contextsphere 8.0.1

Overview

Contextsphere provides a lightweight substitute for message bus/hub functionality that is intended for front-end development use.

IMPORTANT: Versions 8.0.1 or higher are not compatible with previous ones.

Usage

Register a singleton IContext in the app's DI container.

    ...

    builder.Services.AddSingleton<IContext, Context>();

    ...

The same IContext instance can then be injected anywhere needed:

    public class MyNode1 : IHandle<MyItem1, MyResult1, MyParameter1>, ...
    {
        ...

        public MyNode1(IContext context, ...)
        {
            // include this node in the message loop
            context.Include(this);
            ...
        }

        ...

        public MyResult1? Handle(MyItem1 item, MyParameter1 param)
        {
            ...

            // dispatch an item like so;
            context.Dispatch<MyItemX>(itemX); 

            // or;
            var resultY = context.Dispatch<MyItemY, MyResultY>(itemY); 

            // or;
            var resultZ = context.Dispatch<MyItemZ, MyResultZ, MyParamZ>(itemZ, paramZ); 

            ...
        }
    }

Apply [ContextNode] attribute to a class for another way to include it in the messaging context.

    [ContextNode]
    public class MyNode2 : IHandleAsync<MyItem2, MyResult2, MyParameter2>, ...
    {
        // inject IF NEEDED
        // private readonly IServiceProvider serviceProvider;


        public async Task<Result<MyResult2>> HandleAsync(MyItem2 item, MyParameter2 param, CancellationToken token)
        {
            ...

            // IF NEEDED, get the IContext instance in the IServiceProvider,
            var context = serviceProvider.GetService<IContext>() ?? throw new NullReferenceException();

            // so you can dispatch an item and await for result like so;
            var resultX = await context.DispatchAsync<MyItemX, MyResultX>(itemX, token).ConfigureAwait(false);

            // or;
            var resultY = await context.DispatchAsync<MyItemY, MyResultY, MyParamY>(itemY, paramY, token).ConfigureAwait(false);

            ...
        }
    }

Concerns/Feedbacks?

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