Browse Source

docs: add background workers documentation for layered solution and update navigation links

pull/21781/head
ahmetfarukulu 1 year ago
parent
commit
ce9e47a132
  1. 63
      docs/en/solution-templates/layered-web-application/background-workers.md
  2. 4
      docs/en/solution-templates/layered-web-application/multi-tenancy.md
  3. 2
      docs/en/solution-templates/single-layer-web-application/background-workers.md

63
docs/en/solution-templates/layered-web-application/background-workers.md

@ -0,0 +1,63 @@
# Layered Solution: Background Workers
```json
//[doc-nav]
{
"Previous": {
"Name": "Background Jobs",
"Path": "solution-templates/layered-web-application/background-jobs"
},
"Next": {
"Name": "Multi-Tenancy",
"Path": "solution-templates/layered-web-application/multi-tenancy"
}
}
```
Background workers are long-running processes that operate in the background of your application. They are ideal for non-time-sensitive tasks, such as processing data, sending notifications, or monitoring system health. Typically, background workers start when the application launches and run continuously until the application stops. For more information, refer to the [Background Workers](../../framework/infrastructure/background-workers/index.md) document.
Basically, you can create scheduled workers to run at specific time intervals based on your requirements. For example, you might create a worker to check the status of inactive users and change their status to passive if they haven't logged in to the application in the last 30 days.
```csharp
public class PassiveUserCheckerWorker : AsyncPeriodicBackgroundWorkerBase
{
public PassiveUserCheckerWorker(
AbpAsyncTimer timer,
IServiceScopeFactory serviceScopeFactory) : base(
timer,
serviceScopeFactory)
{
Timer.Period = 600000; //10 minutes
}
protected async override Task DoWorkAsync(
PeriodicBackgroundWorkerContext workerContext)
{
Logger.LogInformation("Starting: Setting status of inactive users...");
// Resolve dependencies
var userRepository = workerContext
.ServiceProvider
.GetRequiredService<IUserRepository>();
// Do the work
await userRepository.UpdateInactiveUserStatusesAsync();
Logger.LogInformation("Completed: Setting status of inactive users...");
}
}
```
After creating a worker, we should also register it in the application. We might add it in the *Domain* or *Application* layer. You can register your worker in the `OnApplicationInitializationAsync` method of your module class.
```csharp
public class BookstoreApplicationModule : AbpModule
{
public override async Task OnApplicationInitializationAsync(ApplicationInitializationContext context)
{
await context.AddBackgroundWorkerAsync<PassiveUserCheckerWorker>();
}
}
```
> When scaling out your application in a distributed system, it's crucial to consider that the same background workers might run on multiple instances of the same service. This requires careful management of potential side effects. For example, if you're processing messages from a queue, you need to ensure that each message is processed only once. To prevent multiple instances from handling the same message, you can use [distributed locking](../../framework/infrastructure/distributed-locking.md).

4
docs/en/solution-templates/layered-web-application/multi-tenancy.md

@ -4,8 +4,8 @@
//[doc-nav]
{
"Previous": {
"Name": "Swagger integration",
"Path": "solution-templates/layered-web-application/swagger-integration"
"Name": "Background Workers",
"Path": "solution-templates/layered-web-application/background-workers"
},
"Next": {
"Name": "BLOB storing",

2
docs/en/solution-templates/single-layer-web-application/background-workers.md

@ -48,7 +48,7 @@ public class PassiveUserCheckerWorker : AsyncPeriodicBackgroundWorkerBase
}
```
After creating a worker, we should also register it in the related microservice or project. You can register your worker in the `OnApplicationInitializationAsync` method of your module class.
After creating a worker, we should also register it in the application. You can register your worker in the `OnApplicationInitializationAsync` method of your module class.
```csharp
public class BookstoreModule : AbpModule

Loading…
Cancel
Save