feat: implement output caching for various endpoints and introduce BasePageModel for cache management

Author: csharpfritz

Web/Extensions/EndpointExtensions.cs

@@ -8,11 +8,16 @@
 namespace Web.Extensions;
 
 public static class EndpointExtensions
-{
-    public static void MapSitemapEndpoint(this WebApplication app)
+{    public static void MapSitemapEndpoint(this WebApplication app)
     {
         app.MapGet("/sitemap.xml", async (HttpContext context, IContentService contentService) =>
         {
+            // Enable output caching for sitemap
+            context.Response.GetTypedHeaders().CacheControl = new Microsoft.Net.Http.Headers.CacheControlHeaderValue
+            {
+                Public = true,
+                MaxAge = TimeSpan.FromHours(1)
+            };
             // Define the XML namespace for the sitemap
             XNamespace ns = "http://www.sitemaps.org/schemas/sitemap/0.9";
 
@@ -106,13 +111,21 @@ public static void MapSitemapEndpoint(this WebApplication app)
 
             // Return the XML document as a string
             return sitemap.ToString();
-        });
-    }
-
-    public static void MapRssFeedEndpoint(this WebApplication app)
+        })
+        .CacheOutput(policy => policy
+            .Expire(TimeSpan.FromHours(1))
+            .SetVaryByHost(true)
+            .Tag("sitemap"));
+    }    public static void MapRssFeedEndpoint(this WebApplication app)
     {
         app.MapGet("/feed.rss", async (HttpContext context, IContentService contentService) =>
-        {            // Create the RSS feed XML document
+        {
+            // Enable output caching for RSS feed
+            context.Response.GetTypedHeaders().CacheControl = new Microsoft.Net.Http.Headers.CacheControlHeaderValue
+            {
+                Public = true,
+                MaxAge = TimeSpan.FromMinutes(30)
+            };// Create the RSS feed XML document
             var rss = new XDocument(
                 new XDeclaration("1.0", "utf-8", null),
                 new XProcessingInstruction("xml-stylesheet", "type=\"text/xsl\" href=\"/xsl/rss.xsl\""),
@@ -173,6 +186,10 @@ public static void MapRssFeedEndpoint(this WebApplication app)
 
             // Return the XML document as a string
             return rss.ToString();
-        });
+        })
+        .CacheOutput(policy => policy
+            .Expire(TimeSpan.FromMinutes(30))
+            .SetVaryByHost(true)
+            .Tag("rss"));
     }
 }

Web/Pages/About.cshtml.cs

@@ -2,8 +2,11 @@
 
 namespace Web.Pages;
 
