Spring Boot and Mustache Tutorial

View more categories:

1- What is Mustache?

Mustache is a   Web Template system, which is used in combination with the data of  Model layer to create HTML files. It is supported by many languages such as  Java, ActionScript, C++, Clojure, CoffeeScript, ColdFusion, PHP, ....
Mustache is described as a logic-less system, because it does not has statement controlling the flow of the program clearly, for example, it has no if/else statement and loop statement, it uses lambda expression and mustache tags instead.
Assume that "employees"  is a list. In this context, open & close tag pairs: {{#employees}} &  {{/employees}} will be equivalent to a loop in the "employees" list.
The reason it is named   "Mustache" is that the syntax of the Mustache usually uses curly brackets {}, like a pair of  mustaches

2- Some examples of Mustache

You will probably meet with some trouble and confusion with the Mustache for its first time of working with it. Below are some examples, which show the oddity of this system.


Mustache doesn't simply have   if/else condition statement, therefore, you have to create  logic for it.
Java Code:
boolean kiss = true;

boolean hug = true;

boolean slap = false;
Mustache Template:
  Kiss ...

  Hug ...

  Hic Hic ...
Kiss ...
Hug ...


In the  Mustache, {{.}} is a special tag. Please look at an example:
If you have the data as follows:
int[] numbers = new int[] {1, 2, 3, 4, 5};

String string =  "Wheee!";
Mustache Template:
{{# numbers }}
* {{ . }}
{{/ numbers }}


{{# string }}
   {{ . }}
{{/ string }}
The result received:
* 1
* 2
* 3
* 4
* 5



3- Create a Spring Boot project

On the  Eclipse, create a Spring Boot project:
To be able to use the  Mustache for View layer, you need to declare  spring-boot-starter-mustache dependency in the   pom.xml file:
The full content of the  pom.xml file:
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"


    <description>Spring Boot + Groovy</description>

        <relativePath/> <!-- lookup parent from repository -->





package org.o7planning.sbmustache;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

public class SpringBootMustacheApplication {

    public static void main(String[] args) {
        SpringApplication.run(SpringBootMustacheApplication.class, args);

4- Model, DAO

package org.o7planning.sbmustache.model;

import java.util.Date;

public class Employee {

    private Long empId;
    private String empNo;
    private String empName;
    private Date hireDate;

    public Employee() {


    public Employee(Long empId, String empNo,
            String empName, Date hireDate) {
        this.empId = empId;
        this.empNo = empNo;
        this.empName = empName;
        this.hireDate = hireDate;

    public Long getEmpId() {
        return empId;

    public void setEmpId(Long empId) {
        this.empId = empId;

    public String getEmpNo() {
        return empNo;

    public void setEmpNo(String empNo) {
        this.empNo = empNo;

    public String getEmpName() {
        return empName;

    public void setEmpName(String empName) {
        this.empName = empName;

    public Date getHireDate() {
        return hireDate;

    public void setHireDate(Date hireDate) {
        this.hireDate = hireDate;
package org.o7planning.sbmustache.dao;

import java.sql.Date;
import java.time.LocalDate;
import java.util.ArrayList;
import java.util.List;

import org.o7planning.sbmustache.model.Employee;
import org.springframework.stereotype.Repository;

public class EmployeeDAO {

    public List<Employee> getEmployees()  {
        Date hireDate1= Date.valueOf(LocalDate.parse("2000-12-11"));
        Employee e1= new Employee(1L, "E01", "Tom", hireDate1);
        Date hireDate2= Date.valueOf(LocalDate.parse("2001-12-21"));
        Employee e2= new Employee(2L, "E02", "Jerry", hireDate2);
        List<Employee> list= new ArrayList<Employee>();
        return list;        

5- Controller, Mustache Template

package org.o7planning.sbmustache.controller;

import java.util.List;

import org.o7planning.sbmustache.dao.EmployeeDAO;
import org.o7planning.sbmustache.model.Employee;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;

public class MainController {

    private EmployeeDAO employeeDAO;

    public String handleRequest(Model model) {

        List<Employee> employees = employeeDAO.getEmployees();
        model.addAttribute("employees", employees);
        return "employee";

Create an  employee.mustache file located in the  resources/templates folder of the project.
Note: If you use  Spring Boot < 2.x , then   Mustache Template files must have the ending in html. Thus, you need to create an   employee.html file.
<title>Spring Boot Mustache</title>
table {
    border-collapse: collapse;

table, td, th {
    border: 1px solid #999;
    padding: 5px;
            <th>Emp Id</th>
            <th>Emp No</th>
            <th>Emp Name</th>
            <th>Hire Date</th>


The Spring Boot 2.x automatically configures the  Mustache with  the following default properties:
application.properties (Default by Spring Boot)
The drawing describes the flow of the application and the relationship between the Controller and Mustache View:

6- Run the application

Right click on the Project, select:
  • Run As/Spring Boot App
Then, access the address:

View more categories: