• Tips
• MVC
• Web Api
  • Get Files from WebApi
    • Testing Links
    • References
  • Self Host WebApi
    • Notes
    • Nugets
    • Testing links
    • References
• Microservices - Shopping Cart
  • Notes
  • Steps
  • Nuget packages
  • Docker images
  • References

1. Right-click and select Markup TOC Insert/update. Delete and update it
2. Each First heading is a solution

• https://localhost:44307/ebook/doc
• https://localhost:44307/ebook/pdf
• https://localhost:44307/ebook/excel
• https://localhost:44307/ebook/zip

1. https://www.c-sharpcorner.com/article/sending-files-from-web-api/

Hsoting a WebAPI project in a console application

• Create a console application
• Install the nuget package
• Create Controller and Model classes
• Configure self host in program.cs
• Write Console application to get data from the WebAPI

• Microsoft.AspNet.WebApi.SelfHost --> Web API
• Microsoft.AspNet.WebApi.Client --> Client

• http://localhost:8080/api/book?author=aroan
• http://localhost:8080/api/book/1
• http://localhost:8080/api/book

1. https://www.c-sharpcorner.com/UploadFile/a6fd36/understand-self-host-of-a-web-apiC-Sharp/
2. https://www.c-sharpcorner.com/uploadfile/a6fd36/understanding-how-to-call-the-web-api-from-a-client-applica/

• The different layers are
  • API / Application / Presentation Layer
    • Entry point into the application
    • Exposes endpoints / UI and enforces validation
    • No Business Logic
  • Domain Model Layer
    • Heart of the software
    • Contains Business rules, logic and operations
  • Infrastructure Layer
    • Provides infrastructure plumbing
    • Primary responsibility is persistence of business state
• ProducesResponseType → used as an attribute which is used in documentation like swagger providing information like response http status code and the return object.

  [ProducesResponseType((int)HttpStatusCode.NotFound)]
  [ProducesResponseType(typeof(Product), (int)HttpStatusCode.OK)]

• depends_on in docker file does not make sure that the dependant container is running properly. It just ensures that the dependant containers are started first.
• Use mongoclient docker image to view the mongo data in GUI

  docker run -d -p 3000:3000 mongoclient/mongoclient

• Redis → REmote DIctionary Server
• The below command is used to connect to redis in the bash

  redis-cli

• Command Redis command

  ping
  set
  get

• Docker commands

  docker exec -it shoppingcart-redis /bin/bash

• Portainer is a container management tool.
  • credentials: admin/password
• pgadmin is used for postgresql administration.
  • credentials: [email protected]/password
• gRPC → Google Remote Procedure Call
• gRPc uses HTTP/2 protocol and it is non-browser at the moment.
• DDD has the below layers
  • Domain Model Layer
    • Ideally, it must NOT take dependency on any other layer
    • it Implements
      • Domain Entities
      • Repository Interfaces
  • Application Layer
    • Depends on Domain Layer for Domain entities and repository interfaces
    • Depends on Infrastructure layer thru DI
  • Infrastructure Layer
    • Depends on Domain Layer for domain entities
    • Direct dependency on infrastructure frameworks like EF core or any other database, cache or infrastructure API
• Qualities for Clean Architecture
  • Framework independence
  • Testability
  • UI Independence
  • Database Independence
  • External Agency Independence
• CQRS → Command Query Responsibility Segregation
• New learning of mapper method

  _mapper.Map(request, orderToUpdate, typeof(UpdateOrderCommand), typeof(Order));

• Configure to a particular config section

  services.Configure<EmailSettings>(c => configuration.GetSection("EmailSettings"));

• GetService() returns null if a service does not exist, GetRequiredService() throws an exception instead. If you're using a third-party container, use GetRequiredService where possible - in the event of an exception, the third party container may be able to provide diagnostics so you can work out why an expected service wasn't registered.
• Microservices Communication Types
  • Request driven architecture
    • services communicate using http/rpc
    • Clear control of flow. Easy to understand the sequence of actions.
    • Drawback is if one of the dependant service is down, there is a high chance to exclude that call.
  • Event driven architecture
    • Services do not call each other. Communication happens over message broker.
    • Consumers and providers does not know each other. So they can be maintained and deployed independently.
    • Someone should understand without looking thru the code.
  • Hybrid architecture
