While developing a web application we usually come across some requirements that deal with capturing of data from the user in a form and then processing the same data on the server and returning any detailed result message to the user back.
In this article we will try out an example that uses html form along with spring mvc.
Spring MVC Form handling
In this example we will get employee details from the user and send it to the server.
1. Create a Spring Model
|
1 2 3 4 5 6 7 8 9 10 |
package com.kscodes.sampleproject.model; public class Employee { private String firstName; private String lastName; private int age; private double salary; private String department; // Setter Getter methods } |
2. Contoller to handle the requests
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 |
package com.kscodes.sampleproject.controller; import org.springframework.stereotype.Controller; 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.servlet.ModelAndView; import com.kscodes.sampleproject.model.Employee; @Controller public class EmployeeController { @RequestMapping("/employee") public ModelAndView getEmployee() { Employee employee = new Employee(); ModelAndView mv = new ModelAndView("employee"); mv.addObject("command", employee); return mv; } @RequestMapping(value = "/addEmployee", method = RequestMethod.POST) public ModelAndView addEmployee( @ModelAttribute("employee") Employee employee) { // Save the Employee data in Database ModelAndView mv = new ModelAndView("success"); mv.addObject("name", employee.getFirstName() + " " + employee.getLastName()); return mv; } } |
In the getEmployee() method we set a empty Employee bean in the model with the name “command”.
Note that the command attribute needs to be set so that form tag in the jsp page uses the empty bean.
3. JSP page
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 |
<%@taglib uri="http://www.springframework.org/tags/form" prefix="form"%> <html> <head> <title>Spring MVC - Employee</title> </head> <body> <h2>Login</h2> <form:form method="post" action="addEmployee"> <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="age">Age</form:label></td> <td><form:input path="age" /></td> </tr> <tr> <td><form:label path="department">Department</form:label></td> <td><form:input path="department" /></td> </tr> <tr> <td><form:label path="salary">Salary</form:label></td> <td><form:input path="salary" /></td> </tr> <tr> <td colspan="2"><input type="submit" value="Submit" /></td> </tr> </table> </form:form> </body> </html> |
For using the Form tag we need to add the tag libs as shown below
<%@taglib uri="http://www.springframework.org/tags/form" prefix="form"%>
When user enters the data and submits the form, controller method
addEmployee(@ModelAttribute("employee") Employee employee) is called.
The parameter passed is data filled in the form, mapped as Employee bean. You can process the data/ save data in database and then return the success/failure message to user.
Output
Open the empty form using http://localhost:8080/sampleproject/employee
Submit the data once form is filled
