![\"\"](\"http:\/\/blogs.encamina.com\/piensa-en-software-desarrolla-en-colores\/wp-content\/uploads\/sites\/21\/2020\/06\/Hangfire.jpg\")
<\/p>\n<\/p>\n
Hangfire es una librer\u00eda en la que podemos ejecutar nuestros procesos en Background en nuestros desarrollos en .NET y .NET Core. En este art\u00edculo vamos a ver c\u00f3mo utilizar la inyecci\u00f3n que trae .NET Core de serie en nuestros proyectos y con esto,\u00a0 evitarnos el tener otro aspecto de configuraci\u00f3n adicional. As\u00ed, nuestros procesos de Background son mucho m\u00e1s sencillos de configurar y sobre todo, podemos testearlos al igual que cualquier otro elemento \ud83d\ude09<\/p>\n
<\/p>\n
En las aplicaciones Web hay ocasiones en las que necesitamos tener algunas tareas en Background cuya ejecuci\u00f3n no paralice el funcionamiento normal de nuestro desarrollo. Por ejemplo, un proceso de env\u00edo de mails, un proceso de importaci\u00f3n de datos, etc. Para esto, Hangfire es una librer\u00eda que nos proporciona una serie de utilidades de serie como planificar cu\u00e1ndo queremos lanzar este proceso (d\u00eda, hora, periodicidad), tambi\u00e9n proporciona un marco de reintentos (si alg\u00fan proceso falla, se vuelve a lanzar), y por si fuera poco, tambi\u00e9n dispone de una interfaz Web en la que podemos ver todos los procesos que se tiene planificado y el resultado de las ejecuciones.<\/p>\n
S\u00e9 que muchos lo estar\u00e9is pensando. Para todos estos procesos en un desarrollo Cloud en un entorno Microsoft hac\u00e9is uso de un servicio serverless como son las Azure Functions<\/a>. S\u00ed, en cierta manera, las Azure Functions son muchos m\u00e1s que WebJobs, con lo cual no estamos comparando el mismo servicio. Imaginemos un escenario en el que tenemos una Web sin tr\u00e1fico nocturno y con el servidor pr\u00e1cticamente parado, por lo que disponemos de una franja que podemos aprovechar para todas estas tareas sin la necesidad de adquirir un servicio extra (con un coste asociado al mismo). Como muchas veces digo, para un determinado escenario, no hay solo una opci\u00f3n v\u00e1lida, sino que nos interesa conocer las alternativas y escoger la mejor (o la menos mala :P).<\/p>\n Para aquellos que es la primera vez que escuchan hablar sobre Hangfire les recomiendo que vayan a leer est\u00e9\u00a0art\u00edculo<\/a>\u00a0que escribi\u00f3 el gran\u00a0Juan Carlos Mart\u00ednez<\/a>\u00a0y luego continuar con la lectura de este art\u00edculo.<\/p>\n Cuando instalamos HangFire en nuestra soluci\u00f3n y le indicamos proyecto web que vamos a utilizar HangFire, tenemos que hacer dos cosas:<\/p>\n Como pod\u00e9is ver, lo que hace Hangfire es montar otra aplicaci\u00f3n independiente dentro de nuestro servidor Web aprovechando la misma infraestructura. Esto provoca que, si no se indica nada, toda inyecci\u00f3n de dependencia que tengamos en .NET Core no la tendremos en los procesos que implementemos en HangFire.<\/p>\n Cuando hablamos de inyecci\u00f3n de dependencias, todos estamos pensando en las interfaces de nuestra l\u00f3gica de negocio, etc… pero hay muchas m\u00e1s cosas que se inyectan en .NET Core que van desde las propias settings de configuraci\u00f3n hasta el sistema de Logs. Por lo que, aunque pensemos que quiz\u00e1 no me interese inyectarle las dependencias de mi proyecto a los procesos de HangFire porque es un proceso r\u00e1pido y eficaz y que solo se ejecuta una vez no requiere de inyecci\u00f3n de dependencias, creo que estamos en un contexto diferente.<\/p>\n Si en lugar de poner HangFire pusiera Azure Functions, tendr\u00edamos las dos opiniones:<\/p>\n Mi opini\u00f3n en cuanto a Hangfire, es que el escenario en el que estamos no es el mismo que el que tenemos en una Functions, principalmente porque en nuestra aplicaci\u00f3n arranca el servidor y hay carga todas las dependencias que tiene y las resuelve. El escenario no es el mismo y la ejecuci\u00f3n tampoco. Por lo tanto, para m\u00ed, aunque HangFire es un subproceso dentro de nuestro servidor, en caso de que estos procesos requieran elementos del desarrollo (algo de lo m\u00e1s normal) deber\u00eda tener una inyecci\u00f3n de dependencia para tener un ciclo de vida \u201cnormal\u201d dentro del desarrollo.<\/p>\n Partimos de la base que ya tenemos creado un proyecto de Dotnet<\/p>\n Agregaremos los paquetes de Nuget necesarios para hacer uso de Hangfire<\/p>\n Si todo ha ido correctamente y arrancamos la soluci\u00f3n tendremos estos paquetes instalados El siguiente paso ser\u00eda, como en casi todo en Dotnet Core, a\u00f1adir los middleware necesarios para que arranque Hangfire.<\/p>\n En el Hangfire, hemos establecido la configuraci\u00f3n tal y como indica la p\u00e1gina oficial de HangFire<\/a> y en el \u00faltimo puesto le hemos indicado que utilice como almacenamiento un almacenamiento en memoria. Para almacenar toda esta informaci\u00f3n existen multitudes de opciones como SQl Server, CosmosDB, Azure Blob Storage, etc.<\/p>\n En el m\u00e9todo de configurar, a\u00f1adiremos que arranque un Dashboard para que tengamos una visualizaci\u00f3n de los procesos que se est\u00e1n ejecutando.<\/p>\n Si arrancamos nuestra aplicaci\u00f3n y nos dirigimos a la ruta \u201c\/hangfire\u201d visualizamos la siguiente pantalla: Por poner un caso de uso, implementaremos un servicio de env\u00edo de mail diario. Para ello, nos creamos una carpeta que se llame \u201cServices\u201d. En esta carpeta tenemos, por un lado, un servicio con su interfaz que env\u00eda mail (en este ejemplo lo simula, ya que no es parte de este art\u00edculo). Tambi\u00e9n nos crearemos una interfaz para el servicio que vamos a implementar en Hangfire<\/p>\n La interfaz tendr\u00e1 la siguiente estructura:<\/p>\n y la implementaci\u00f3n seria la siguiente:<\/p>\n Ahora para el servicio que vamos a implementar en Hangfire tendremos la siguiente interfaz:<\/p>\n En primer lugar, creamos la clase \u201cHangfireActivator\u201d que depende de una clase JobActivator que es la que configura la inyecci\u00f3n de dependencias para el servicio de Hangfire.<\/p>\n Una vez que tenemos el desarrollo por un lado, tendremos que inyectar las dependencias en nuestro StarUp, para ello dentro del m\u00e9todo \u201cConfigureServices\u201d a\u00f1adiremos las siguientes l\u00edneas de c\u00f3digo.<\/p>\n Ahora en el m\u00e9todo \u201cConfigure\u201d, en primer lugar a\u00f1adiremos un nuevo par\u00e1metro IServiceProvider serviceProvider. Luego a\u00f1adiremos la siguiente l\u00ednea para resolver la inyecci\u00f3n de dependencia dentro de Hangfire<\/p>\n Para finalizar ya podemos crear el Job de Hangfire con una l\u00ednea como la siguiente:<\/p>\n Si ahora ejecutamos el c\u00f3digo y vamos a la pesta\u00f1a \u201cTareas Recurrentes\u201d, observamos que tendremos programada la ejecuci\u00f3n de la tarea que acabamos de a\u00f1adir. DotNet Core nos proporciona un sistema muy modular y eso hace que aplicaciones de un tercero se puedan integrar de una manera f\u00e1cil y sencilla. En este art\u00edculo hemos visto c\u00f3mo hacerlo con Hangfire. Como hab\u00e9is podido observar, Hangfire es una librer\u00eda muy potente y con multitud de opciones. S\u00ed, lo tengo que reconocer. Por si no lo hab\u00e9is notado a\u00fan, Hangfire es algo que me gusta mucho \ud83d\ude42<\/p>\n Pod\u00e9is ver el ejemplo en mi repositorio de\u00a0Github<\/a><\/p>\n Happy codding!<\/p>\n PD: Tambi\u00e9n puedes encontrar este art\u00edculo en mi blog personal.<\/a><\/p>\n<\/span>","protected":false},"excerpt":{"rendered":" Hangfire es una librer\u00eda en la que podemos ejecutar nuestros procesos en Background en nuestros desarrollos en .NET y .NET Core. En este art\u00edculo vamos a ver c\u00f3mo utilizar la inyecci\u00f3n que trae .NET Core de serie en nuestros proyectos … Continue reading \u00bfC\u00f3mo funciona Hangfire dentro de una aplicaci\u00f3n de .NET?<\/h1>\n
\n
Necesitamos inyecci\u00f3n de dependencias en un proceso en HangFire<\/h2>\n
\n
\n
\n
Manos a la obra<\/h1>\n
\ndotnet new webapi\r\n<\/code><\/pre>\n<\/div>\n\n dotnet add package hangfire.core\r\n dotnet add package hangfire.aspnetcore\r\n dotnet add package hangfire.memorystorage\r\n<\/code><\/pre>\n<\/div>\n![\"solution](\"https:\/\/www.theavenger.dev\/posts\/images\/hangfire\/nuget.PNG\")
<\/p>\n\npublic void ConfigureServices(IServiceCollection services)\r\n {\r\n services.AddHangfire(configuration => configuration\r\n .SetDataCompatibilityLevel(CompatibilityLevel.Version_170)\r\n .UseSimpleAssemblyNameTypeSerializer()\r\n .UseRecommendedSerializerSettings()\r\n .UseMemoryStorage());\r\n services.AddHangfireServer();\r\n services.AddControllers();\r\n }\r\n<\/code><\/pre>\n<\/div>\n\n public void Configure(IApplicationBuilder app, IWebHostEnvironment env)\r\n {\r\n if (env.IsDevelopment())\r\n {\r\n app.UseDeveloperExceptionPage();\r\n }\r\n app.UseHttpsRedirection();\r\n app.UseRouting();\r\n app.UseAuthorization();\r\n app.UseHangfireDashboard();\r\n app.UseEndpoints(endpoints =>\r\n {\r\n endpoints.MapControllers();\r\n });\r\n }\r\n<\/code><\/pre>\n<\/div>\n![\"dashboard](\"https:\/\/www.theavenger.dev\/posts\/images\/hangfire\/dashboard.PNG\")
<\/p>\n\npublic interface ISendMailServices\r\n{\r\n Task<bool> SendMailAsync(string mail, string message);\r\n}\r\n<\/code><\/pre>\n<\/div>\n\npublic class SendMailServices : ISendMailServices\r\n{ \r\n public async Task<bool> SendMailAsync(string mail, string message)\r\n {\r\n await Task.Delay(3000);\r\n return true;\r\n }\r\n}\r\n<\/code><\/pre>\n<\/div>\n\npublic interface IHangFireServices\r\n{\r\n Task ScheduleJob();\r\n}\r\n<\/code><\/pre>\n<\/div>\n\n public class HangFireServices : IHangFireServices\r\n {\r\n private readonly IConfiguration configuration;\r\n private readonly ISendMailServices sendMailServices;\r\n\r\n public HangFireServices(IConfiguration configuration,ISendMailServices sendMailServices )\r\n {\r\n this.configuration = configuration;\r\n this.sendMailServices = sendMailServices;\r\n }\r\n public async Task ScheduleJob()\r\n {\r\n var email = this.configuration.GetSection(\"sendmail\").Value;\r\n var message = \"Hola q ase\";\r\n await this.sendMailServices.SendMailAsync(email, message); \r\n }\r\n }\r\n<\/code><\/pre>\n<\/div>\nTuneando el arranque<\/h2>\n
\npublic class HangfireActivator : JobActivator\r\n{\r\n private readonly IServiceProvider serviceProvider;\r\n public HangfireActivator(IServiceProvider serviceProvider)\r\n {\r\n serviceProvider = serviceProvider;\r\n }\r\n public override object ActivateJob(Type jobType)\r\n {\r\n return serviceProvider.GetService(jobType);\r\n }\r\n}\r\n<\/code><\/pre>\n<\/div>\n\n services.AddTransient<ISendMailServices, SendMailServices>();\r\n services.AddTransient<IHangFireServices, HangFireServices>();\r\n<\/code><\/pre>\n<\/div>\n\npublic void Configure(IApplicationBuilder app, IWebHostEnvironment env, IServiceProvider serviceProvider)\r\n{\r\n GlobalConfiguration.Configuration.UseActivator(new HangfireActivator(serviceProvider));\r\n<\/code><\/pre>\n<\/div>\n\nRecurringJob.AddOrUpdate<IHangFireServices>(hangfire => hangfire.ScheduleJob(), Cron.Weekly);\r\n<\/code><\/pre>\n<\/div>\n<\/p>\nResumiendo<\/h1>\n