rythmengine/spring-rythm

Enable SpringFramework application developer to use Rythm template engine

Rythm Template Engine

A "Razor" like, rich featured, high performance and easy to use Java template engine

Rythm Engine Project

We are looking for people to join us on this project. Please contact Green Luo via [email protected]

Links

• The documentation
• The fiddle site
• The project info
• The JavaDocs

Integrations

• play-rythm for Play!Framework 1.x. And the document for play-rythm
• spring-rythm for Spring 3.x, and the samples for learning how to use spring-rythm
• jfinal-rythm for JFinal and the sample to learn how to use jfinal-rythm
• ninja-rythm for NinjaFramework
• Profiwiki - allows Rythm templates to be integrated in MediaWiki pages

Prerequisites

Java JDK >= Version 7

Distribution

Available at Maven Central see

http://mvnrepository.com/artifact/org.rythmengine/rythm-engine

Maven dependency:

<!-- http://mvnrepository.com/artifact/org.rythmengine/rythm-engine -->
<dependency>
    <groupId>org.rythmengine</groupId>
    <artifactId>rythm-engine</artifactId>
    <version>1.3.0</version>
</dependency>

How to build

git clone https://github.com/rythmengine/rythmengine
cd rythmengine
mvn install

if some of the tests should fail you might want to file an issue and try

mvn install -DskipTests=true

Testing

mvn test
...
Tests run: 254, Failures: 0, Errors: 0, Skipped: 3

Development

There are several options for development environments you can use to contribute to the development of the Rythm Engine Project:

• Pure Maven command line https://maven.apache.org/
• Eclipse https://eclipse.org/
• IntelliJ IDEA https://www.jetbrains.com/idea/

Version history

See the change log

spring-rythm's Issues

integration for spring 4

I integrate this to spring mvc 4.1 successfully today.
And there need some changing for migrating to spring 4.1 from 3.*, because one new method [ configurePathMatch ] has been added to interface WebMvcConfigurer need be implemented by RythmConfigure class in [spring-rythm] project.
So there may be a new branch for spring since 4.0.3.
I just add a simple implementation like below:
@OverRide
public void configurePathMatch(PathMatchConfigurer configurer) {
}

Spring security integration

This is a feature request to provide something like http://www.thymeleaf.org/springsecurity.html

Is there any tutorial for how to use this plug-in?

I found there is no any clue for using this plugin.

session/flash not saved to response when response is triggered by throwing a Result

if response is triggered by throwing out certain result, e.g. NotFound, or Redirect, the session/flash is not saved to response

Support httpOnly for session and flash cookie

as title

Allow SessionManaager support ping request

for ping request, it does not set the new timestamp value to session cookie based on current system timestamp and the expiration time. Instead it shall set the timestamp value to the existing timestamp value. For ping request it shall not create new session if existing timestamp is expired as well

@i18n Throw An Exception

The following exception:

Generic Rythm Exception: No message found under code 'mapping.name' for locale 'en'.

when I try to use @i18n("mapping.name")

Content inside messages.properties:

mapping.addr1=Address1
mapping.addr2=Address2
mapping.addr3=Address3
mapping.email=Email
mapping.fax=FAX
mapping.lot=Lot
mapping.mobile=Mobile
mapping.name=Name
mapping.ownerName=Owner Name
mapping.pcode=Post Code
mapping.phone1=Phone1
mapping.phone2=Phone2
mapping.state=State
mapping.streetNo=Street Number
mapping.streetName=Street Name
mapping.suburb=Suburb
mapping.tenantEmail=Tenant Email
mapping.tenantMobile=Tenant Mobile
mapping.tenantName=Tenant Name
mapping.tenantPhone1=Tenant Phone1
mapping.tenantPhone2=Tenant Phone2

Product error template is not used when exception raised in template rendering process

If there is an exception encountered in template rendering, it shall use the "errors/prod/500.html" template instead of the debug error screen (errors/500.html) when rythm engine is running in prod mode.