-public class AboutModel : PageModel
+public class AboutModel : BasePageModel
 {
+    // Override cache duration for static pages - cache for 1 hour
+    protected override int CacheDurationSeconds => 3600;
+    
     public void OnGet()
     {
     }

Web/Pages/BasePageModel.cs

@@ -0,0 +1,48 @@
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.AspNetCore.Mvc.Filters;
+using Microsoft.AspNetCore.Mvc.RazorPages;
+using Microsoft.AspNetCore.OutputCaching;
+
+namespace Web.Pages;
+
+[OutputCache]
+public abstract class BasePageModel : PageModel
+{
+    /// <summary>
+    /// The default output cache duration for dynamic pages
+    /// </summary>
+    protected virtual int CacheDurationSeconds => 300; // 5 minutes by default
+
+    /// <summary>
+    /// Whether the page allows caching by default
+    /// </summary>
+    protected virtual bool AllowCaching => true;
+
+    /// <summary>
+    /// Configure output caching for the page
+    /// </summary>
+    public override void OnPageHandlerExecuting(PageHandlerExecutingContext context)
+    {
+        base.OnPageHandlerExecuting(context);
+
+        if (AllowCaching && HttpContext.Request.Method == "GET")
+        {
+            // Set cache headers
+            var headers = HttpContext.Response.GetTypedHeaders();
+            headers.CacheControl = new Microsoft.Net.Http.Headers.CacheControlHeaderValue
+            {
+                Public = true,
+                MaxAge = TimeSpan.FromSeconds(CacheDurationSeconds)
+            };
+        }
+    }
+
+    /// <summary>
+    /// Clear the output cache for this page
+    /// </summary>
+    protected async Task InvalidateCache()
+    {
+        var outputCacheStore = HttpContext.RequestServices.GetRequiredService<IOutputCacheStore>();
+        await outputCacheStore.EvictByTagAsync(GetType().FullName!, default);
+    }
+}

Web/Pages/Contribute.cshtml.cs

@@ -2,8 +2,11 @@
 
 namespace Web.Pages;
 
-public class ContributeModel : PageModel
+public class ContributeModel : BasePageModel
 {
+    // Override cache duration for static content - cache for 1 hour
+    protected override int CacheDurationSeconds => 3600;
+    
     public void OnGet()
     {
     }

Web/Pages/Index.cshtml.cs

@@ -5,11 +5,14 @@
 
 namespace Web.Pages;
 
-public class IndexModel : PageModel
+public class IndexModel : BasePageModel
 {
     private readonly ILogger<IndexModel> _logger;
     private readonly IContentService _contentService;
 
+    // Override cache duration for home page - cache for 10 minutes
+    protected override int CacheDurationSeconds => 600;
+    
     public List<TipModel> RecentTips { get; set; } = new();
     public List<string> Categories { get; set; } = new();
     public List<string> PopularTags { get; set; } = new();

Web/Pages/Privacy.cshtml.cs

@@ -3,10 +3,13 @@
 
 namespace Web.Pages;
 
-public class PrivacyModel : PageModel
+public class PrivacyModel : BasePageModel
 {
     private readonly ILogger<PrivacyModel> _logger;
     private readonly IConfiguration _configuration;
+    
+    // Override cache duration for static pages - cache for 1 hour
+    protected override int CacheDurationSeconds => 3600;
 
     public PrivacyModel(ILogger<PrivacyModel> logger, IConfiguration configuration)
     {

Web/Pages/Terms.cshtml.cs

@@ -2,8 +2,11 @@
 
 namespace Web.Pages;
 
-public class TermsModel : PageModel
+public class TermsModel : BasePageModel
 {
+    // Override cache duration for static pages - cache for 1 hour
+    protected override int CacheDurationSeconds => 3600;
+    
     public void OnGet()
     {
     }

Web/Pages/Tips/Category.cshtml.cs

@@ -5,10 +5,13 @@
 
 namespace Web.Pages.Tips;
 
-public class CategoryModel : PageModel
+public class CategoryModel : BasePageModel
 {
     private readonly IContentService _contentService;
     private readonly ILogger<CategoryModel> _logger;
+    
+    // Override cache duration for category pages - cache for 5 minutes
+    protected override int CacheDurationSeconds => 300;
 
     public CategoryModel(IContentService contentService, ILogger<CategoryModel> logger)
     {

Web/Pages/Tips/Details.cshtml.cs

@@ -5,10 +5,13 @@
 
 namespace Web.Pages.Tips;
 
-public class DetailsModel : PageModel
+public class DetailsModel : BasePageModel
 {
     private readonly IContentService _contentService;
     private readonly ILogger<DetailsModel> _logger;
+    
+    // Override cache duration for individual tips - cache for 1 hour since they change less frequently
+    protected override int CacheDurationSeconds => 3600;
 
     public DetailsModel(IContentService contentService, ILogger<DetailsModel> logger)
     {

Web/Pages/Tips/Index.cshtml.cs

@@ -5,10 +5,13 @@
 
 namespace Web.Pages.Tips;
 
-public class IndexModel : PageModel
+public class IndexModel : BasePageModel
 {
     private readonly IContentService _contentService;
     private readonly ILogger<IndexModel> _logger;
+    
+    // Override cache duration for tips list - cache for 5 minutes
+    protected override int CacheDurationSeconds => 300;
 
     public IndexModel(IContentService contentService, ILogger<IndexModel> logger)
     {