• Properties of a queue
  • Name
  • Durable
  • Exclusive
  • AutoDelete
• Exchange Types
  • Direct Exchanges
    • Messages are sent to one queue
  • Topic Exchanges
    • Messages are sent to multiple queues
    • variation of publish / subscribe pattern
  • Fanout Exchanges
    • Messages sent to more than one queue
    • For broadcasting
  • Header Exchanges
• Gateway Routing pattern (Ocelot)
  • Routing / Reverse Proxy
  • Data Aggregator / Request Aggregator
  • Protocol Abstraction / Service Discovery with consul & Eureka
  • Centralized Error Management / Logging and Tracing
  • Load Balancing
  • Correlation pass-through
  • Quality of service
  • Authentication
  • Authorization
  • Throttling
  • Headers / Query String Transformation
  • Custom Middleware
• Gateway Aggregation pattern
  • Single Request
  • Multiple calls to different backend systems
  • Dispatches requests to the various backend systems
  • Reduce chattiness between the client and the services
• Chaining HTTP calls is an antipattern

1. Download the code from https://github.com/aspnetrun/run-aspnetcore-microservices
2. Extract and traverse to that path (src folder which has the docker file) in Powershell
3. Run the below command in Powershell to build and run the docker image

   docker-compose -f docker-compose.yml -f docker-compose.override.yml up -d

4. Create a new project Catalog.API with the template ASP.NET Core Web API.
5. Change the running port and url
   • Right-click on the project and go to properties.
   • Go to Debug tab.
   • Select Catalog.API from the profile.
   • Check the app url at the bottom.
   • The new profile gets added in the launchsettings.json in properties folder.
6. Setup Mongo docker database
   • Go to hub.docker.com
   • Search for Mongo official database
   • Right-click the solution and click on Open in Terminal. This will open up the Dveloper Powershell in the visual studio
   • Run the below command to check whether any docker image is present and running

     docker ps

   • Run the below command to pull the docker image

     docker pull mongo

   • Run the below command to run the docker image

     docker run -d -p 27017:27017 --name shopping-mongo mongo

     -d → runs the docker image in detached mode -p {image port in the container}:{forwarding port to the local computer}
   • Run the below command to check the logs

     docker logs -f shopping-mongo

   • Run the below command to get into interactive mode to check the mongo db

     docker exec -it shopping-mongo /bin/bash

     -it → interactive mode /bin/bash → runs bash
     • Run the below command to get the list of databases

       show dbs

     • Run the below command to create the catalog database

       use CatalogDb
       
       db.createCollection('Products')
       
       db.Products.insertMany([{ 'Name':'Asus Laptop','Category':'Computers', 'Summary':'Summary', 'Description':'Description', 'ImageFile':'ImageFile', 'Price':54.93 }, { 'Name':'HP Laptop','Category':'Computers', 'Summary':'Summary', 'Description':'Description', 'ImageFile':'ImageFile', 'Price':88.93 } ])
       
       db.Products.find({}).pretty()
       
       db.Products.remove({})
       
       show databases
       
       show collections
       
       db.Products.find({}).pretty()

7. Install MongoDB.Driver nuget package
8. Create docker compose file
   • Right-click the project
   • Go to Add > Add container Orchestrator support
     • Select Docker compose and click ok
     • Select Target OS as Linux
   • DockerFile will be created in the project
   • Docker compose will be created in the solution level
9. Execute the below command to run the docker container

    docker-compose -f .\docker-compose.yml -f .\docker-compose.override.yml up -d

10. Execute the below command to stop the docker container.

    docker-compose -f .\docker-compose.yml -f .\docker-compose.override.yml down

11. Create a new project Basket.API with the template ASP.NET Core Web API.
12. Change the running port and url
    • Right-click on the project and go to properties.
    • Go to Debug tab.
    • Select Basket.API from the profile.
    • Check the app url at the bottom.
    • The new profile gets added in the launchsettings.json in properties folder.
