How to use Jade4j with Spring Boot?

Integrate via the spring-jade4j library on GitHub, which configures Jade4j as a view resolver in Spring MVC, allowing Pug templates for server-side rendering in Spring Boot apps.

Jade4j vs Thymeleaf for Java templates?

Jade4j offers Pug's concise, whitespace-sensitive syntax and better performance with JEXL, while Thymeleaf is XML-based with stronger Spring integration; choose based on syntax preference and framework alignment.

Does Jade4j support Markdown filters out of the box?

No, it only includes plain and cdata filters; you need to implement a custom filter or use third-party libraries, adding setup complexity for Markdown processing in templates.

How to disable caching in Jade4j for development?

Set the caching property to false in the JadeConfiguration object, as shown in the README, to ensure templates are re-parsed on each request during iterative development.

What are the breaking changes in Jade4j version 1.3.0?

Version 1.3.0 removed setBasePath from JadeConfiguration and changed variable scoping in loops to align with Pug.js, potentially requiring template adjustments for existing codebases.

Can I migrate from jade4j to pug4j easily?

Yes, the project was renamed to pug4j with continued support; update dependencies and repository references, but note that new issues should be reported in the pug4j repository.

Open-Awesome

Jade4J

MITJavajade4j-1.3.2

A Java implementation of the Pug template engine that processes templates without requiring JavaScript.

GitHub

707 stars115 forks0 contributors

What is Jade4J?

Jade4j (now renamed to Pug4j) is a Java implementation of the Pug template engine that allows developers to process Pug templates directly in Java applications without requiring a JavaScript environment. It solves the problem of using Pug's concise, whitespace-sensitive syntax in Java-based web projects while maintaining full compatibility with the original Pug syntax.

Target Audience

Java developers building web applications who want to use Pug templates for server-side rendering, particularly those working with Spring, Jooby, or Vert.x frameworks.

Value Proposition

Developers choose Jade4j because it provides native Java performance with 3-4x faster expression evaluation using JEXL, maintains full Pug syntax compatibility, and offers seamless integration with popular Java web frameworks without JavaScript runtime dependencies.

Overview

a pug implementation written in Java (formerly known as jade)

Use Cases

Best For

Server-side HTML generation in Java web applications
Using Pug templates in Spring Boot projects
Building Java applications with Vert.x web framework
Creating maintainable templates with Pug's concise syntax
Projects requiring template caching for performance
Teams transitioning from JavaScript Pug templates to Java environments

Not Ideal For

Projects requiring real-time client-side templating with JavaScript runtime dependencies
Teams using Java frameworks not natively supported (e.g., Play Framework, Micronaut) without custom integration
Applications where XML-based templating is mandatory for tooling or compliance reasons
Environments with zero tolerance for breaking changes during library updates

Pros & Cons

Pros

Full Pug Syntax Compatibility

Supports almost the entire Pug 2 syntax, allowing seamless template sharing between JavaScript and Java environments without modification.

JEXL Performance Boost

Uses the JEXL expression engine for 3-4x faster evaluation than previous implementations, enhancing server-side rendering speed in Java apps.

Built-in Template Caching

Implements caching to avoid redundant parsing of unchanged templates, with a configurable option to disable it for development workflows.

Framework Integration Ready

Offers out-of-the-box integrations with Spring, Jooby, and Vert.x, simplifying adoption in popular Java web application frameworks.

Cons

JEXL Expression Quirks

JEXL's semi-strict mode and reserved words like 'new' and 'size' can cause unexpected null/false evaluations or require awkward bracket notation for property access.

Breaking Changes History

Several versions (e.g., 1.3.0, 1.2.0, 1.0.0) introduced breaking changes, such as scoping adjustments and filter interface updates, complicating upgrades for existing projects.

Limited Built-in Filter Support

Comes with only plain and cdata filters; custom filters for Markdown or CoffeeScript require additional implementation and dependency management compared to the JavaScript Pug ecosystem.

Frequently Asked Questions

Related Projects

jte

Secure and speedy templates for Java and Kotlin.

StringTemplate 4

Last commit1 year ago

Rocker

Java 8 optimized, memory efficient, speedy template engine producing statically typed, plain java objects

Stars780

Forks91

Last commit5 months ago

jstachio

Java type safe statically compiled mustache

Stars330

Forks14