Spring Boot loading static content

We will try to quickly how to go about loading and serving static content using Spring Boot 2. There was a difference in how boot 2.0.0 was loading static resources to 2.1 version now. In this article, we will take a simple web application and load the static resources that are defined in the resource folder.


Here is how the project is setup for this article.



I decoupled the pom as a parent and one for the web project. Spring by default without any config changes loads static content from the path that is defined in ResourceWebHandler. But in the article we are going to overwrite the default path.


We first over-ride the classWebMVCConfigurer. The sample snippet of override is.,


public class BootSamplerWebAppWebConfigurer implements WebMvcConfigurer{
public void addResourceHandlers(ResourceHandlerRegistry registry) {
registry.addResourceHandler("/pages/", "/error/","/images"));

public void addViewControllers(ViewControllerRegistry registry) {


As we can see, there are the class couple of methods that we override to tell boot where our static resources are located. I don’t like the favicon that comes from spring framework. So here is the code to serve favicon static content. Here is the code to override that.


public class BootSamplerFavIconConfiguration {
public SimpleUrlHandlerMapping customFavIconHandlerMapping() {
SimpleUrlHandlerMapping simpleUrlHandlerMapping = new SimpleUrlHandlerMapping();
simpleUrlHandlerMapping.setUrlMap(Collections.singletonMap("/favicon.ico", faviconRequestHandler()));
return simpleUrlHandlerMapping;

public ResourceHttpRequestHandler faviconRequestHandler() {
ResourceHttpRequestHandler resourceHttpRequestHandler = new ResourceHttpRequestHandler();
ClassPathResource classPathResource = new ClassPathResource("/static/images/favicon.ico");
List<Resource> locations = Arrays.asList(classPathResource);
return resourceHttpRequestHandler;


Error pages are from a static content directory, we will have to override the class ErrorrPageRegistar


public class BootSamplerWebAppErrorRegistrar implements ErrorPageRegistrar {

public void registerErrorPages(ErrorPageRegistry registry) {
registry.addErrorPages(new ErrorPage(HttpStatus.NOT_FOUND, "/error/404.html"));
registry.addErrorPages(new ErrorPage(HttpStatus.BAD_REQUEST, "/error/400.html"));


The main method to run the application has some tweaks, here is the code block for that.


@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class,
public class MainApp extends SpringBootServletInitializer {
public static void main(String[] args) {
final SpringApplication springApplication =
new SpringApplication(BootSamplerWebAppErrorRegistrar.class,
BootSamplerWebAppWebConfigurer.class, BootSamplerFavIconConfiguration.class,


When running the, we should get index.html served from the folder main . The template for this index is from the bootstrap template blackrock digital.



Finally all code for this is in github.

Winter 2019.

This is the coldest day that I have ever seen in my lifetime. The weather was at -27 and the windchill was at -35. I was so bummed with the fact that there is literally nothing you can do except for watch the time pass by. A picture to remember the year and time.

Missed items of this year.

There are several things that I wanted to accomplish this year:

  • Do a blog post regularly No success
  • Complete all the freecodecamp certificates
    • The changes came, and boatload new challenges that got added, unable to complete all the certifications.
    • Finished at least a couple of them.
      Hoping to finish the reminder this year as part of the #100daysofcode
  • Complete Venkat’s concurrency course. That was one heck of a head spinner, but glad was able to watch it and get a little bit of hang of it.
  • Complete the Bealdung’s Spring Rest Course. Done with 53% of it :-). I loved going over this.
    • Start writing technical articles for Baeldung. But I got good feedback from them and was asked to think about writing for them!!
  • Completed certification for a modern era’s PowerBuilder tool called onBase. An impressive suite of tools for doing a lot of business automation, but learning it gave me the feeling that I was back to good old PowerBuilder programming days.
  • Completed the Scrum certification. Yep effective this year am officially a scrum master for next two years until I keep up with CE.
  • Renewed PMI certification with some bootstrap courses.
  • I went to get trained in AWS and Azure. The love of DevOps has multiplied like crazy. Hopefully, I will be able to contribute time to this community.
  • Am yet to submit my iPhone app to the app store. Probably that would be the first thing I will be working this year.

Best podcast for the year

  • Believed If you have not heard this, you should start right away.

Best Binge watched show

Best product that I bought this year

Best app development product I used for the year

Design benchmarks

This is a long-form write-up. The comment that goes something like this.,

Which means that the people who speak louder online, with higher frequency and reach, are not necessarily the ones striving for Independence, Depth, Honesty, or Breadth through the content they create. They are not necessarily the ones equipped with the experience and knowledge required to share thoughts that will provoke change in our industry.

This is such a genuine opinion, beats the odds that, if you are an individual who is an industry trendsetter, then you do not have time to write about the content that you are working on. So anyone who has the power and time to write will have a perspective on how design should be.


Quickest way of getting an custom error message in Spring Boot 2.x

There are different ways to get a custom error message page in spring boot. The following solution worked for my web project. Here is the overview of the structure.

Pic Pic

To start with, if there is 404 error, then we want a custom error page showing up instead of the spring boot’s default page.
The first thing we are going handle is to suppress the boot framework’s error page. For this, we will go to the application properties and add the following line


As we are done with that, now let us implement the ErrorController interface. The thing to keep in mind is, we have the LOG entry that says what happened to the code base as we reached here. Here is the sample code.


public class ITContractErrorController implements ErrorController     {
    public static final Logger LOG = LoggerFactory.getLogger(ITContractErrorController.class);
    ErrorAttributes errorAttributes;
    public String handleError() {
        LOG.error("Sever error occured");
        return "/error/error.html";
public String getErrorPath() {
    return "error";

One other way that we can add the custom error message is using the Spring 2.x’s ConfigurableServletWebServerFactory implementation. We add this to the main method of the web module. Here is the sample code for this entry.


public class SkminfycontractorWebmoduleApplication {
    public ConfigurableServletWebServerFactory         containerCustomizer(){
        TomcatServletWebServerFactory factory = new     TomcatServletWebServerFactory();
        factory.addErrorPages(new ErrorPage(HttpStatus.NOT_FOUND,     "/error/error.html"));
        return factory;
    public static void main(String[] args) {
        SpringApplication.run(SkminfycontractorWebmoduleApplication.class, args);

One thing to remember is, when we implement the override with ConfigurableServeletFactory then Override that is ErrorController is gone.

There is a lot of best practice information laid out in spring documentation and other places. But none worked for my setup. I will update this entry if I find a more interesting solution.