13. Execute the below command to pull Redis

    docker pull redis

14. Run Redis container using the following command:

    docker run -d -p 6379:6379 --name shoppingcart-redis redis

15. Install the nuget package - Microsoft.Extensions.Caching.StackExchange
16. Install the nuget package - Newtonsoft.Json
17. Create docker compose file
    • Right-click the project
    • Go to Add > Add container Orchestrator support
      • Select Docker compose and click ok
      • Select Target OS as Linux
    • DockerFile will be created in the project
    • Docker compose will be updated
18. Execute the below command to run the docker container

     docker-compose -f .\docker-compose.yml -f .\docker-compose.override.yml up -d

19. Create a new project Discount.API with the template ASP.NET Core Web API.
20. Change the running port and url
    • Right-click on the project and go to properties.
    • Go to Debug tab.
    • Select Discount.API from the profile.
    • Check the app url at the bottom.
    • The new profile gets added in the launchsettings.json in properties folder.
21. Execute the below command to pull postgresql

    docker pull postgres

22. Execute the below command to pull pgadmin

    docker pull dpage/pgadmin4

23. Create coupon table in postgresql database using pgadmin

    CREATE TABLE Coupon(
      ID SERIAL PRIMARY KEY NOT NULL,
      ProductName Varchar(24) NOT NULL,
      Description TEXT,
      Amount INT
    );
    
    INSERT INTO Coupon (ProductName, description, amount) VALUES ('IPhone X', 'IPhone Discount', 150);
    
    INSERT INTO Coupon (ProductName, description, amount) VALUES ('Samsung 10', 'Samsung Discount', 100);

24. Install the nuget package - Dapper
25. Install the nuget package - Npgsql
26. Create docker compose file
    • Right-click the project
    • Go to Add > Add container Orchestrator support
      • Select Docker compose and click ok
      • Select Target OS as Linux
    • DockerFile will be created in the project
    • Docker compose will be updated
27. Execute the below command to run the docker container

     docker-compose -f .\docker-compose.yml -f .\docker-compose.override.yml up -d

28. Create a new project Discount.Grpc with the template ASP.NET Core gRPC.
29. Change the running port and url
    • Right-click on the project and go to properties.
    • Go to Debug tab.
    • Select Discount.API from the profile.
    • Check the app url at the bottom.
    • The new profile gets added in the launchsettings.json in properties folder.
30. Install the nuget package - Dapper
31. Install the nuget package - Npgsql
32. Go to properties of the Discount.proto file
    • Change the build action to Protobuf compilers
    • Change gRPC stub classes to Server Only
33. Open Discount.Grpc.csproj file
    • Remove the below lines if present

      <ItemGroup>
        <None Remove="Protos\discount.proto" />
      </ItemGroup>

34. Build the project to generate the gRPC files in ~\Discount.Grpc\obj\Debug\net5.0\Protos\
35. Install the nuget package - AutoMapper.Extensions.Microsoft.DependencyInjection
36. Add gRPC client in Basket API
    • Right click on basket api project
    • Go to Add > Connected Services
    • Add new service reference for gRPC
    • Select the .proto file from discount grpc project
    • Select client
37. Create docker compose file
    • Right-click the project
    • Go to Add > Add container Orchestrator support
      • Select Docker compose and click ok
      • Select Target OS as Linux
    • DockerFile will be created in the project
    • Docker compose will be updated
38. Execute the below command to run the docker container

     docker-compose -f .\docker-compose.yml -f .\docker-compose.override.yml up -d --build

39. Create a new project Ordering.API with the template ASP.NET Core Web API.
40. Change the running port and url

• Right-click on the project and go to properties.
• Go to Debug tab.
• Select Catalog.API from the profile.
• Check the app url at the bottom.
• The new profile gets added in the launchsettings.json in properties folder.

41. Create a new project Ordering.Domain with the template class library c#.
    1. Common --> EntityBase, ValueObject
    2. Entities
