Thymeleaf Jersey Integration

An extension for Thymeleaf forwarding object-to-string conversions to the appropriate JAX-RS ParamConverter. As the necessary functionality is not standardised, a generic JAX-RS solution is not possible; this module works on Jersey only.

License	The Apache License, Version 2.0
Categories	Leaf Data Databases Jersey Program Interface REST Frameworks
GroupId	hu.inbuss
ArtifactId	thymeleaf-jersey
Last Version	0.0.9
Release Date	Oct 4, 2016
Type	jar
Description	Thymeleaf Jersey Integration An extension for Thymeleaf forwarding object-to-string conversions to the appropriate JAX-RS ParamConverter. As the necessary functionality is not standardised, a generic JAX-RS solution is not possible; this module works on Jersey only.
Project URL	https://github.com/inbuss/thymeleaf-jersey
Source Code Management	http://github.com/inbuss/thymeleaf-jersey/tree/master

Download thymeleaf-jersey

Filename	Size
thymeleaf-jersey-0.0.9.pom
thymeleaf-jersey-0.0.9.jar	4 KB
thymeleaf-jersey-0.0.9-sources.jar	4 KB
thymeleaf-jersey-0.0.9-javadoc.jar	363 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/hu.inbuss/thymeleaf-jersey/ -->
<dependency>
    <groupId>hu.inbuss</groupId>
    <artifactId>thymeleaf-jersey</artifactId>
    <version>0.0.9</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/hu.inbuss/thymeleaf-jersey/
implementation 'hu.inbuss:thymeleaf-jersey:0.0.9'

Gradle Kotlin

// https://jarcasting.com/artifacts/hu.inbuss/thymeleaf-jersey/
implementation ("hu.inbuss:thymeleaf-jersey:0.0.9")

Apache Buildr

'hu.inbuss:thymeleaf-jersey:jar:0.0.9'

Apache Ivy

<dependency org="hu.inbuss" name="thymeleaf-jersey" rev="0.0.9">
  <artifact name="thymeleaf-jersey" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='hu.inbuss', module='thymeleaf-jersey', version='0.0.9')
)

Scala SBT

libraryDependencies += "hu.inbuss" % "thymeleaf-jersey" % "0.0.9"

Leiningen

[hu.inbuss/thymeleaf-jersey "0.0.9"]

Dependencies

compile (1)

Group / Artifact	Type	Version
org.thymeleaf : thymeleaf	jar	3.0.2.RELEASE

provided (1)

Group / Artifact	Type	Version
org.glassfish.jersey.core : jersey-server	jar	2.23.1

Project Modules

There are no modules declared in this project.

thymeleaf-jersey

An extension for Thymeleaf forwarding object-to-string conversions to the appropriate JAX-RS ParamConverter. A possible use for this is to ensure round-trip safety when Thymeleaf writes a parameter (e.g. form field value) that JAX-RS will try to read back.

As the necessary functionality is not standardised, a generic JAX-RS solution is not possible; this module works on Jersey only. Also, this only works with the Standard Dialect - Spring users would probably be content with using the existing Spring converter integration, and have no need for this module.

Dependencies

This extension is a bridge between Jersey and Thymeleaf; it only makes sense to use this if both are already present in your project. No further dependencies are required.

The extension was built using version 2.23.1 of Jersey. As it relies on a non-standardized interface, different versions may or may not work.

The Thymeleaf side is written against the Thymeleaf 3 API. Building a version that works with Thymeleaf 2.1 should be possible, but it is not currently planned. The Conversion Service is a new feature of Thymeleaf 2.1, so earlier versions cannot be supported.

Usage

1. Include the library in your project. For example with Maven:

       <dependency>
           <groupId>hu.inbuss</groupId>
           <artifactId>thymeleaf-jersey</artifactId>
           <version>0.0.9</version>
       </dependency>

   or with Gradle:

   dependencies {
       compile 'hu.inbuss:thymeleaf-jersey:0.0.9'
   }

2. Inject a reference to the hu.inbuss.thymeleaf.jaxrs.ParamConverterBridge singleton bean into the class that creates the Thymeleaf TemplateEngine.

3. Either follow the Thymeleaf documentation on custom Conversion Services, i.e.

   import hu.inbuss.thymeleaf.jaxrs.ParamConverterBridge;
   import javax.inject.Inject;
   import org.thymeleaf.TemplateEngine;
   import org.thymeleaf.standard.StandardDialect;
   
   public class ExampleApplication {
       @Inject private ParamConverterBridge pcb;
       private final TemplateEngine engine;
   
       public ExampleApplication() {
           engine = new TemplateEngine();
           final StandardDialect sd = new StandardDialect();
           sd.setConversionService(pcb);
           engine.setDialect(sd);
           /* do other setup */
       }
   }

   or just ask the converter bean to install itself into the Standard Dialect:

   import hu.inbuss.thymeleaf.jaxrs.ParamConverterBridge;
   import javax.inject.Inject;
   import org.thymeleaf.TemplateEngine;
   
   public class ExampleApplication {
       @Inject private ParamConverterBridge pcb;
       private final TemplateEngine engine;
   
       public ExampleApplication() {
           engine = new TemplateEngine();
           pcb.installInto(engine);
           /* do other setup */
       }
   }

4. You're ready. Register ParamConverters for some type yourself or include a library that does so, and use the double-brace syntax when including values of that type in templates. Remember: the Conversion Service only drives double-brace expressions (e.g. ${{user.lastLogin}}). Single-brace ones (${user.lastLogin}) are not affected by this library, and will keep using toString() just like before.

INBUSS Kft.

Versions

Version
0.0.9 Oct 4, 2016