JAVA-3543: Move spring-thymeleaf into spring-web-modules

spring-web-modules/spring-thymeleaf/README.md

@@ -0,0 +1,36 @@
+## Spring Thymeleaf 
+
+This module contains articles about Spring with Thymeleaf
+
+### Relevant Articles: 
+- [Introduction to Using Thymeleaf in Spring](https://www.baeldung.com/thymeleaf-in-spring-mvc)
+- [CSRF Protection with Spring MVC and Thymeleaf](https://www.baeldung.com/csrf-thymeleaf-with-spring-security)
+- [Thymeleaf: Custom Layout Dialect](https://www.baeldung.com/thymeleaf-spring-layouts)
+- [Spring and Thymeleaf 3: Expressions](https://www.baeldung.com/spring-thymeleaf-3-expressions)
+- [Spring MVC + Thymeleaf 3.0: New Features](https://www.baeldung.com/spring-thymeleaf-3)
+- [How to Work with Dates in Thymeleaf](https://www.baeldung.com/dates-in-thymeleaf)
+- [Working with Fragments in Thymeleaf](https://www.baeldung.com/spring-thymeleaf-fragments)
+- [Conditionals in Thymeleaf](https://www.baeldung.com/spring-thymeleaf-conditionals)
+- [Iteration in Thymeleaf](https://www.baeldung.com/thymeleaf-iteration)
+- [Spring with Thymeleaf Pagination for a List](https://www.baeldung.com/spring-thymeleaf-pagination)
+- [[next -->]](/spring-thymeleaf-2)
+
+### Build the Project
+
+mvn clean install
+
+### Run the Project
+
+mvn cargo:run
+- **note**: starts on port '8082'
+
+Access the pages using the URLs:
+
+ - http://localhost:8082/spring-thymeleaf/
+ - http://localhost:8082/spring-thymeleaf/addStudent/
+ - http://localhost:8082/spring-thymeleaf/listStudents/
+
+The first URL is the home page of the application. The home page has links to the second and third pages.
+
+### Security
+The user/password required is: user1/user1Pass

spring-web-modules/spring-thymeleaf/pom.xml

@@ -0,0 +1,159 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <artifactId>spring-thymeleaf</artifactId>
+    <version>0.1-SNAPSHOT</version>
+    <name>spring-thymeleaf</name>
+    <packaging>war</packaging>
+
+    <parent>
+        <groupId>com.baeldung</groupId>
+        <artifactId>parent-spring-5</artifactId>
+        <version>0.0.1-SNAPSHOT</version>
+        <relativePath>../../parent-spring-5</relativePath>
+    </parent>
+
+    <dependencies>
+        <!-- Spring -->
+        <dependency>
+            <groupId>org.springframework</groupId>
+            <artifactId>spring-context</artifactId>
+            <version>${spring.version}</version>
+            <exclusions>
+                <!-- Exclude Commons Logging in favor of SLF4j -->
+                <exclusion>
+                    <groupId>commons-logging</groupId>
+                    <artifactId>commons-logging</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework</groupId>
+            <artifactId>spring-webmvc</artifactId>
+            <version>${spring.version}</version>
+        </dependency>
+
+        <dependency>
+            <groupId>org.springframework.data</groupId>
+            <artifactId>spring-data-commons</artifactId>
+            <version>${spring-data.version}</version>
+        </dependency>
+
+        <dependency>
+            <groupId>javax.validation</groupId>
+            <artifactId>validation-api</artifactId>
+            <version>${javax.validation-version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.hibernate.validator</groupId>
+            <artifactId>hibernate-validator</artifactId>
+            <version>${hibernate-validator.version}</version>
+        </dependency>
+
+        <!-- Spring Security -->
+        <dependency>
+            <groupId>org.springframework.security</groupId>
+            <artifactId>spring-security-web</artifactId>
+            <version>${spring-security.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.security</groupId>
+            <artifactId>spring-security-config</artifactId>
+            <version>${spring-security.version}</version>
+        </dependency>
+
+        <!-- Thymeleaf -->
+        <dependency>
+            <groupId>org.thymeleaf</groupId>
+            <artifactId>thymeleaf</artifactId>
+            <version>${org.thymeleaf-version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.thymeleaf</groupId>
+            <artifactId>thymeleaf-spring5</artifactId>
+            <version>${org.thymeleaf-version}</version>
+        </dependency>
+        <dependency>
+            <groupId>nz.net.ultraq.thymeleaf</groupId>
+            <artifactId>thymeleaf-layout-dialect</artifactId>
+            <version>${thymeleaf-layout-dialect.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.thymeleaf.extras</groupId>
+            <artifactId>thymeleaf-extras-java8time</artifactId>
+            <version>${org.thymeleaf.extras-version}</version>
+        </dependency>
+
+        <!-- Servlet -->
+        <dependency>
+            <groupId>javax.servlet</groupId>
+            <artifactId>javax.servlet-api</artifactId>
+            <version>${javax.servlet-api.version}</version>
+            <scope>provided</scope>
+        </dependency>
+
+        <!-- test scoped -->
+        <dependency>
+            <groupId>org.springframework</groupId>
+            <artifactId>spring-test</artifactId>
+            <version>${spring.version}</version>
+            <scope>test</scope>
+        </dependency>
+
+        <dependency>
+            <groupId>org.springframework.security</groupId>
+            <artifactId>spring-security-test</artifactId>
+            <version>${spring-security.version}</version>
+            <scope>test</scope>
+        </dependency>
+
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-war-plugin</artifactId>
+                <version>${maven-war-plugin.version}</version>
+                <configuration>
+                    <failOnMissingWebXml>false</failOnMissingWebXml>
+                </configuration>
+            </plugin>
+
+            <plugin>
+                <groupId>org.codehaus.cargo</groupId>
+                <artifactId>cargo-maven2-plugin</artifactId>
+                <version>${cargo-maven2-plugin.version}</version>
+                <configuration>
+                    <wait>true</wait>
+                    <container>
+                        <containerId>jetty9x</containerId>
+                        <type>embedded</type>
+                        <systemProperties>
+                        </systemProperties>
+                    </container>
+                    <configuration>
+                        <properties>
+                            <cargo.servlet.port>8082</cargo.servlet.port>
+                        </properties>
+                    </configuration>
+                </configuration>
+            </plugin>
+
+        </plugins>
+    </build>
+
+    <properties>
+        <spring-data.version>2.3.2.RELEASE</spring-data.version>
+        <org.thymeleaf-version>3.0.11.RELEASE</org.thymeleaf-version>
+        <org.thymeleaf.extras-version>3.0.4.RELEASE</org.thymeleaf.extras-version>
+        <thymeleaf-layout-dialect.version>2.4.1</thymeleaf-layout-dialect.version>
+        <javax.validation-version>2.0.1.Final</javax.validation-version>
+        <hibernate-validator.version>6.0.11.Final</hibernate-validator.version>
+
+        <!-- Maven plugins -->
+        <cargo-maven2-plugin.version>1.6.1</cargo-maven2-plugin.version>
+    </properties>
+
+</project>

spring-web-modules/spring-thymeleaf/src/main/java/com/baeldung/thymeleaf/config/InitSecurity.java

@@ -0,0 +1,11 @@
+package com.baeldung.thymeleaf.config;
+
+import org.springframework.security.web.context.AbstractSecurityWebApplicationInitializer;
+
+public class InitSecurity extends AbstractSecurityWebApplicationInitializer {
+
+    public InitSecurity() {
+        super(WebMVCSecurity.class);
+
+    }
+}

spring-web-modules/spring-thymeleaf/src/main/java/com/baeldung/thymeleaf/config/WebApp.java

@@ -0,0 +1,36 @@
+package com.baeldung.thymeleaf.config;
+
+import javax.servlet.ServletRegistration.Dynamic;
+
+import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer;
+
+/**
+ * Java configuration file that is used for web application initialization
+ */
+public class WebApp extends AbstractAnnotationConfigDispatcherServletInitializer {
+
+    public WebApp() {
+        super();
+    }
+
+    @Override
+    protected Class<?>[] getRootConfigClasses() {
+        return null;
+    }
+
+    @Override
+    protected Class<?>[] getServletConfigClasses() {
+        return new Class<?>[] { WebMVCConfig.class, WebMVCSecurity.class, InitSecurity.class };
+    }
+
+    @Override
+    protected String[] getServletMappings() {
+        return new String[] { "/" };
+    }
+
+    @Override
+    protected void customizeRegistration(final Dynamic registration) {
+        super.customizeRegistration(registration);
+    }
+
+}

spring-web-modules/spring-thymeleaf/src/main/java/com/baeldung/thymeleaf/config/WebMVCConfig.java

@@ -0,0 +1,155 @@
+package com.baeldung.thymeleaf.config;
+
+import java.util.Locale;
+
+import nz.net.ultraq.thymeleaf.LayoutDialect;
+import nz.net.ultraq.thymeleaf.decorators.strategies.GroupingStrategy;
+
+import org.springframework.context.ApplicationContext;
+import org.springframework.context.ApplicationContextAware;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.ComponentScan;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.context.annotation.Description;
+import org.springframework.context.support.ResourceBundleMessageSource;
+import org.springframework.format.FormatterRegistry;
+import org.springframework.web.servlet.LocaleResolver;
+import org.springframework.web.servlet.ViewResolver;
+import org.springframework.web.servlet.config.annotation.EnableWebMvc;
+import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
+import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
+import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
+import org.springframework.web.servlet.i18n.LocaleChangeInterceptor;
+import org.springframework.web.servlet.i18n.SessionLocaleResolver;
+import org.thymeleaf.extras.java8time.dialect.Java8TimeDialect;
+import org.thymeleaf.spring5.ISpringTemplateEngine;
+import org.thymeleaf.spring5.SpringTemplateEngine;
+import org.thymeleaf.spring5.templateresolver.SpringResourceTemplateResolver;
+import org.thymeleaf.spring5.view.ThymeleafViewResolver;
+import org.thymeleaf.templatemode.TemplateMode;
+import org.thymeleaf.templateresolver.ITemplateResolver;
+
+import com.baeldung.thymeleaf.formatter.NameFormatter;
+import com.baeldung.thymeleaf.utils.ArrayUtil;
+
+@Configuration
+@EnableWebMvc
+@ComponentScan({ "com.baeldung.thymeleaf" })
+/**
+ * Java configuration file that is used for Spring MVC and Thymeleaf
+ * configurations
+ */
+public class WebMVCConfig implements WebMvcConfigurer,  ApplicationContextAware {
+
+    private ApplicationContext applicationContext;
+
+    @Override
+    public void setApplicationContext(ApplicationContext applicationContext) {
+        this.applicationContext = applicationContext;
+    }
+
+    @Bean
+    public ViewResolver htmlViewResolver() {
+        ThymeleafViewResolver resolver = new ThymeleafViewResolver();
+        resolver.setTemplateEngine(templateEngine(htmlTemplateResolver()));
+        resolver.setContentType("text/html");
+        resolver.setCharacterEncoding("UTF-8");
+        resolver.setViewNames(ArrayUtil.array("*.html"));
+        return resolver;
+    }
+
+    @Bean
+    public ViewResolver javascriptViewResolver() {
+        ThymeleafViewResolver resolver = new ThymeleafViewResolver();
+        resolver.setTemplateEngine(templateEngine(javascriptTemplateResolver()));
+        resolver.setContentType("application/javascript");
+        resolver.setCharacterEncoding("UTF-8");
+        resolver.setViewNames(ArrayUtil.array("*.js"));
+        return resolver;
+    }
+
+    @Bean
+    public ViewResolver plainViewResolver() {
+        ThymeleafViewResolver resolver = new ThymeleafViewResolver();
+        resolver.setTemplateEngine(templateEngine(plainTemplateResolver()));
+        resolver.setContentType("text/plain");
+        resolver.setCharacterEncoding("UTF-8");
+        resolver.setViewNames(ArrayUtil.array("*.txt"));
+        return resolver;
+    }
+
+    private ISpringTemplateEngine templateEngine(ITemplateResolver templateResolver) {
+        SpringTemplateEngine engine = new SpringTemplateEngine();
+        engine.addDialect(new LayoutDialect(new GroupingStrategy()));
+        engine.addDialect(new Java8TimeDialect());
+        engine.setTemplateResolver(templateResolver);
+        engine.setTemplateEngineMessageSource(messageSource());
+        return engine;
+    }
+
+    private ITemplateResolver htmlTemplateResolver() {
+        SpringResourceTemplateResolver resolver = new SpringResourceTemplateResolver();
+        resolver.setApplicationContext(applicationContext);
+        resolver.setPrefix("/WEB-INF/views/");
+        resolver.setCacheable(false);
+        resolver.setTemplateMode(TemplateMode.HTML);
+        return resolver;
+    }
+
+    private ITemplateResolver javascriptTemplateResolver() {
+        SpringResourceTemplateResolver resolver = new SpringResourceTemplateResolver();
+        resolver.setApplicationContext(applicationContext);
+        resolver.setPrefix("/WEB-INF/js/");
+        resolver.setCacheable(false);
+        resolver.setTemplateMode(TemplateMode.JAVASCRIPT);
+        return resolver;
+    }
+
+    private ITemplateResolver plainTemplateResolver() {
+        SpringResourceTemplateResolver resolver = new SpringResourceTemplateResolver();
+        resolver.setApplicationContext(applicationContext);
+        resolver.setPrefix("/WEB-INF/txt/");
+        resolver.setCacheable(false);
+        resolver.setTemplateMode(TemplateMode.TEXT);
+        return resolver;
+    }
+
+    @Bean
+    @Description("Spring Message Resolver")
+    public ResourceBundleMessageSource messageSource() {
+        ResourceBundleMessageSource messageSource = new ResourceBundleMessageSource();
+        messageSource.setBasename("messages");
+        return messageSource;
+    }
+
+    @Bean
+    public LocaleResolver localeResolver() {
+        SessionLocaleResolver localeResolver = new SessionLocaleResolver();
+        localeResolver.setDefaultLocale(new Locale("en"));
+        return localeResolver;
+    }
+
+    @Bean
+    public LocaleChangeInterceptor localeChangeInterceptor() {
+        LocaleChangeInterceptor localeChangeInterceptor = new LocaleChangeInterceptor();
+        localeChangeInterceptor.setParamName("lang");
+        return localeChangeInterceptor;
+    }
+
+    @Override
+    public void addInterceptors(InterceptorRegistry registry) {
+        registry.addInterceptor(localeChangeInterceptor());
+    }
+
+    @Override
+    public void addResourceHandlers(ResourceHandlerRegistry registry) {
+        registry.addResourceHandler("/resources/**", "/css/**")
+            .addResourceLocations("/WEB-INF/resources/", "/WEB-INF/css/");
+    }
+
+    @Override
+    @Description("Custom Conversion Service")
+    public void addFormatters(FormatterRegistry registry) {
+        registry.addFormatter(new NameFormatter());
+    }
+}

spring-web-modules/spring-thymeleaf/src/main/java/com/baeldung/thymeleaf/config/WebMVCSecurity.java

@@ -0,0 +1,43 @@
+package com.baeldung.thymeleaf.config;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.security.authentication.AuthenticationManager;
+import org.springframework.security.config.annotation.authentication.builders.AuthenticationManagerBuilder;
+import org.springframework.security.config.annotation.method.configuration.EnableGlobalMethodSecurity;
+import org.springframework.security.config.annotation.web.builders.HttpSecurity;
+import org.springframework.security.config.annotation.web.builders.WebSecurity;
+import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
+import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
+
+@Configuration
+@EnableWebSecurity
+@EnableGlobalMethodSecurity(securedEnabled = true, prePostEnabled = true)
+public class WebMVCSecurity extends WebSecurityConfigurerAdapter {
+
+    @Bean
+    @Override
+    public AuthenticationManager authenticationManagerBean() throws Exception {
+        return super.authenticationManagerBean();
+    }
+
+    public WebMVCSecurity() {
+        super();
+    }
+
+    @Override
+    protected void configure(final AuthenticationManagerBuilder auth) throws Exception {
+        auth.inMemoryAuthentication().withUser("user1").password("{noop}user1Pass").authorities("ROLE_USER");
+    }
+
+    @Override
+    public void configure(final WebSecurity web) throws Exception {
+        web.ignoring().antMatchers("/resources/**");
+    }
+
+    @Override
+    protected void configure(final HttpSecurity http) throws Exception {
+        http.authorizeRequests().anyRequest().authenticated().and().httpBasic();
+    }
+
+}

spring-web-modules/spring-thymeleaf/src/main/java/com/baeldung/thymeleaf/controller/BookController.java

@@ -0,0 +1,46 @@
+package com.baeldung.thymeleaf.controller;
+
+import java.util.List;
+import java.util.Optional;
+import java.util.stream.Collectors;
+import java.util.stream.IntStream;
+
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.PageRequest;
+
+import org.springframework.stereotype.Controller;
+import org.springframework.ui.Model;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestMethod;
+import org.springframework.web.bind.annotation.RequestParam;
+
+import com.baeldung.thymeleaf.model.Book;
+import com.baeldung.thymeleaf.service.BookService;
+
+@Controller
+public class BookController {
+
+    @Autowired
+    private BookService bookService;
+
+    @RequestMapping(value = "/listBooks", method = RequestMethod.GET)
+    public String listBooks(Model model, @RequestParam("page") Optional<Integer> page, @RequestParam("size") Optional<Integer> size) {
+        final int currentPage = page.orElse(1);
+        final int pageSize = size.orElse(5);
+
+        Page<Book> bookPage = bookService.findPaginated(PageRequest.of(currentPage - 1, pageSize));
+
+        model.addAttribute("bookPage", bookPage);
+
+        int totalPages = bookPage.getTotalPages();
+        if (totalPages > 0) {
+            List<Integer> pageNumbers = IntStream.rangeClosed(1, totalPages)
+                .boxed()
+                .collect(Collectors.toList());
+            model.addAttribute("pageNumbers", pageNumbers);
+        }
+
+        return "listBooks.html";
+    }
+}

spring-web-modules/spring-thymeleaf/src/main/java/com/baeldung/thymeleaf/controller/DatesController.java

@@ -0,0 +1,25 @@
+package com.baeldung.thymeleaf.controller;
+
+import java.time.Instant;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.Date;
+
+import org.springframework.stereotype.Controller;
+import org.springframework.ui.Model;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestMethod;
+
+@Controller
+public class DatesController {
+
+    @RequestMapping(value = "/dates", method = RequestMethod.GET)
+    public String getInfo(Model model) {
+        model.addAttribute("standardDate", new Date());
+        model.addAttribute("localDateTime", LocalDateTime.now());
+        model.addAttribute("localDate", LocalDate.now());
+        model.addAttribute("timestamp", Instant.now());
+        return "dates.html";
+    }
+
+}

spring-web-modules/spring-thymeleaf/src/main/java/com/baeldung/thymeleaf/controller/ExpressionUtilityObjectsController.java

@@ -0,0 +1,33 @@
+package com.baeldung.thymeleaf.controller;
+
+import java.util.Arrays;
+import java.util.Calendar;
+import java.util.Date;
+import java.util.HashSet;
+
+import org.springframework.stereotype.Controller;
+import org.springframework.ui.Model;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestMethod;
+
+/**
+ * Controller to test expression utility objects: dates,
+ * 
+ */
+@Controller
+public class ExpressionUtilityObjectsController {
+
+    @RequestMapping(value = "/objects", method = RequestMethod.GET)
+    public String getDates(Model model) {
+        model.addAttribute("date", new Date());
+        model.addAttribute("calendar", Calendar.getInstance());
+        model.addAttribute("num", Math.random() * 10);
+        model.addAttribute("string", "new text");
+        model.addAttribute("emptyString", "");
+        model.addAttribute("nullString", null);
+        model.addAttribute("array", new int[] { 1, 3, 4, 5 });
+        model.addAttribute("set", new HashSet<Integer>(Arrays.asList(1, 3, 8)));
+        return "objects.html";
+    }
+
+}

spring-web-modules/spring-thymeleaf/src/main/java/com/baeldung/thymeleaf/controller/FragmentsController.java

@@ -0,0 +1,33 @@
+package com.baeldung.thymeleaf.controller;
+
+import org.springframework.stereotype.Controller;
+import org.springframework.ui.Model;
+import org.springframework.web.bind.annotation.GetMapping;
+
+import com.baeldung.thymeleaf.utils.StudentUtils;
+
+@Controller
+public class FragmentsController {
+
+    @GetMapping("/fragments")
+    public String getHome() {
+        return "fragments.html";
+    }
+
+    @GetMapping("/markup")
+    public String markupPage() {
+        return "markup.html";
+    }
+
+    @GetMapping("/params")
+    public String paramsPage() {
+        return "params.html";
+    }
+
+    @GetMapping("/other")
+    public String otherPage(Model model) {
+        model.addAttribute("data", StudentUtils.buildStudents());
+        return "other.html";
+    }
+
+}

spring-web-modules/spring-thymeleaf/src/main/java/com/baeldung/thymeleaf/controller/HomeController.java

@@ -0,0 +1,26 @@
+package com.baeldung.thymeleaf.controller;
+
+import java.text.DateFormat;
+import java.util.Date;
+import java.util.Locale;
+
+import org.springframework.stereotype.Controller;
+import org.springframework.ui.Model;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestMethod;
+
+/**
+ * Handles requests for the application home page.
+ * 
+ */
+@Controller
+public class HomeController {
+
+    @RequestMapping(value = "/", method = RequestMethod.GET)
+    public String getHome(Model model) {
+        DateFormat dateFormat = DateFormat.getDateTimeInstance(DateFormat.LONG, DateFormat.LONG, Locale.getDefault());
+        model.addAttribute("serverTime", dateFormat.format(new Date()));
+        return "home.html";
+    }
+
+}

spring-web-modules/spring-thymeleaf/src/main/java/com/baeldung/thymeleaf/controller/InliningController.java

@@ -0,0 +1,33 @@
+package com.baeldung.thymeleaf.controller;
+
+import org.springframework.security.core.context.SecurityContextHolder;
+import org.springframework.stereotype.Controller;
+import org.springframework.ui.Model;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestMethod;
+
+import com.baeldung.thymeleaf.utils.StudentUtils;
+
+@Controller
+public class InliningController {
+
+    @RequestMapping(value = "/html", method = RequestMethod.GET)
+    public String getExampleHTML(Model model) {
+        model.addAttribute("title", "Baeldung");
+        model.addAttribute("description", "<strong>Thymeleaf</strong> tutorial");
+        return "inliningExample.html";
+    }
+
+    @RequestMapping(value = "/js", method = RequestMethod.GET)
+    public String getExampleJS(Model model) {
+        model.addAttribute("students", StudentUtils.buildStudents());
+        return "studentCheck.js";
+    }
+
+    @RequestMapping(value = "/plain", method = RequestMethod.GET)
+    public String getExamplePlain(Model model) {
+        model.addAttribute("username", SecurityContextHolder.getContext().getAuthentication().getName());
+        model.addAttribute("students", StudentUtils.buildStudents());
+        return "studentsList.txt";
+    }
+}

spring-web-modules/spring-thymeleaf/src/main/java/com/baeldung/thymeleaf/controller/LayoutDialectController.java

@@ -0,0 +1,16 @@
+package com.baeldung.thymeleaf.controller;
+
+import org.springframework.stereotype.Controller;
+import org.springframework.ui.Model;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestMethod;
+
+@Controller
+public class LayoutDialectController {
+
+    @RequestMapping(value = "/layout", method = RequestMethod.GET)
+    public String getNewPage(Model model) {
+        return "content.html";
+    }
+
+}

spring-web-modules/spring-thymeleaf/src/main/java/com/baeldung/thymeleaf/controller/StudentController.java

@@ -0,0 +1,50 @@
+package com.baeldung.thymeleaf.controller;
+
+import java.util.List;
+
+import javax.validation.Valid;
+
+import org.springframework.stereotype.Controller;
+import org.springframework.ui.Model;
+import org.springframework.validation.BindingResult;
+import org.springframework.web.bind.annotation.ModelAttribute;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestMethod;
+
+import com.baeldung.thymeleaf.model.Student;
+import com.baeldung.thymeleaf.utils.StudentUtils;
+
+/**
+ * Handles requests for the student model.
+ * 
+ */
+@Controller
+public class StudentController {
+
+    @RequestMapping(value = "/saveStudent", method = RequestMethod.POST)
+    public String saveStudent(@Valid @ModelAttribute Student student, BindingResult errors, Model model) {
+        if (!errors.hasErrors()) {
+            // get mock objects
+            List<Student> students = StudentUtils.buildStudents();
+            // add current student
+            students.add(student);
+            model.addAttribute("students", students);
+        }
+        return ((errors.hasErrors()) ? "addStudent.html" : "listStudents.html");
+    }
+
+    @RequestMapping(value = "/addStudent", method = RequestMethod.GET)
+    public String addStudent(Model model) {
+        model.addAttribute("student", new Student());
+        return "addStudent.html";
+    }
+
+    @RequestMapping(value = "/listStudents", method = RequestMethod.GET)
+    public String listStudent(Model model) {
+
+        model.addAttribute("students", StudentUtils.buildStudents());
+
+        return "listStudents.html";
+    }
+
+}

spring-web-modules/spring-thymeleaf/src/main/java/com/baeldung/thymeleaf/controller/TeacherController.java

@@ -0,0 +1,19 @@
+package com.baeldung.thymeleaf.controller;
+
+import org.springframework.stereotype.Controller;
+import org.springframework.ui.Model;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestMethod;
+
+import com.baeldung.thymeleaf.utils.TeacherUtils;
+
+@Controller
+public class TeacherController {
+
+	@RequestMapping(value = "/listTeachers", method = RequestMethod.GET)
+	public String getInfo(Model model) {
+		model.addAttribute("teachers", TeacherUtils.buildTeachers());
+
+		return "listTeachers.html";
+	}
+}

spring-web-modules/spring-thymeleaf/src/main/java/com/baeldung/thymeleaf/formatter/NameFormatter.java

@@ -0,0 +1,30 @@
+package com.baeldung.thymeleaf.formatter;
+
+import java.text.ParseException;
+import java.util.Locale;
+
+import org.springframework.format.Formatter;
+import org.thymeleaf.util.StringUtils;
+
+/**
+ * 
+ * Name formatter class that implements the Spring Formatter interface. 
+ * Formats a name(String) and return the value with spaces replaced by commas.
+ *
+ */
+public class NameFormatter implements Formatter<String> {
+
+    @Override
+    public String print(String input, Locale locale) {
+        return formatName(input, locale);
+    }
+
+    @Override
+    public String parse(String input, Locale locale) throws ParseException {
+        return formatName(input, locale);
+    }
+
+    private String formatName(String input, Locale locale) {
+        return StringUtils.replace(input, " ", ",");
+    }
+}

spring-web-modules/spring-thymeleaf/src/main/java/com/baeldung/thymeleaf/model/Book.java

@@ -0,0 +1,29 @@
+package com.baeldung.thymeleaf.model;
+
+public class Book {
+    private int id;
+    private String name;
+
+    public Book(int id, String name) {
+        super();
+        this.id = id;
+        this.name = name;
+    }
+
+    public int getId() {
+        return id;
+    }
+
+    public void setId(int id) {
+        this.id = id;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+}

spring-web-modules/spring-thymeleaf/src/main/java/com/baeldung/thymeleaf/model/Student.java

@@ -0,0 +1,60 @@
+package com.baeldung.thymeleaf.model;
+
+import java.io.Serializable;
+
+import javax.validation.constraints.Min;
+import javax.validation.constraints.NotNull;
+
+/**
+ * 
+ * Simple student POJO with few fields
+ *
+ */
+public class Student implements Serializable {
+
+    private static final long serialVersionUID = -8582553475226281591L;
+
+    @NotNull(message = "Student ID is required.")
+    @Min(value = 1000, message = "Student ID must be at least 4 digits.")
+    private Integer id;
+
+    @NotNull(message = "Student name is required.")
+    private String name;
+
+    @NotNull(message = "Student gender is required.")
+    private Character gender;
+
+    private Float percentage;
+
+    public Integer getId() {
+        return id;
+    }
+
+    public void setId(Integer id) {
+        this.id = id;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    public Character getGender() {
+        return gender;
+    }
+
+    public void setGender(Character gender) {
+        this.gender = gender;
+    }
+
+    public Float getPercentage() {
+        return percentage;
+    }
+
+    public void setPercentage(Float percentage) {
+        this.percentage = percentage;
+    }
+}

spring-web-modules/spring-thymeleaf/src/main/java/com/baeldung/thymeleaf/model/Teacher.java

@@ -0,0 +1,78 @@
+package com.baeldung.thymeleaf.model;
+
+import java.io.Serializable;
+import java.util.ArrayList;
+import java.util.List;
+
+import javax.validation.constraints.Min;
+import javax.validation.constraints.NotNull;
+
+public class Teacher implements Serializable {
+
+	private static final long serialVersionUID = 946941572942270450L;
+
+	@NotNull(message = "Teacher ID is required.")
+	@Min(value = 1000, message = "Teacher ID must be at least 4 digits.")
+	private Integer id;
+
+	@NotNull(message = "Teacher name is required.")
+	private String name;
+
+	@NotNull(message = "Teacher gender is required.")
+	private String gender;
+
+	private boolean isActive;
+
+	private List<String> courses = new ArrayList<String>();
+
+	private String additionalSkills;
+
+	public Integer getId() {
+		return id;
+	}
+
+	public void setId(Integer id) {
+		this.id = id;
+	}
+
+	public String getName() {
+		return name;
+	}
+
+	public void setName(String name) {
+		this.name = name;
+	}
+
+	public String getGender() {
+		return gender;
+	}
+
+	public void setGender(String gender) {
+		this.gender = gender;
+	}
+
+	public boolean isActive() {
+		return isActive;
+	}
+
+	public void setActive(boolean isActive) {
+		this.isActive = isActive;
+	}
+
+	public List<String> getCourses() {
+		return courses;
+	}
+
+	public void setCourses(List<String> courses) {
+		this.courses = courses;
+	}
+
+	public String getAdditionalSkills() {
+		return additionalSkills;
+	}
+
+	public void setAdditionalSkills(String additionalSkills) {
+		this.additionalSkills = additionalSkills;
+	}
+
+}

spring-web-modules/spring-thymeleaf/src/main/java/com/baeldung/thymeleaf/service/BookService.java

@@ -0,0 +1,38 @@
+package com.baeldung.thymeleaf.service;
+
+import java.util.Collections;
+import java.util.List;
+
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.PageImpl;
+import org.springframework.data.domain.PageRequest;
+import org.springframework.data.domain.Pageable;
+import org.springframework.stereotype.Service;
+
+import com.baeldung.thymeleaf.model.Book;
+import com.baeldung.thymeleaf.utils.BookUtils;
+
+@Service
+public class BookService {
+
+    final private List<Book> books = BookUtils.buildBooks();
+
+    public Page<Book> findPaginated(Pageable pageable) {
+        int pageSize = pageable.getPageSize();
+        int currentPage = pageable.getPageNumber();
+        int startItem = currentPage * pageSize;
+        List<Book> list;
+
+        if (books.size() < startItem) {
+            list = Collections.emptyList();
+        } else {
+            int toIndex = Math.min(startItem + pageSize, books.size());
+            list = books.subList(startItem, toIndex);
+        }
+
+        Page<Book> bookPage = new PageImpl<Book>(list, PageRequest.of(currentPage, pageSize), books.size());
+
+        return bookPage;
+
+    }
+}

spring-web-modules/spring-thymeleaf/src/main/java/com/baeldung/thymeleaf/utils/ArrayUtil.java

@@ -0,0 +1,8 @@
+package com.baeldung.thymeleaf.utils;
+
+public class ArrayUtil {
+
+    public static String[] array(String... args) {
+        return args;
+    }
+}

spring-web-modules/spring-thymeleaf/src/main/java/com/baeldung/thymeleaf/utils/BookUtils.java

@@ -0,0 +1,28 @@
+package com.baeldung.thymeleaf.utils;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.stream.IntStream;
+
+import com.baeldung.thymeleaf.model.Book;
+
+public class BookUtils {
+
+    private static List<Book> books = new ArrayList<Book>();
+
+    private static final int NUM_BOOKS = 30;
+        
+    private static final int MIN_BOOK_NUM = 1000;
+
+    public static List<Book> buildBooks() {
+        if (books.isEmpty()) {
+            IntStream.range(0, NUM_BOOKS).forEach(n -> {
+                books.add(new Book(MIN_BOOK_NUM + n + 1, "Spring in Action"));
+            });
+            
+        }
+
+        return books;
+    }
+    
+}

spring-web-modules/spring-thymeleaf/src/main/java/com/baeldung/thymeleaf/utils/StudentUtils.java

@@ -0,0 +1,34 @@
+package com.baeldung.thymeleaf.utils;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import com.baeldung.thymeleaf.model.Student;
+
+public class StudentUtils {
+
+    private static List<Student> students = new ArrayList<Student>();
+
+    public static List<Student> buildStudents() {
+        if (students.isEmpty()) {
+            Student student1 = new Student();
+            student1.setId(1001);
+            student1.setName("John Smith");
+            student1.setGender('M');
+            student1.setPercentage(Float.valueOf("80.45"));
+
+            students.add(student1);
+
+            Student student2 = new Student();
+            student2.setId(1002);
+            student2.setName("Jane Williams");
+            student2.setGender('F');
+            student2.setPercentage(Float.valueOf("60.25"));
+
+            students.add(student2);
+        }
+
+        return students;
+    }
+
+}

spring-web-modules/spring-thymeleaf/src/main/java/com/baeldung/thymeleaf/utils/TeacherUtils.java

@@ -0,0 +1,47 @@
+package com.baeldung.thymeleaf.utils;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import com.baeldung.thymeleaf.model.Teacher;
+
+public class TeacherUtils {
+
+	private static List<Teacher> teachers = new ArrayList<Teacher>();
+
+	public static List<Teacher> buildTeachers() {
+		if (teachers.isEmpty()) {
+			Teacher teacher1 = new Teacher();
+			teacher1.setId(2001);
+			teacher1.setName("Jane Doe");
+			teacher1.setGender("F");
+			teacher1.setActive(true);
+			teacher1.getCourses().add("Mathematics");
+			teacher1.getCourses().add("Physics");
+
+			teachers.add(teacher1);
+
+			Teacher teacher2 = new Teacher();
+			teacher2.setId(2002);
+			teacher2.setName("Lazy Dude");
+			teacher2.setGender("M");
+			teacher2.setActive(false);
+			teacher2.setAdditionalSkills("emergency responder");
+
+			teachers.add(teacher2);
+
+			Teacher teacher3 = new Teacher();
+			teacher3.setId(2002);
+			teacher3.setName("Micheal Jordan");
+			teacher3.setGender("M");
+			teacher3.setActive(true);
+			teacher3.getCourses().add("Sports");
+
+			teachers.add(teacher3);
+
+		}
+
+		return teachers;
+	}
+
+}

spring-web-modules/spring-thymeleaf/src/main/resources/logback.xml

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<configuration>
+    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
+        <encoder>
+            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n
+            </pattern>
+        </encoder>
+    </appender>
+
+    <logger name="org.springframework" level="WARN" />
+    <logger name="org.springframework.transaction" level="WARN" />
+
+    <!-- in order to debug some marshalling issues, this needs to be TRACE -->
+    <logger name="org.springframework.web.servlet.mvc" level="WARN" />
+
+    <root level="INFO">
+        <appender-ref ref="STDOUT" />
+    </root>
+</configuration>

spring-web-modules/spring-thymeleaf/src/main/resources/messages_en.properties

@@ -0,0 +1,13 @@
+msg.id=ID
+msg.name=Name
+msg.gender=Gender
+msg.percent=Percentage
+welcome.message=Welcome Student !!!
+msg.AddStudent=Add Student
+msg.ListStudents=List Students
+msg.Home=Home
+msg.ListTeachers=List Teachers
+msg.ListBooks=List Books with paging
+msg.courses=Courses
+msg.skills=Skills
+msg.active=Active

spring-web-modules/spring-thymeleaf/src/main/webapp/WEB-INF/css/styles.css

@@ -0,0 +1,13 @@
+body {
+	background-color: lightGray
+}
+
+.dark {
+	background-color: black;
+	color: white;
+}
+
+.light {
+	background-color: #f1f1f1;
+	color: #ccc;
+}

spring-web-modules/spring-thymeleaf/src/main/webapp/WEB-INF/js/studentCheck.js

@@ -0,0 +1,2 @@
+var count = [[${students.size()}]];
+alert("Number of students in group: " + count);

spring-web-modules/spring-thymeleaf/src/main/webapp/WEB-INF/txt/studentsList.txt

@@ -0,0 +1,8 @@
+Dear [(${username})],
+
+This is the list of our students:
+[# th:each="s : ${students}"]
+   - [(${s.name})]. ID: [(${s.id})]
+[/]
+Thanks,
+The Baeldung University

spring-web-modules/spring-thymeleaf/src/main/webapp/WEB-INF/views/addStudent.html

@@ -0,0 +1,45 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml"
+	xmlns:th="http://www.thymeleaf.org">
+<head>
+<title>Add Student</title>
+</head>
+<body>
+	<h1>Add Student</h1>
+	<form action="#" th:action="@{/saveStudent}" th:object="${student}"
+		method="post">
+		<ul>
+			<li th:errors="*{id}" />
+			<li th:errors="*{name}" />
+			<li th:errors="*{gender}" />
+			<li th:errors="*{percentage}" />
+		</ul>
+		<table border="1">
+			<tr>
+				<td><label th:text="#{msg.id}" /></td>
+				<td><input type="number" th:field="*{id}" /></td>
+			</tr>
+			<tr>
+				<td><label th:text="#{msg.name}" /></td>
+				<td><input type="text" th:field="*{name}" /></td>
+			</tr>
+			<tr>
+				<td><label th:text="#{msg.gender}" /></td>
+				<td><select th:field="*{gender}">
+						<option th:value="'M'" th:text="Male"></option>
+						<option th:value="'F'" th:text="Female"></option>
+				</select></td>
+			</tr>
+			<tr>
+				<td><label th:text="#{msg.percent}" /></td>
+				<td><select id="percentage" name="percentage">
+						<option th:each="i : ${#numbers.sequence(0, 100)}" th:value="${i}" th:text="${i}" th:selected="${i==75}"></option>
+				</select></td>
+			</tr>
+			<tr>
+				<td><input type="submit" value="Submit" /></td>
+			</tr>
+		</table>
+	</form>
+</body>
+</html>