❔ Creating a backend in .NET

GET /hello.htm HTTP/1.1
User-Agent: Mozilla/4.0 (compatible; MSIE5.01; Windows NT)
Host: www.tutorialspoint.com
Accept-Language: en-us
Accept-Encoding: gzip, deflate
Connection: Keep-Alive

GET /hello.htm HTTP/1.1
User-Agent: Mozilla/4.0 (compatible; MSIE5.01; Windows NT)
Host: www.tutorialspoint.com
Accept-Language: en-us
Accept-Encoding: gzip, deflate
Connection: Keep-Alive

[Route("api/customers")]
public class CustomersController : ControllerBase
{
    [HttpGet]
    // no route, so it matches the "root" route of the controller
    public List<Customer> GetAll() { ... }

    [HttpPost]
    // no route, so it matches the "root" route of the controller
    public CustomerDto AddCustomer(CreateCustomerDto customer) { ... }
}

[Route("api/customers")]
public class CustomersController : ControllerBase
{
    [HttpGet]
    // no route, so it matches the "root" route of the controller
    public List<Customer> GetAll() { ... }

    [HttpPost]
    // no route, so it matches the "root" route of the controller
    public CustomerDto AddCustomer(CreateCustomerDto customer) { ... }
}

LeaderboardsGG.Backend
├─ .github
│  ├─ ISSUE_TEMPLATES
│  │  └─ ...
│  └─ workflows
│     └─ ...
├─ assets
│  └─ ...
├─ src
│  ├─ LeaderboardsGG.Backend
│  │  ├─ Properties
│  │  │  ├─ appsettings.json
│  │  │  ├─ appsettings.Development.json
│  │  │  └─ launchSettings.json
│  │  └─ LeaderboardsGG.Backend.csproj
│  └─ LeaderboardsGG.Backend.Tests
│     └─ LeaderboardsGG.Backend.Tests.csproj
├─ .editorconfig
├─ .gitignore
└─ LeaderboardsGG.Backend.sln

LeaderboardsGG.Backend
├─ .github
│  ├─ ISSUE_TEMPLATES
│  │  └─ ...
│  └─ workflows
│     └─ ...
├─ assets
│  └─ ...
├─ src
│  ├─ LeaderboardsGG.Backend
│  │  ├─ Properties
│  │  │  ├─ appsettings.json
│  │  │  ├─ appsettings.Development.json
│  │  │  └─ launchSettings.json
│  │  └─ LeaderboardsGG.Backend.csproj
│  └─ LeaderboardsGG.Backend.Tests
│     └─ LeaderboardsGG.Backend.Tests.csproj
├─ .editorconfig
├─ .gitignore
└─ LeaderboardsGG.Backend.sln

[HttpRepo] // custom attribute to generate .MapGet, .MapPost, etc.
public partial class CustomerRepository
{
    [HttpModel] // custom attribute to identify the repo's model
    public record Customer(Guid Id, string FullName);

    private readonly Dictionary<Guid, Customer> _customers = new();

    [HttpGet("/customers")] // not used for anything besides identifying what to generate
    public List<Customer> GetAll()
    {
        return _customers.Values.ToList();
    }
}

[HttpRepo] // custom attribute to generate .MapGet, .MapPost, etc.
public partial class CustomerRepository
{
    [HttpModel] // custom attribute to identify the repo's model
    public record Customer(Guid Id, string FullName);

    private readonly Dictionary<Guid, Customer> _customers = new();

    [HttpGet("/customers")] // not used for anything besides identifying what to generate
    public List<Customer> GetAll()
    {
        return _customers.Values.ToList();
    }
}

namespace Lbgg.Domain;

public sealed class User
{
    [Required]
    public required ulong Id { get; set; }

    [Required]
    [MinLength(2)]
    [MaxLength(32)]
    [RegularExpression(@"^[a-zA-Z0-9][a-zA-Z0-9_'-]*[a-zA-Z0-9]$")]
    public required string Name { get; set; }
}

