Spring 3 MVC: Handling Forms in Spring 3.0 MVC
[ad name=”AD_INBETWEEN_POST”] Welcome to the Part 3 of Spring 3.0 MVC Series. In previous article we created a Hello World application in Spring MVC. We leaned how to configure Spring MVC in web.xml and how to use different annotations like @Controller, @RequestMapping etc. In this article let us see how to handle forms in Spring 3.0 MVC. We will use the framework that we created in previous article as a base reference and add up the functionality of form in it. Also the application that we create will be a Contact Manager application. Related: Spring 3 MVC: Multiple Row Form Submit using List of Beans [sc:SpringMVC_Tutorials]

Our Goal

Our goal is to create basic Contact Manager application. This app will have a form to take contact details from user. For now we will just print the details in logs. We will learn how to capture the form data in Spring 3 MVC.

Getting Started

Let us add the contact form to our Spring 3 MVC Hello World application. Open the index.jsp file and change it to following: File: WebContent/index.jsp 
<jsp:forward page="contacts.html"></jsp:forward>

Code language: HTML, XML (xml)
The above code will just redirect the user to contacts.html page.

The View- contact.jsp

Create a JSP file that will display Contact form to our users. File: /WebContent/WEB-INF/jsp/contact.jsp 
<%@taglib uri="http://www.springframework.org/tags/form" prefix="form"%>
<html>
<head>
 <title>Spring 3 MVC Series - Contact Manager</title>
</head>
<body>
<h2>Contact Manager</h2>
<form:form method="post" action="addContact.html">

 <table>
 <tr>
  <td><form:label path="firstname">First Name</form:label></td>
  <td><form:input path="firstname" /></td> 
 </tr>
 <tr>
  <td><form:label path="lastname">Last Name</form:label></td>
  <td><form:input path="lastname" /></td>
 </tr>
 <tr>
  <td><form:label path="lastname">Email</form:label></td>
  <td><form:input path="email" /></td>
 </tr>
 <tr>
  <td><form:label path="lastname">Telephone</form:label></td>
  <td><form:input path="telephone" /></td>
 </tr>
 <tr>
  <td colspan="2">
   <input type="submit" value="Add Contact"/>
  </td>
 </tr>
</table> 
 
</form:form>
</body>
</html>

Code language: HTML, XML (xml)
Here in above JSP, we have displayed a form. Note that the form is getting submitted to addContact.html page.

Adding Form and Controller in Spring 3

We will now add the logic in Spring 3 to display the form and fetch the values from it. For that we will create two java files. First the Contact.java which is nothing but the form to display/retrieve data from screen and second the ContactController.java which is the spring controller class. File: net.viralpatel.spring3.form.Contact 
package net.viralpatel.spring3.form;

public class Contact {
 private String firstname;
 private String lastname;
 private String email;
 private String telephone;
 
 //.. getter and setter for all above fields.
 
}

Code language: Java (java)
The above file is the contact form which holds the data from screen. Note that I haven’t showed the getter and setter methods. You can generate these methods by pressiong Alt + Shift + S, R. File: net.viralpatel.spring3.controller.ContactController 
package net.viralpatel.spring3.controller;

import net.viralpatel.spring3.form.Contact;

import org.springframework.stereotype.Controller;
import org.springframework.validation.BindingResult;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.SessionAttributes;
import org.springframework.web.servlet.ModelAndView;

@Controller
@SessionAttributes
public class ContactController {

 @RequestMapping(value = "/addContact", method = RequestMethod.POST)
 public String addContact(@ModelAttribute("contact")
       Contact contact, BindingResult result) {
  
  System.out.println("First Name:" + contact.getFirstname() + 
     "Last Name:" + contact.getLastname());
  
  return "redirect:contacts.html";
 }
 
 @RequestMapping("/contacts")
 public ModelAndView showContacts() {
  
  return new ModelAndView("contact", "command", new Contact());
 }
}

Code language: Java (java)
In above controller class, note that we have created two methods with Request Mapping /contacts and /addContact. The method showContacts() will be called when user request for a url contacts.html. This method will render a model with name “contact”. Note that in the ModelAndView object we have passed a blank Contact object with name “command”. The spring framework expects an object with name command if you are using <form:form> in your JSP file. Also note that in method addContact() we have annotated this method with RequestMapping and passed an attribute method=”RequestMethod.POST”. Thus the method will be called only when user generates a POST method request to the url /addContact.html. We have annotated the argument Contact with annotation @ModelAttribute. This will binds the data from request to the object Contact. In this method we just have printed values of Firstname and Lastname and redirected the view to cotnacts.html.

That’s all folks

The form is completed now. Just run the application in eclipse by pression Alt + Shift + X, R. It will show the contact form. Just enter view values and press Add button. Once you press the button, it will print the firstname and lastname in sysout logs.

Download Source Code

Click here to download source code (7.43kb)

Moving on

In this article we learn how to create a form using Spring 3 MVC and display it in JSP. Also we learn how to retrieve the form values using ModelAttribute annotation. In next section we will go through form validations and different data conversion methods in Spring 3 MVC. Related: Spring 3 MVC Multiple Row Form Submit example

View Comments

  • Thanks for that spring3.0 applications. Can u provide the spring3.0 Group authorization example

  • Very nice tutorials, etc.

    I also think it'd be nice if you show a "List View" of the contacts. After you submit the new contact form, you are taken back to the list of contacts, with a status message of "New contact added".

  • No need to use tomcat. Spring providing the one of the tool is like SpringSourceTool. We can download this tool use it. Its very easy.

    • the @SessionAttributes typically list the names of contact attributes which should be transparently stored in the session or some conversational storage, serving as form-backing beans.

  • This tutorials have made it very easy for me to learn spring 3.They are really good.....I haven't found better ones on line.Thank you!!!

Leave a Comment
Share
Published by
Viral Patel
Tags: framework Spring spring mvc spring-3-mvc-series
14 years ago

Recent Posts

  • Java

Java URL Encoder/Decoder Example

Java URL Encoder/Decoder Example - In this tutorial we will see how to URL encode/decode…

4 years ago
  • General

How to Show Multiple Examples in OpenAPI Spec

Show Multiple Examples in OpenAPI - OpenAPI (aka Swagger) Specifications has become a defecto standard…

4 years ago
  • General

How to Run Local WordPress using Docker

Local WordPress using Docker - Running a local WordPress development environment is crucial for testing…

4 years ago
  • Java

Create and Validate JWT Token in Java using JJWT

1. JWT Token Overview JSON Web Token (JWT) is an open standard defines a compact…

4 years ago
  • Spring Boot

Spring Boot GraphQL Subscription Realtime API

GraphQL Subscription provides a great way of building real-time API. In this tutorial we will…

4 years ago
  • Spring Boot

Spring Boot DynamoDB Integration Test using Testcontainers

1. Overview Spring Boot Webflux DynamoDB Integration tests - In this tutorial we will see…

5 years ago