Spring MVC Toolkit

This toolkit provides additional features to the Spring MVC module of the Spring Framework.

Features

• Input tag supporting HTML 5 form validation by using Bean Validation constraints

Documentation

Html5InputTag

This JSP tag adds HTML 5 form validation to the default Spring MVC input tag by using Bean Validation constraints. It supports:

• @Max, @Min, @NotNull @Size annotations form the Bean Validation API.
• Custom @Email, @NotEmpty and @URL annotations from the Hibernate Validator implementation

Here the mapping between Java and HTML 5 code:

Java Code	JSP Page	Generated HTML 5
@NotEmpty String firstName;	<jem:input path="firstName" />	<input id="firstName" type="text" required="required" />
@NotNull String city;	<jem:input path="city" />	<input id="city" type="text" required="required" />
@Size(max=40) String address;	<jem:input path="address" />	<input id="address" type="text" maxlength="40" />
@Size(max=40) String address;	<jem:input path="address" maxlength="20" />	<input id="address" type="text" maxlength="20" />
@Min(value=18) @Max(value=99) Integer age;	<jem:input path="age" />	<input id="age" type="number" min="18" max="99" />
@Email String email;	<jem:input path="email" />	<input id="email" type="email" />
@URL String website;	<jem:input path="website" />	<input id="website" type="url" />
Integer birthYear;	<jem:input path="birthYear" />	<input id="birthYear" type="number" />

Tutorial

French articles on the javaetmoi.com blog:

• Validation HTML 5 avec Spring MVC et Bean Validation

Quick Start

Download the jar though Maven:

<dependency>
  <groupId>com.javaetmoi.core</groupId>
  <artifactId>spring-mvc-toolkit</artifactId>
  <version>0.1</version>
</dependency> 

Spring MVC Toolkit artefacts are available from Maven Central

Demo

Download the code with git:

git clone git://github.com/arey/spring-mvc-toolkit.git

Compile the code with maven:

cd spring-mvc-tookit
mvn clean install

Run jetty

cd spring-mvc-toolkit-demo
mvn jetty:run-war

Open your browser and goto:

• http://localhost:8080/htmlvalidation for demo of the Html5InputTag

Contributing to Spring MVC Tookit

• Github is for social coding platform: if you want to write code, we encourage contributions through pull requests from forks of this repository. If you want to contribute code this way, please reference a GitHub ticket as well covering the specific issue you are addressing.

Development environment installation

Download the code with git: git clone git://github.com/arey/spring-mvc-toolkit.git

Compile the code with maven: mvn clean install

If you're using an IDE that supports Maven-based projects (InteliJ Idea, Netbeans or m2Eclipse), you can import the project directly from its POM. Otherwise, generate IDE metadata with the related IDE maven plugin: mvn eclipse:clean eclipse:eclipse

Release Note

Version	Release date	Features
0.2.0-SNAPSHOT	next version
0.1	30/08/2014	Html5InputTag for HTML 5 validation from Bean Validation constraints

Credits

• Uses Maven as a build tool
• Uses Cloudbees and Travis CI for continuous integration builds whenever code is pushed into GitHub

Build Status

Travis :

Cloudbees Jenkins :