Passby.Microservice.Template 1.0.6

#Usage of the template

###Enable Some Features

1. Swagger

services.AddSwaggerSupport();
app.UseSwaggerSupport();

2. Health Check with /ready path

services.AddHealthCheckSupport();
app.UseHealthCheckSupport();

3. XRay Tracing

services.AddXRayHttpTracingSupport();
app.UseXrayTracingSupport(env);

4. Amazon Services

services.AddAwsServicesSupport();

###CommandBus and EventBus To enable AWS Command and AWS Event bus use the following:

1. In Startup.cs

services.AddAwsEventBus();
services.AddAwsCommandBus();
services.AddAwsConfiguration(Configuration);

2. In appsettings.json

"EventsConfiguration": {
     "Events": [
       {
         "EventName": "EventReceived",
         "TopicArn": "arn:aws:sns:region:accountnumber:EventReceived",
         "QueueArn": "https://region.amazonaws.com/accountnumber/EventReceived"
       }
     ]

3. Send command, Use the following dependency in the controller to be injected, the publish command will return an object with status and exception if any:

private readonly ICommandBus _commandBus;

PublishEventResponse response=await _commandBus.Publish(new EventReceived
            {
                Rank = id
            });

4. Handle Event

Declare your event and the handler:

 public class EventReceived:IntegrationEvent
 {
        public int Rank { get; set; }
 }

 public class EventReceivedHandler : IIntegrationEventHandler<EventReceived>
 {
        private readonly ILogger<EventReceivedHandler> _logger;

        public EventReceivedHandler(ILogger<EventReceivedHandler> logger)
        {
            _logger = logger;
        }
        public Task Handle(EventReceived @event)
        {
            _logger.LogInformation($"Message Received with --> {@event.Rank}");
            return Task.CompletedTask;
        }
 }

Register the Event and Handler in Startup with some helper methods:

 public void ConfigureServices(IServiceCollection services)
 {            
    services.AddEventHandler<EventReceived,EventReceivedHandler>();            
 }
 
 public void Configure(IApplicationBuilder app, IHostingEnvironment env)
 {
    app.UseEventSubscription<EventReceived, EventReceivedHandler>();
 }      

###Enable XRay with HttpClient To register the Service2Provider with Injected HttpClient that supports XRay TRacing, in Startup.cs

services.AddHttpClient<IService2Provider, Service2Provider>(client =>
        {
           client.BaseAddress = new Uri("http://service2.internal");
        }).AddHttpMessageHandler<HttpClientXRayTracingHandler>();

###Base Api Controller

###Domain Driven Design

####Aggregate Root

####Wrappers

Event Sourcing