Java · Spring · Thymeleaf · Htmx
Production-ready Spring Boot, crafted carefully.
I'm Wim Deblauwe, a software developer specialized in Java and Spring. I write books, maintain open-source projects like error-handling-spring-boot-starter, and publish practical, battle-tested articles here.
just start typing — try thymeleaf, testcontainers or htmx
Taming Thymeleaf
Server-side rendering with Spring Boot, step by step.
Modern frontends with htmx
Hypermedia-driven UIs with Spring Boot & Thymeleaf.
Recent posts
showing 10 of 124- Jun 10, 2018 PageImpl JSON serialization with Spring Boot 2 During the migration of a Spring Boot application from 1.5.13 to 2.0.2, some of my Spring Rest Docs tests started failing. The reason being that some of my RestController s return a org.springframework.data.domain.PageImpl object (from Spring Data Commons). @RestController public class MyRestController { @GetMapping public PageImpl<SomeDtoObject> listAll() { ... } }
- Oct 8, 2017 Building an AsciidoctorJ extension to execute JavaScript I love using Asciidoctor for writing documentation. I mainly got to know it through the excellent Spring REST Docs project. I wanted to build an extension (kind of a plug-in) for Asciidoctor. As I don’t know Ruby, writing an extension in Ruby was a bit too much. Luckily, there is AsciidoctorJ (The JVM version of Asciidoctor) which lets me write extensions in any JVM language. Here, we will be using plain Java, but Groovy for example would work equally well.
- Sep 20, 2017 Using Spring Boot with JavaFX - Using Spring Profiles In the previous post, I showed ./blog/2017/09/18/using-spring-boot-with-javafx/[how to get started with Spring Boot and JavaFX]. Continuing with the same example, we are going to create a new implementation of the CountryService interface that talks to the Open AQ Platform API so the list of countries will be a lot bigger than our HardcodedListCountryService we have now. Using Retrofit First, we add 2 dependencies in our pom.xml to be able to use Retrofit:
- Sep 18, 2017 Using Spring Boot with JavaFX In my previous post, I showed how to use JavaFX with the Raspberry Pi 3. I promised there to follow up with a post on using Spring Boot with JavaFX, so here it goes. Just as an example, I will be using the REST API service of the Open AQ Platform API as it is simple and does not require any authentication to get started. Initial Setup We will be using Maven, so we start with a minimal pom.xml that includes the latest Spring Boot version (1.5.7 at the time of writing):
- Aug 26, 2017 Using JavaFX on Raspberry Pi 3 with Gluon In this post, I am going to detail the steps to get a simple JavaFX application running on the Raspberry Pi 3 using Gluon. Hardware For this setup, I used the Raspberry Pi 3 with the official 7" touchscreen connected. Raspbian Installation First off, download Raspbian from https://www.raspberrypi.org/downloads/raspbian/. I chose the "RASPBIAN STRETCH WITH DESKTOP" version and burned it on an SD-card using Etcher. Insert the SD-card in the Raspberry Pi and let it boot. The screen should look like this when done:
- Jul 24, 2017 Enable preview of Spring REST Docs snippets in IntelliJ IDEA If you use Spring REST Docs, you will be using the Asciidoctor include directive a lot to include the request and responses that are generated from the unit tests. Drawback is that the Asciidoctor plugin for IntelliJ IDEA will not render them by default and looks like this: The reason is simple, the snippets attribute is only available when running the Maven or Gradle task to build the final documentation.
- Mar 13, 2017 Using ServletUriComponentsBuilder with Nginx Spring’s ServletUriComponentsBuilder.fromCurrentRequest() can be really convinient to build an URL from the current request. However, when using Nginx, things might work so well. The solution is simple, just add these headers to your Nginx configuration file: proxy_set_header X-Forwarded-Host $host:443; proxy_set_header X-Forwarded-Server $host; proxy_set_header X-Forwarded-Port 443; proxy_set_header X-Forwarded-Proto https; UPDATE 2020-06-08 You need to enable support for this in Spring Boot by setting the following property (Since Spring Boot 2.2): server.forward-headers-strategy=native
- Jan 22, 2017 AssertJ custom assertion for ConstraintValidator tests As a follow-up to my last post on a custom validator to check if a String contains XML, I like to elaborate on how I made the unit test so readable. To repeat, here is part of the unit test again with the assertions highlighted: @Test public void givenNoXml_notValid() { ValidatorFactory factory = Validation.buildDefaultValidatorFactory(); Validator validator = factory.getValidator(); TestObject testObject = new TestObject("This is no XML string"); Set<ConstraintViolation<TestObject>> violationSet = validator.validate(testObject); assertThat(violationSet).hasViolationOnPath("xml"); } @Test public void givenXml_valid() { ValidatorFactory factory = Validation.buildDefaultValidatorFactory(); Validator validator = factory.getValidator(); TestObject testObject = new TestObject("<Node>test</Node>"); Set<ConstraintViolation<TestObject>> violationSet = validator.validate(testObject); assertThat(violationSet).hasNoViolations(); }
- Jan 21, 2017 Custom Validator to check if a String contains XML This blog post will show you how to create a custom validator to check if a String contains valid XML using the Java Validation API. Suppose you have a highly technical application that requires the user to enter some XML in a web form. You want to validate this on the client side, but also on the server side, since you should never trust your client. For the purpose of the example, suppose you have this entity:
- May 5, 2016 Angular datatables with server side pagination using Spring Data We are using angular-datatables in a project. So far, we just returned all entities from the server’s REST controller (Using Spring Boot and Spring Data on the server side). I wanted to see how I could implement server side pagination to avoid returning all records at once. I was lucky to find spring-data-jpa-datatables which makes it very easy to do. First, add the dependency in your pom.xml: <dependency> <groupId>com.github.darrachequesne</groupId> <artifactId>spring-data-jpa-datatables</artifactId> <version>2.1</version> </dependency>
no matches for "" — browse the full archive →