namespace Lbgg.Domain;

public sealed class User
{
    [Required]
    public required ulong Id { get; set; }

    [Required]
    [MinLength(2)]
    [MaxLength(32)]
    [RegularExpression(@"^[a-zA-Z0-9][a-zA-Z0-9_'-]*[a-zA-Z0-9]$")]
    public required string Name { get; set; }
}

public sealed class User
{
    public required ulong Id { get; set; }
    public required string Name { get; set; }
    public required string Email { get; set; }
    public required string Password { get; set; }

    public string? About { get; set; }
}

public sealed class User
{
    public required ulong Id { get; set; }
    public required string Name { get; set; }
    public required string Email { get; set; }
    public required string Password { get; set; }

    public string? About { get; set; }
}

namespace Lbgg.Controllers.Users;

[HttpCommand]
public static partial class Create
{
  public sealed partial record Command(
    ulong Id,
    string Name)
  {
    private static void AddValidation(AbstractValidator<Command> v)
    {
      v.RuleFor(u => u.Name).NotEmpty().MinimumLength(2).MaximumLength(32);
    }
  }

  private static async Task CommandHandler(
    Command command,
    ApplicationDbContext dbContext,
    ILogger logger)
  {
    if (await context.Users.AnyAsync(u => u.Id == command.Id))
      throw new InvalidOperationException($"User '{command.Id}' already exists.");

    var user = new UserEntity
    {
      UserName = command.UserName,
      Id = command.Id,
    };

    context.Users.Add(user);
    await context.SaveChangesAsync();

    using (logger.AddProperties(("@NewUserInformation", command)))
      logger.LogInformation("New user created");
  }
}

namespace Lbgg.Controllers.Users;

[HttpCommand]
public static partial class Create
{
  public sealed partial record Command(
    ulong Id,
    string Name)
  {
    private static void AddValidation(AbstractValidator<Command> v)
    {
      v.RuleFor(u => u.Name).NotEmpty().MinimumLength(2).MaximumLength(32);
    }
  }

  private static async Task CommandHandler(
    Command command,
    ApplicationDbContext dbContext,
    ILogger logger)
  {
    if (await context.Users.AnyAsync(u => u.Id == command.Id))
      throw new InvalidOperationException($"User '{command.Id}' already exists.");

    var user = new UserEntity
    {
      UserName = command.UserName,
      Id = command.Id,
    };

    context.Users.Add(user);
    await context.SaveChangesAsync();

    using (logger.AddProperties(("@NewUserInformation", command)))
      logger.LogInformation("New user created");
  }
}

public sealed partial class UserController
{
  [HttpPost]
  public async Task Create(Create.Command command)
  {
    return await _sender.Send(command);
  }
}

public sealed partial class UserController
{
  [HttpPost]
  public async Task Create(Create.Command command)
  {
    return await _sender.Send(command);
  }
}

namespace Lbgg.Endpoints.Dtos;

public sealed record CreateUser(
    string Name,
    string Email,
    string Password);

namespace Lbgg.Endpoints.Dtos;

public sealed record CreateUser(
    string Name,
    string Email,
    string Password);

[HttpEndpointGenerator]
public static class UserEndpoints
{
  // generates the dto, the controller, and whatever else is needed
  public static async Task Create(string name, string email, string password)
  {
    // create user
  }
}

[HttpEndpointGenerator]
public static class UserEndpoints
{
  // generates the dto, the controller, and whatever else is needed
  public static async Task Create(string name, string email, string password)
  {
    // create user
  }
}

namespace Lbgg.Endpoints.Users;

file static class Create
{
  record Command(string Name, string Email, string Password);

  static async Task Execute(Command c) => UserEndpoints.Create(c.Name, c.Email, c.Password);
}

namespace Lbgg.Endpoints.Users;

file static class Create
{
  record Command(string Name, string Email, string Password);

  static async Task Execute(Command c) => UserEndpoints.Create(c.Name, c.Email, c.Password);
}

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.

