Prerendering your Blazor WASM application with .NET 5 (part 2 - solving the missing HttpClient problem)

October 9, 2020 · 8 minute read · Tags: blazor | prerendering

In part 1 we saw how to set up your Blazor WASM site for prerendering.

This means you can serve your application nice and quickly to your users without making them wait for Blazor WASM to finish loading.

However, we were left with a bit of a problem.

When you navigate to the /FetchData page and hit refresh you get an error that HttpClient hasn’t been registered.

InvalidOperationException: Cannot provide a value for property ‘Http’ on type ‘ExampleApp.Client.Pages.FetchData’. There is no registered service of type ‘System.Net.Http.HttpClient’.

Here’s the problem:

If you attempt to navigate directly to FetchData your Server app will attempt to prerender it (just as it did with Counter or any of the other components).

However, this means it will attempt to execute OnInitializedAsync on the server, at which point it will attempt to retrieve the weather data using HttpClient.

The problem is, we haven’t registered HttpClient as a dependency in the Server project, so it falls over.

Now we could just go ahead and register HttpClient in the Server project’s Startup.cs file, however then we’d be using HTTP to go from the Server project to itself, just to load the weather data!

Dan Roth’s .NET 5 samples demonstrate a handy alternative way to address this problem.

If we abstract away the logic for retrieving weather data we can make sure it works on both the server and the client.

Unleash Blazor's Potential

Blazor promises to make it much easier (and faster) to build modern, responsive web applications, using the tools you already know and understand.

Subscribe to my Practical ASP.NET Blazor newsletter and get instant access to the vault.

In there you'll find step-by-step tutorials, source code and videos to help you get up and running using Blazor's component model.

