Additional features to the Spring MVC module of the Spring Framework
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
spring-mvc-toolkit-demo
spring-mvc-toolkit
.gitignore
.travis.yml
license.html
pom.xml
readme.md

readme.md

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:

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:

Html 5 validation page Screenshot

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

VersionRelease dateFeatures
0.2.0-SNAPSHOTnext version
0.130/08/2014Html5InputTag 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 : Build Status

Cloudbees Jenkins : Build Status