42. Create a new project Ordering.Application with the template class library c#.
    1. Behaviour
    2. Contracts
       1. Persistence - IAsyncRepository and other Repository interfaces
       2. Infrastructe - Other third party integration interfaces
    3. Features - Each feature folder will have
       1. Commands
       2. Queries
    4. Mappings
    5. Models
    6. Exceptions
43. Create a new project Ordering.Infrastructure with the template class library c#.
44. Install the nuget package - AutoMapper
45. MediatR pipeline

    Caller > Request > mediatR > Pre Processor Behaviour > Handler > post Processor Behaviour
    

46. Install the nuget package - MediatR.Extensions.Microsoft.DependencyInjection
47. Install the nuget package - Microsoft.Extensions.Logging.Abstractions
48. Install the nuget package - FluentValidation
49. Install the nuget package - AutoMapper.Extensions.Microsoft.DependencyInjection
50. Install the nuget package - FluentValidation.DependencyInjectionExtensions
51. Install the nuget package - Microsoft.EntityFrameworkCore.SqlServer
52. Install the nuget package - SendGrid
53. Install the nuget package - Microsoft.EntityFrameworkCore.Tools
54. Run the below command in ordering infrastructure project

    Add-Migration InitialCreate
    

55. Create a new class project - EventBus.Messages
56. Install the below nuget packages in Basket.API and ordering.API projects
    1. MassTransit
    2. MassTransit.RabbitMQ
    3. MassTransit.AspNetCore
57. Create a new ASP.Net core empty project - ApiGateways
58. Install the nuget package - Ocelot
59. Install the nuget package - Ocelot.Cache.CacheManager
60. Create a new project Shopping.Aggregator with the template ASP.NET Core Web API.

1. MongoDB.Driver
2. Microsoft.Extensions.Caching.StackExchange
3. Newtonsoft.Json
4. Dapper
5. Npgsql
6. AutoMapper.Extensions.Microsoft.DependencyInjection
7. Automapper
8. MediatR.Extensions.Microsoft.DependencyInjection
9. Microsoft.Extensions.Logging.Abstractions
10. FluentValidation
11. AutoMapper.Extensions.Microsoft.DependencyInjection
12. FluentValidation.DependencyInjectionExtensions
13. Microsoft.EntityFrameworkCore.SqlServer
14. SendGrid
15. Microsoft.EntityFrameworkCore.Tools
16. MassTransit
17. MassTransit.RabbitMQ
18. MassTransit.AspNetCore
19. Ocelot
20. Ocelot.Cache.CacheManager

1. mongo
2. mongoclient
3. redis
4. portainer/portainer-ce
5. postgres
6. dpage/pgadmin4
7. mcr.microsoft.com/mssql/server:2017-latest
8. rabbitmq:3-management-alpine

• https://github.com/aspnetrun
• https://github.com/aspnetrun/run-aspnetcore-microservices
• https://stackoverflow.com/questions/62441307/how-can-i-change-the-location-of-docker-images-when-using-docker-desktop-on-wsl2
• https://newbedev.com/how-can-i-change-the-location-of-docker-images-when-using-docker-desktop-on-wsl2-with-windows-10-home
• https://documentation.portainer.io/quickstart/
• https://www.pgadmin.org/
• https://enterprisecraftsmanship.com/posts/entity-vs-value-object-the-ultimate-list-of-differences/
• https://docs.microsoft.com/en-us/dotnet/architecture/microservices/microservice-ddd-cqrs-patterns/implement-value-objects
• https://sendgrid.com/
• https://andrewlock.net/the-difference-between-getservice-and-getrquiredservice-in-asp-net-core/
• https://github.com/aspnetrun/run-aspnet-identityserver4
• https://ocelot.readthedocs.io/en/latest/introduction/gettingstarted.html
• https://docs.microsoft.com/en-us/aspnet/core/fundamentals/http-requests?view=aspnetcore-5.0
• https://docs.microsoft.com/en-us/dotnet/architecture/microservices/implement-resilient-applications/use-httpclientfactory-to-implement-resilient-http-requests