I respect your email privacy. Unsubscribe with one click.

    Another layer of abstraction

    Currently FetchData.razor uses the HTTPClient directly…

    FetchData.razor (markup)

    @page "/fetchdata"
    @inject HttpClient Http
    
    <!-- weather markup -->
    
    @code {
        private WeatherForecast[] forecasts;
    
        protected override async Task OnInitializedAsync()
        {
            forecasts = await Http.GetFromJsonAsync<WeatherForecast[]>("WeatherForecast");
        }
    }
    

    This makes a HTTP call to the API exposed by the Server project.

    This call will fail when prerendering because the Server project hasn’t been configured to know anything about HttpClient.

    If we adopt Dan’s approach we can replace this with a call to an interface.

    FetchData.razor (markup)

    @page "/fetchdata"
    @inject IWeatherForecastService WeatherForecastService
    
    <!-- weather markup -->
    
    @code {
        private WeatherForecast[] forecasts;
    
        protected override async Task OnInitializedAsync()
        {
            forecasts = await WeatherForecastService.GetForecastAsync();
        }
    }
    

    We’ll need to define the interface itself. This needs to go in the Shared project so both Client and Server can access it.

    Shared\IWeatherForecastService.cs

    namespace ExampleApp.Shared
    {
        public interface IWeatherForecastService
        {
            Task<WeatherForecast[]> GetForecastAsync();
        }
    }
    

    Now we can create two implementations of that interface.

    Get weather data on the client (in the browser)

    When running on the client we still need to fetch the data via an HTTP GET request to the server.

    So this implementation (Client.Data.WeatherForecastService) can make the exact same HTTP call our component was making directly before.

    Client\Data\WeatherForecastService.cs

    using System.Net.Http;
    using System.Net.Http.Json;
    using System.Threading.Tasks;
    using ExampleApp.Shared;
    
    namespace ExampleApp.Client.Data
    {
        public class WeatherForecastService : IWeatherForecastService
        {
            private readonly HttpClient _httpClient;
    
            public WeatherForecastService(HttpClient httpClient)
            {
                _httpClient = httpClient;
            }
            
            public async Task<WeatherForecast[]> GetForecastAsync()
            {
                return await _httpClient.GetFromJsonAsync<WeatherForecast[]>("WeatherForecast");
            }
        }
    }
    

    Get weather data on the server

    For the server implementation we don’t need to go via HTTP and can instead fetch the weather data directly (in a more realistic scenario this would likely come from a query to a database or similar).

    To make this work we can take the code which currently lives in the WeatherForecastController and move it into a new WeatherForecastService class.

    Server\Data\WeatherForecastService.cs

    namespace ExampleApp.Server.Data
    {
        public class WeatherForecastService : IWeatherForecastService
        {
            private static readonly string[] Summaries = new[]
            {
                "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
            };
    
            public async Task<WeatherForecast[]> GetForecastAsync()
            {
                var rng = new Random();
                return Enumerable.Range(1, 5).Select(index => new WeatherForecast
                    {
                        Date = DateTime.Now.AddDays(index),
                        TemperatureC = rng.Next(-20, 55),
                        Summary = Summaries[rng.Next(Summaries.Length)]
                    })
                    .ToArray();
            }
        }
    }
    

    This wil be invoked by the FetchData.razor component when it’s initially (pre)rendered on the server.

    Now we need to replace the code in WeatherForecastController with a call to this service.

    [ApiController]
    [Route("[controller]")]
    public class WeatherForecastController : ControllerBase
    {
        private readonly IWeatherForecastService _weatherForecastService;
    
        public WeatherForecastController(IWeatherForecastService weatherService)
        {
            _weatherForecastService = weatherService;
        }
    
        [HttpGet]
        public async Task<IEnumerable<WeatherForecast>> Get()
        {
            return await _weatherForecastService.GetForecastAsync();
        }
    }
    

    Register the two implementations of IWeatherForecastService

    Now we need to make sure we register the relevant implementations in each project.

    Client\Program.cs

    using ExampleApp.Client.Data;
    using ExampleApp.Shared;
    
    public class Program
    {
        public static async Task Main(string[] args){
            
            //other code
            
            builder.Services.AddScoped<IWeatherForecastService, WeatherForecastService>();
    
            await builder.Build().RunAsync();
        }
    }
    

    Server\Startup.cs

    using ExampleApp.Server.Data;
    using ExampleApp.Shared;
    
     public class Startup
        {
            public void ConfigureServices(IServiceCollection services)
            {
                // other code
    
                services.AddScoped<IWeatherForecastService, WeatherForecastService>();
            }
        }
    

    With that, when the app is prerendered it will use Server.Data.WeatherForecastService on the server.

    When running in the browser it will use Client.Data.WeatherForecastService (which uses HttpClient but ultimately executes the same code in the server project, via Web API).

    OnInitializedAsync is called twice

    The final thing to note here is that data will be retrieved twice when prerendering this way; once on the server when prerendering, then again on the client when Blazor WASM has finished loading.

    This is really obvious when viewing the weather example because it’s random data so you see it appear then change when Blazor WASM kicks in…

    At the time of writing the only guidance I can find from Microsoft about how to handle this refers to Blazor Server app prerendering, but unless I’m missing something it would apply here too…

    The suggested solution is to cache the data on the server.

    This doesn’t stop the second call being made to but it does reduce round trips to your database and also ensures the data is consistent between the prerender and subsequent client-side render.

    I’ve seen two ways to do this:

    Use memory cache

    One option is to add a little memory caching to the server version implementation of IWeatherForecastService.

    Server\Data\WeatherForecastService

    public class WeatherForecastService : IWeatherForecastService
    {
        private static readonly string[] Summaries = new[]
        {
            "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
        };
    
        private readonly IMemoryCache _memoryCache;
    
        public WeatherForecastService(IMemoryCache memoryCache)
        {
            _memoryCache = memoryCache;
        }
    
        public async Task<WeatherForecast[]> GetForecastAsync()
        {
            return await _memoryCache.GetOrCreateAsync("WeatherData", e =>
            {
                e.SetOptions(new MemoryCacheEntryOptions
                {
                    AbsoluteExpirationRelativeToNow = TimeSpan.FromSeconds(30)
                });
                
                var rng = new Random();
                return Task.FromResult(Enumerable.Range(1, 5).Select(index => new WeatherForecast
                    {
                        Date = DateTime.Now.AddDays(index),
                        TemperatureC = rng.Next(-20, 55),
                        Summary = Summaries[rng.Next(Summaries.Length)]
                    })
                    .ToArray());
            });
        }
    }
    

    This ensures the exact same data will be returned from memory for the second request (or indeed for any other requests made within the 30 seconds before the cached entry expires).

    Make the service a singleton

    In Dan Roth’s .NET 5 samples it wasn’t initially clear to me why the “random” data remained consistent between the two renders, then I spotted the answer!

    He has the WeatherForecastService registered as a singleton in Server\Startup.cs.

    services.AddSingleton<IWeatherForecastService, WeatherForecastService>();
    

    The GetForecast method in Server.Data.WeatherForecastService then adds forecasts to a _forecasts field, until a certain count has been reached.

    Server\Data\WeatherForecastService.cs

    private readonly List<WeatherForecast> forecasts = new List<WeatherForecast>();
    
    public async Task<WeatherForecast[]> GetForecastAsync(int daysFromNow, int count)
    {
        await Task.Delay(Math.Min(count * 20, 2000));
    
        var rng = new Random();
    
        while (forecasts.Count < daysFromNow + count)
        {
            forecasts.Add(new WeatherForecast
            {
                Date = DateTime.Today.AddDays(forecasts.Count),
                TemperatureC = rng.Next(-20, 55),
                Summary = Summaries[rng.Next(Summaries.Length)]
            });
        }
    
        return forecasts.Skip(daysFromNow).Take(count).ToArray();
    }
    

    This means there’s just one instance of this service in memory running on the server, so it doesn’t matter how many times you call this method, if you’re passing the same arguments you’ll get the same data back.

    Effectively this is also an in-memory cache, just implemented in a slightly different way…

    In summary

    It’s entirely possible to make your data fetching (and calls to other services) work when you opt to prerender your Blazor WASM application.

    You just have to be aware that your component’s OnInitializedAsync method will be called twice.

    You can use an interface to abstract the logic for this, then have a client implementation which delegates to HTTP to fetch the data (when running on the client) and a server implementation which fetches the data directly.

    When prerendering OnInitializedAsync will be called twice (once on the server, then again on the client) for any components that are prerendered on the server.

    You can mitigate this by using caching to avoid roundtrips to your database etc. and to ensure consistent data is returned in both cases.

    Grab the source code for the completed example here.

    Further reading

    Join the Practical ASP.NET Newsletter

    Ship better Blazor apps, faster. One practical tip every Tuesday.

    I respect your email privacy. Unsubscribe with one click.

      Next up

      The quickest way to integrate PayPal checkout with Blazor SSR in .NET 8
      JavaScript Interop works differently with Blazor Server-side rendering
      Interactive what now? Deciphering Blazor’s web app project template options
      Create a new Blazor Web App and you’ll be asked how you want interactivity to work, but what does it all mean?
      Should I put my Blazor components in the server project, or the client project?
      .NET 8 gives you a choice of projects, which one should you use?