Clean Architecture Demo
Toggle main menu visibility
Loading...
Searching...
No Matches
Program.cs
Go to the documentation of this file.
1
// Este archivo es la raíz de composición y configuración de inicio de la aplicación.
2
//
3
// Rol en Clean Architecture:
4
// - Parte de la capa de presentación, en este caso, API REST
5
// - Raíz de Composición: Conecta todas las dependencias a través de Inyección de Dependencias
6
// - Configuración: Configura pipeline de middleware, autenticación y servicios
7
// - Punto de entrada: ASP.NET Core ejecuta este archivo en el inicio de la aplicación
8
//
9
// Responsabilidades:
10
// - Registrar servicios de todas las capas en el contenedor de DI
11
// - Configurar autenticación y autorización
12
// - Agregar servicios de acceso a datos y persistencia
13
// - Configurar pipeline de middleware (¡el orden importa!)
14
// - Inicializar base de datos si es necesario
15
//
16
// Patrón de Inyección de Dependencias:
17
// - Registra interfaces de capas de Aplicación y Dominio
18
// - Implementaciones de capa de Infraestructura
19
// - Los controladores usan servicios registrados (inyección de constructor)
20
// - Los interactores usan servicios registrados: reciben sus puertos de salida por constructor
21
// - Los presenters son Scoped: el interactor escribe en la misma instancia que lee el controlador
22
//
23
// Registro de Capa de Arquitectura:
24
// - Capa de aplicación: interactores y los puertos IUnitOfWork, ITaskRepository,
25
// IDomainEventDispatcher
26
// - Capa de infraestructura: DbContext, Repositorios, Distribuidor de Eventos
27
// - Capa de UI: Controladores, Presenters, Middleware
28
//
29
// Directrices de Raíz de Composición:
30
// - La capa de UI puede hacer referencia a Infraestructura para registro de DI
31
// - Infraestructura implementa interfaces de otras capas
32
// - Las capas del dominio y Aplicación permanecen independientes
33
// - Este archivo es el único lugar donde se hace referencia directa a Infraestructura
34
//
35
// pipeline de Middleware:
36
// - El orden es crítico: el middleware anterior procesa solicitudes primero
37
// - ExceptionHandlingMiddleware: Usualmente primero para capturar todas las excepciones
38
// - Autenticación, Autorización: Middleware relacionado con seguridad
39
// - MapControllers: Enruta solicitudes a controladores
40
41
using
System.Data.Common;
42
using
System.Reflection;
43
using
System.Text.Json.Serialization;
44
using
Microsoft.AspNetCore.Authentication.JwtBearer;
45
using
Microsoft.Data.Sqlite;
46
using
Microsoft.EntityFrameworkCore;
47
using
Microsoft.IdentityModel.Tokens;
48
using
TaskManagement.API.Middleware
;
49
using
TaskManagement.API.Presenters
;
50
using
TaskManagement.Application.Commands
;
51
using
TaskManagement.Application.Events
;
52
using
TaskManagement.Application.Ports
;
53
using
TaskManagement.Application.Queries
;
54
using
TaskManagement.Domain.Events
;
55
using
TaskManagement.Infrastructure.Email
;
56
using
TaskManagement.Infrastructure.EventDispatching
;
57
using
TaskManagement.Infrastructure.Persistence
;
58
using
TaskManagement.Infrastructure.Persistence.Repositories
;
59
60
var
builder
= WebApplication.CreateBuilder(args);
61
62
// Cargar secretos de usuario explícitamente para que los tokens dotnet user-jwts funcionen incluso cuando
63
// el proceso se inicia sin ASPNETCORE_ENVIRONMENT=Development.
64
builder
.Configuration.AddUserSecrets(Assembly.GetExecutingAssembly(), optional:
true
);
65
66
const
string
connectionString
=
"Data Source=file:taskmanagement?mode=memory&cache=shared"
;
67
builder
.Configuration.AddInMemoryCollection(
new
Dictionary<string, string?> {
68
[
"ConnectionStrings:DefaultConnection"
] =
connectionString
69
});
70
71
builder
.Services.AddSingleton<SqliteConnection>(_ => {
72
var connection =
new
SqliteConnection(
connectionString
);
73
connection.Open();
74
return
connection;
75
});
76
77
var
bearerSection
=
builder
.Configuration.GetSection(
"Authentication:Schemes:Bearer"
);
78
var
validIssuer
=
bearerSection
[
"ValidIssuer"
];
79
var
validAudiences
=
bearerSection
80
.GetSection(
"ValidAudiences"
)
81
.Get<
string
[]>() ?? [];
82
var
signingKeys
=
bearerSection
83
.GetSection(
"SigningKeys"
)
84
.GetChildren()
85
.Select(x => x[
"Value"
])
86
.Where(x => !
string
.IsNullOrWhiteSpace(x))
87
.Select(x =>
new
SymmetricSecurityKey(Convert.FromBase64String(x!)))
88
.Cast<SecurityKey>()
89
.ToArray();
90
91
builder.Services
92
.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
93
.AddJwtBearer(options => {
94
options.TokenValidationParameters =
new
TokenValidationParameters {
95
ValidateIssuer = !
string
.IsNullOrWhiteSpace(
validIssuer
),
96
ValidIssuer =
validIssuer
,
97
ValidateAudience = validAudiences.Length > 0,
98
ValidAudiences =
validAudiences
,
99
ValidateIssuerSigningKey =
true
,
100
IssuerSigningKeys =
signingKeys
,
101
ValidateLifetime =
true
,
102
TryAllIssuerSigningKeys =
true
,
103
ClockSkew = TimeSpan.FromMinutes(1)
104
};
105
});
106
builder
.Services.AddAuthorization();
107
108
// Agregar servicios al contenedor
109
builder.Services
110
.AddDbContext<
TaskDbContext
>(options =>
111
options.UseSqlite(
builder
.Configuration.GetConnectionString(
"DefaultConnection"
)))
112
.AddScoped<
IUnitOfWork
>(sp => sp.GetRequiredService<
TaskDbContext
>())
113
.AddScoped<ITaskRepository, TaskRepository>()
114
.AddSingleton<Func<DbConnection>>(_ => () =>
new
SqliteConnection(
connectionString
))
115
.AddScoped<ITaskReadRepository, TaskReadRepository>()
116
.AddScoped<
IDomainEventDispatcher
,
InProcessDomainEventDispatcher
>()
117
.AddScoped<IDomainEventSubscriber<TaskCompletedEvent>,
TaskCompletedNotificationHandler
>()
118
.AddScoped<
IEmailService
,
LoggingEmailService
>()
119
// Crear tarea
120
.AddScoped<CreateTaskPresenter>()
121
.AddScoped<
ICreateTaskOutputBoundary
>(sp => sp.GetRequiredService<
CreateTaskPresenter
>())
122
.AddScoped<ICreateTaskInputBoundary, CreateTaskInteractor>()
123
// Completar tarea
124
.AddScoped<
CompleteTaskPresenter
>()
125
.AddScoped<ICompleteTaskOutputBoundary>(sp => sp.GetRequiredService<
CompleteTaskPresenter
>())
126
.AddScoped<
ICompleteTaskInputBoundary
,
CompleteTaskInteractor
>()
127
// Consultar tarea
128
.AddScoped<GetTaskByIdPresenter>()
129
.AddScoped<
IGetTaskByIdOutputBoundary
>(sp => sp.GetRequiredService<
GetTaskByIdPresenter
>())
130
.AddScoped<IGetTaskByIdInputBoundary, GetTaskByIdInteractor>()
131
.AddControllers()
132
.AddJsonOptions(options => {
133
options.JsonSerializerOptions.Converters.Add(
new
JsonStringEnumConverter());
134
});
135
var
app
=
builder
.Build();
136
137
using
(var
scope
=
app
.Services.CreateScope())
138
{
139
var dbContext =
scope
.ServiceProvider.GetRequiredService<
TaskDbContext
>();
140
dbContext.Database.EnsureCreated();
141
}
142
143
// Configurar pipeline de middleware
144
app
.UseMiddleware<
ExceptionHandlingMiddleware
>();
145
146
app
.UseHttpsRedirection();
147
app
.UseAuthentication();
148
app
.UseAuthorization();
149
app
.MapControllers();
150
151
app
.Run();
152
157
public
partial class
Program
158
{
159
// Intencionalmente en blanco.
160
}
validIssuer
var validIssuer
Definition
Program.cs:78
validAudiences
var validAudiences
Definition
Program.cs:79
builder
var builder
Definition
Program.cs:60
app
var app
Definition
Program.cs:135
scope
app.Services.CreateScope()) { var dbContext=scope.ServiceProvider.GetRequiredService< TaskDbContext >(); dbContext.Database.EnsureCreated();} app.UseMiddleware< ExceptionHandlingMiddleware >() scope
Definition
Program.cs:137
connectionString
const string connectionString
Definition
Program.cs:66
signingKeys
var signingKeys
Definition
Program.cs:82
bearerSection
var bearerSection
Definition
Program.cs:77
Program
Partial Program class made public for testing purposes. Allows WebApplicationFactory to access the Pr...
Definition
Program.cs:158
TaskManagement.API.Middleware.ExceptionHandlingMiddleware
ExceptionHandlingMiddleware convierte las excepciones inesperadas en una respuesta HTTP 500.
Definition
ExceptionHandlingMiddleware.cs:23
TaskManagement.API.Presenters.CompleteTaskPresenter
CompleteTaskPresenter convierte el resultado del caso de uso de completar una tarea en una respuesta ...
Definition
CompleteTaskPresenter.cs:11
TaskManagement.API.Presenters.CreateTaskPresenter
CreateTaskPresenter convierte el resultado del caso de uso de crear una tarea en una respuesta HTTP.
Definition
CreateTaskPresenter.cs:22
TaskManagement.API.Presenters.GetTaskByIdPresenter
GetTaskByIdPresenter convierte el resultado del caso de uso de consultar una tarea en una respuesta H...
Definition
GetTaskByIdPresenter.cs:13
TaskManagement.Application.Commands.CompleteTaskInteractor
CompleteTaskInteractor implementa el caso de uso de completar una tarea.
Definition
CompleteTaskInteractor.cs:19
TaskManagement.Application.Events.TaskCompletedNotificationHandler
TaskCompletedNotificationHandler envía una notificación cuando se completa una tarea.
Definition
TaskCompletedNotificationHandler.cs:18
TaskManagement.Infrastructure.Email.LoggingEmailService
LoggingEmailService es una implementación de IEmailService que, en lugar de enviar correos reales,...
Definition
LoggingEmailService.cs:21
TaskManagement.Infrastructure.EventDispatching.InProcessDomainEventDispatcher
InProcessDomainEventDispatcher entrega cada evento del dominio a sus manejadores, en el mismo proceso...
Definition
InProcessDomainEventDispatcher.cs:27
TaskManagement.Infrastructure.Persistence.TaskDbContext
TaskDbContext es el DbContext de Entity Framework Core para gestión de tareas.
Definition
TaskDbContext.cs:57
TaskManagement.Application.Commands.ICompleteTaskInputBoundary
ICompleteTaskInputBoundary es el puerto de entrada del caso de uso de completar una tarea....
Definition
ICompleteTaskInputBoundary.cs:8
TaskManagement.Application.Commands.ICreateTaskOutputBoundary
ICreateTaskOutputBoundary es el puerto de salida por el que el caso de uso de crear una tarea entrega...
Definition
ICreateTaskOutputBoundary.cs:17
TaskManagement.Application.Ports.IDomainEventDispatcher
IDomainEventDispatcher es la interfaz para publicación de eventos del dominio.
Definition
IDomainEventDispatcher.cs:46
TaskManagement.Application.Ports.IEmailService
IEmailService es la abstracción para envío de notificaciones por correo electrónico.
Definition
IEmailService.cs:39
TaskManagement.Application.Ports.IUnitOfWork
IUnitOfWork es la abstracción para coordinar la persistencia de cambios de entidades.
Definition
IUnitOfWork.cs:37
TaskManagement.Application.Queries.IGetTaskByIdOutputBoundary
IGetTaskByIdOutputBoundary es el puerto de salida por el que el caso de uso de consultar una tarea en...
Definition
IGetTaskByIdOutputBoundary.cs:8
TaskManagement.API.Middleware
Definition
ExceptionHandlingMiddleware.cs:4
TaskManagement.API.Presenters
Definition
CompleteTaskPresenter.cs:4
TaskManagement.Application.Commands
Definition
CompleteTaskInput.cs:1
TaskManagement.Application.Events
Definition
IDomainEventSubscriber.cs:3
TaskManagement.Application.Ports
Definition
IDomainEventDispatcher.cs:3
TaskManagement.Application.Queries
Definition
GetTaskByIdInput.cs:1
TaskManagement.Domain.Events
Definition
DomainEvent.cs:4
TaskManagement.Infrastructure.Email
Definition
LoggingEmailService.cs:4
TaskManagement.Infrastructure.EventDispatching
Definition
InProcessDomainEventDispatcher.cs:7
TaskManagement.Infrastructure.Persistence.Repositories
Definition
TaskReadRepository.cs:9
TaskManagement.Infrastructure.Persistence
Definition
TaskConfiguration.cs:6
src
TaskManagement.API
Program.cs
Generated by
1.18.0