< Summary

Information
Class: Elsa.Workflows.Management.Services.CachingWorkflowDefinitionService
Assembly: Elsa.Workflows.Management
File(s): /home/runner/work/elsa-core/elsa-core/src/modules/Elsa.Workflows.Management/Services/CachingWorkflowDefinitionService.cs
Line coverage
98%
Covered lines: 97
Uncovered lines: 1
Coverable lines: 98
Total lines: 200
Line coverage: 98.9%
Branch coverage
91%
Covered branches: 11
Total branches: 12
Branch coverage: 91.6%
Method coverage

Feature is only available for sponsors

Upgrade to PRO version

Metrics

File(s)

/home/runner/work/elsa-core/elsa-core/src/modules/Elsa.Workflows.Management/Services/CachingWorkflowDefinitionService.cs

#LineLine coverage
 1using Elsa.Common.Models;
 2using Elsa.Workflows.Management.Entities;
 3using Elsa.Workflows.Management.Filters;
 4using Elsa.Workflows.Management.Models;
 5using Elsa.Workflows.Models;
 6using JetBrains.Annotations;
 7using Microsoft.Extensions.Caching.Memory;
 8
 9namespace Elsa.Workflows.Management.Services;
 10
 11/// <summary>
 12/// Decorates an <see cref="IWorkflowDefinitionService"/> with caching capabilities.
 13/// </summary>
 14[UsedImplicitly]
 45415public class CachingWorkflowDefinitionService(
 45416    IWorkflowDefinitionService decoratedService,
 45417    IWorkflowDefinitionCacheManager cacheManager,
 45418    IWorkflowDefinitionStore workflowDefinitionStore,
 45419    IMaterializerRegistry materializerRegistry) : IWorkflowDefinitionService
 20{
 21    /// <inheritdoc />
 22    public Task<WorkflowGraph> MaterializeWorkflowAsync(WorkflowDefinition definition, CancellationToken cancellationTok
 23    {
 226924        return decoratedService.MaterializeWorkflowAsync(definition, cancellationToken);
 25    }
 26
 27    /// <inheritdoc />
 28    public async Task<WorkflowDefinition?> FindWorkflowDefinitionAsync(string definitionId, VersionOptions versionOption
 29    {
 430        var cacheKey = cacheManager.CreateWorkflowDefinitionVersionCacheKey(definitionId, versionOptions);
 31
 432        return await FindFromCacheAsync(cacheKey,
 433            () => decoratedService.FindWorkflowDefinitionAsync(definitionId, versionOptions, cancellationToken),
 834            x => x.DefinitionId);
 435    }
 36
 37    /// <inheritdoc />
 38    public async Task<WorkflowDefinition?> FindWorkflowDefinitionAsync(string definitionVersionId, CancellationToken can
 39    {
 240        var cacheKey = cacheManager.CreateWorkflowDefinitionVersionCacheKey(definitionVersionId);
 241        return await FindFromCacheAsync(cacheKey,
 242            () => decoratedService.FindWorkflowDefinitionAsync(definitionVersionId, cancellationToken),
 443            x => x.DefinitionId);
 244    }
 45
 46    /// <inheritdoc />
 47    public Task<WorkflowDefinition?> FindWorkflowDefinitionAsync(WorkflowDefinitionHandle handle, CancellationToken canc
 48    {
 149        var filter = handle.ToFilter();
 150        return FindWorkflowDefinitionAsync(filter, cancellationToken);
 51    }
 52
 53    /// <inheritdoc />
 54    public async Task<WorkflowDefinition?> FindWorkflowDefinitionAsync(WorkflowDefinitionFilter filter, CancellationToke
 55    {
 110356        var cacheKey = cacheManager.CreateWorkflowDefinitionFilterCacheKey(filter);
 110357        return await FindFromCacheAsync(cacheKey,
 38358            () => decoratedService.FindWorkflowDefinitionAsync(filter, cancellationToken),
 148659            x => x.DefinitionId);
 110360    }
 61
 62    /// <inheritdoc />
 63    public async Task<WorkflowGraph?> FindWorkflowGraphAsync(string definitionId, VersionOptions versionOptions, Cancell
 64    {
 3665        var cacheKey = cacheManager.CreateWorkflowVersionCacheKey(definitionId, versionOptions);
 3666        return await FindFromCacheAsync(cacheKey,
 1967            () => decoratedService.FindWorkflowGraphAsync(definitionId, versionOptions, cancellationToken),
 5468            x => x.Workflow.Identity.DefinitionId);
 3669    }
 70
 71    /// <inheritdoc />
 72    public async Task<WorkflowGraph?> FindWorkflowGraphAsync(string definitionVersionId, CancellationToken cancellationT
 73    {
 122574        var cacheKey = cacheManager.CreateWorkflowVersionCacheKey(definitionVersionId);
 122575        return await FindFromCacheAsync(cacheKey,
 12576            () => decoratedService.FindWorkflowGraphAsync(definitionVersionId, cancellationToken),
 135077            x => x.Workflow.Identity.DefinitionId);
 122578    }
 79
 80    /// <inheritdoc />
 81    public Task<WorkflowGraph?> FindWorkflowGraphAsync(WorkflowDefinitionHandle definitionHandle, CancellationToken canc
 82    {
 183        var filter = definitionHandle.ToFilter();
 184        return FindWorkflowGraphAsync(filter, cancellationToken);
 85    }
 86
 87    /// <inheritdoc />
 88    public async Task<WorkflowGraph?> FindWorkflowGraphAsync(WorkflowDefinitionFilter filter, CancellationToken cancella
 89    {
 90        // Resolve the definition first (already cached by FindWorkflowDefinitionAsync) so the
 91        // WorkflowGraph ends up under the stable per-version-ID key rather than a filter-hash key
 92        // that can never be shared with the other FindWorkflowGraphAsync overloads.
 22193        var definition = await FindWorkflowDefinitionAsync(filter, cancellationToken);
 22194        return await FindWorkflowGraphForDefinitionAsync(definition, cancellationToken);
 22195    }
 96
 97    /// <inheritdoc />
 98    public async Task<IEnumerable<WorkflowGraph>> FindWorkflowGraphsAsync(WorkflowDefinitionFilter filter, CancellationT
 99    {
 3100        var workflowDefinitions = await workflowDefinitionStore.FindManyAsync(filter, cancellationToken);
 3101        var workflowGraphs = new List<WorkflowGraph>();
 16102        foreach (var workflowDefinition in workflowDefinitions)
 103        {
 5104            var workflowGraph = await FindWorkflowGraphForDefinitionAsync(workflowDefinition, cancellationToken);
 5105            if (workflowGraph != null)
 4106                workflowGraphs.Add(workflowGraph);
 107        }
 108
 3109        return workflowGraphs;
 3110    }
 111
 112    /// <inheritdoc />
 113    public async Task<WorkflowGraphFindResult> TryFindWorkflowGraphAsync(string definitionId, VersionOptions versionOpti
 114    {
 1115        var definition = await FindWorkflowDefinitionAsync(definitionId, versionOptions, cancellationToken);
 1116        var workflowGraph = await FindWorkflowGraphForDefinitionAsync(definition, cancellationToken);
 1117        return new(definition, workflowGraph);
 1118    }
 119
 120    /// <inheritdoc />
 121    public async Task<WorkflowGraphFindResult> TryFindWorkflowGraphAsync(string definitionVersionId, CancellationToken c
 122    {
 1123        var definition = await FindWorkflowDefinitionAsync(definitionVersionId, cancellationToken);
 1124        var workflowGraph = await FindWorkflowGraphForDefinitionAsync(definition, cancellationToken);
 1125        return new(definition, workflowGraph);
 1126    }
 127
 128    /// <inheritdoc />
 129    public Task<WorkflowGraphFindResult> TryFindWorkflowGraphAsync(WorkflowDefinitionHandle definitionHandle, Cancellati
 130    {
 207131        var filter = definitionHandle.ToFilter();
 207132        return TryFindWorkflowGraphAsync(filter, cancellationToken);
 133    }
 134
 135    /// <inheritdoc />
 136    public async Task<WorkflowGraphFindResult> TryFindWorkflowGraphAsync(WorkflowDefinitionFilter filter, CancellationTo
 137    {
 208138        var definition = await FindWorkflowDefinitionAsync(filter, cancellationToken);
 208139        var workflowGraph = await FindWorkflowGraphForDefinitionAsync(definition, cancellationToken);
 208140        return new(definition, workflowGraph);
 208141    }
 142
 143    /// <inheritdoc />
 144    public async Task<IEnumerable<WorkflowGraphFindResult>> TryFindWorkflowGraphsAsync(WorkflowDefinitionFilter filter, 
 145    {
 3146        var workflowDefinitions = await workflowDefinitionStore.FindManyAsync(filter, cancellationToken);
 3147        var results = new List<WorkflowGraphFindResult>();
 14148        foreach (var workflowDefinition in workflowDefinitions)
 149        {
 4150            var workflowGraph = await FindWorkflowGraphForDefinitionAsync(workflowDefinition, cancellationToken);
 4151            results.Add(new WorkflowGraphFindResult(workflowDefinition, workflowGraph));
 4152        }
 153
 3154        return results;
 3155    }
 156
 157    private async Task<T?> FindFromCacheAsync<T>(string cacheKey, Func<Task<T?>> getObjectFunc, Func<T, string> getChang
 158    {
 2370159        var cache = cacheManager.Cache;
 2370160        return await cache.FindOrCreateAsync(cacheKey, async entry =>
 2370161        {
 533162            entry.SetAbsoluteExpiration(cache.CachingOptions.Value.CacheDuration);
 533163            var obj = await getObjectFunc();
 2370164
 533165            if (obj != null)
 2370166            {
 532167                var changeTokenKey = cacheManager.CreateWorkflowDefinitionChangeTokenKey(getChangeTokenKeyFunc(obj));
 532168                entry.AddExpirationToken(cache.GetToken(changeTokenKey));
 2370169            }
 2370170
 533171            return obj;
 2903172        });
 2370173    }
 174
 175    /// <summary>
 176    /// Returns the <see cref="WorkflowGraph"/> for the given definition, using the per-version-ID cache entry
 177    /// that is shared with <see cref="FindWorkflowGraphAsync(string,CancellationToken)"/>.
 178    /// Returns <c>null</c> when the definition is <c>null</c> or its materializer is unavailable.
 179    /// </summary>
 180    private async Task<WorkflowGraph?> FindWorkflowGraphForDefinitionAsync(WorkflowDefinition? definition, CancellationT
 181    {
 440182        if (definition == null)
 0183            return null;
 184
 440185        if (!materializerRegistry.IsMaterializerAvailable(definition.MaterializerName))
 4186            return null;
 187
 436188        var cacheKey = cacheManager.CreateWorkflowVersionCacheKey(definition.Id);
 436189        var cache = cacheManager.Cache;
 436190        return await cache.GetOrCreateAsync(cacheKey, async entry =>
 436191        {
 248192            entry.SetAbsoluteExpiration(cache.CachingOptions.Value.CacheDuration);
 248193            var graph = await MaterializeWorkflowAsync(definition, cancellationToken);
 248194            var changeTokenKey = cacheManager.CreateWorkflowDefinitionChangeTokenKey(graph.Workflow.Identity.DefinitionI
 248195            entry.AddExpirationToken(cache.GetToken(changeTokenKey));
 248196            return graph;
 684197        });
 440198    }
 199
 200}