builder.Services.AddControllers();

// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();

app.Run();

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.

builder.Services.AddControllers();

// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();

app.Run();

[ApiController]
[Route("api/users")]
public class UsersController : ControllerBase
{
    [HttpGet("{id}")]
    public User GetUser(ulong id)
    {
        return new User()
        {
            Id = id,
            About = "not yet",
            Email = "[email protected]",
            Name = "Steve",
            Password = "oh dear god"
        };
    }
}

[ApiController]
[Route("api/users")]
public class UsersController : ControllerBase
{
    [HttpGet("{id}")]
    public User GetUser(ulong id)
    {
        return new User()
        {
            Id = id,
            About = "not yet",
            Email = "[email protected]",
            Name = "Steve",
            Password = "oh dear god"
        };
    }
}

public class Database
{
    public List<User> Users { get; } = new();
}

public class Database
{
    public List<User> Users { get; } = new();
}

[ApiController]
[Route("api/users")]
public class UsersController : ControllerBase
{
    private readonly Database _database;

    public UsersController(Database database)
    {
        _database = database;
    }

[ApiController]
[Route("api/users")]
public class UsersController : ControllerBase
{
    private readonly Database _database;

    public UsersController(Database database)
    {
        _database = database;
    }

[HttpGet("{id}")]
public ActionResult<User> GetUser(long id)
{
    var user = _database.Users.FirstOrDefault(x => x.Id == id);

    if (user is null)
    {
        return NotFound();
    }

    return user;
}

[HttpGet("{id}")]
public ActionResult<User> GetUser(long id)
{
    var user = _database.Users.FirstOrDefault(x => x.Id == id);

    if (user is null)
    {
        return NotFound();
    }

    return user;
}

public record CreateUserDto(
    string Name,
    string Email,
    string Password);


public ActionResult CreateUser(CreateUserDto userToCreate)
{
    if (_database.Users.Any(u => u.Name == userToCreate.Name))
    {
        return Conflict();
    }

    _database.Users.Add(new()
    {
        Id = /* ? */,
        Name = userToCreate.Name,
        Email = userToCreate.Email,
        Password = userToCreate.Password
    });

    return Success(); // The name 'Success' does not exist in the current context
}

public record CreateUserDto(
    string Name,
    string Email,
    string Password);


public ActionResult CreateUser(CreateUserDto userToCreate)
{
    if (_database.Users.Any(u => u.Name == userToCreate.Name))
    {
        return Conflict();
    }

    _database.Users.Add(new()
    {
        Id = /* ? */,
        Name = userToCreate.Name,
        Email = userToCreate.Email,
        Password = userToCreate.Password
    });

    return Success(); // The name 'Success' does not exist in the current context
}

var command = new CreateUserCommand(...);
var result = _dispatcher.Run(command);

var command = new CreateUserCommand(...);
var result = _dispatcher.Run(command);

var command = new CreateUserCommand(...);
var result = _createUserHandler.Handle(command);

var command = new CreateUserCommand(...);
var result = _createUserHandler.Handle(command);

[ApiController]
public class UserController : ControllerBase
{
  private readonly EntityContext _db;

  public UserController(EntityContext db) => _db = db;

  [HttpPost]
  public async Task<IActionResult> Add([FromBody] UserDto user)
  {
    var userEntity = new User
    {
      Username = user.Username,
      Password = HashPassword(user.Password)
    };

    _db.Add(userEntity);
    await _db.SaveChangesAsync();
    return Ok();
  }
}

[ApiController]
public class UserController : ControllerBase
{
  private readonly EntityContext _db;

  public UserController(EntityContext db) => _db = db;

  [HttpPost]
  public async Task<IActionResult> Add([FromBody] UserDto user)
  {
    var userEntity = new User
    {
      Username = user.Username,
      Password = HashPassword(user.Password)
    };

    _db.Add(userEntity);
    await _db.SaveChangesAsync();
    return Ok();
  }
}