Trong bài viết này chúng tôi giới thiệu đến các bạn sử dụng tổ hợp nhiều kỹ thuật khác nhau:
- Spring Web MVC 4
- Hibernate Validator
- Maven build tool
Chúng ta sẽ xây dựng ứng dụng gồm 2 màn hình: màn hình nhập thông tin và màn hình thông báo kết quả thành công như sau:
Kết quả trả về sau khi đã validate (kiểm tra dữ liệu đầu vào)
Các bước thực hiện
Tạo mới project sử dụng Maven archetype
maven-archetype-webapp . Nếu bạn chưa rõ về cách tạo project từ archetype, bạn có thể xem phần đầu bài viết
Kỹ thuật Autowiring sử dụng annotation trong Spring Framework . Một project khuôn được tạo ra, bạn cần bổ sung thêm các thư mục (
src ,
main ,
java ), khai báo thêm thư viện để project có được cấu trúc như sau:
File pom.xml đầy đủ như bên dưới, Bạn cần khai báo các thư viện. Mỗi thư viện đều được khai báo 3 thông số GAV (Group – ArtifactId – Version). Chúng tôi sử dụng phiên bản mới nhất tại thời điểm viết bài.
- spring-core
- spring-beans
- spring-context
- spring-web
- spring-webmvc
- hibernate-validator (để validate dữ liệu từ back-end)
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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
|
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>vn.smartJob.demoSpring</groupId>
<artifactId>beanvalidation</artifactId>
<packaging>war</packaging>
<version>1.0.0-SNAPSHOT</version>
<name>Spring Web MVC - Hibernate Validator SmartJob.vn</name>
<url>http://smartjob.vn/</url>
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
<version>4.2.6.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-beans</artifactId>
<version>4.2.6.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>4.2.6.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<version>4.2.6.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>4.2.6.RELEASE</version>
</dependency>
<dependency>
<groupId>org.hibernate</groupId>
<artifactId>hibernate-validator</artifactId>
<version>5.2.4.Final</version>
</dependency>
</dependencies>
<build>
<finalName>beanvalidation</finalName>
</build>
</project>
|
Luồng đi của một ứng dụng Spring Web MVC (tranh minh họa có nguồn từ: http://docs.spring.io/spring/docs/current/spring-framework-reference/html/mvc.html)
Tương ứng với mô hình tham chiếu như hình vẽ trên, cụ thể hóa trong ứng dụng mà chúng ta đang làm:
- Front controller: org.springframework.web.servlet.DispatcherServlet
- Controller: vn.smartjob.demospring.domain.JobController
- View template: Các file index.jsp, addJob.jsp, resultJob.jsp
- Model: Class vn.smartjob.demospring.domain.Job là một thành phần của model.
- Servlet engine: Chính là Apache Tomcat mà bạn sử dụng để deploy ứng dụng.
Là ứng dụng web, nên deployement descriptor rất quan trọng, file web.xml . Phần filter có tác dụng đảm bảo dữ liệu tiếng Việt Unicode được xử lý đúng. Phần xử lý luồng đi của Spring Web MVC được xử lý bởi classorg.springframework.web.servlet.DispatcherServlet
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
|
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
http://xmlns.jcp.org/xml/ns/javaee/webapp_3_1.xsd"
version="3.1">
<filter>
<filter-name>encodingFilter</filter-name>
<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
<init-param>
<param-name>forceEncoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>encodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<servlet>
<servlet-name>springmvc</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>springmvc</servlet-name>
<url-pattern>*.mvc</url-pattern>
</servlet-mapping>
</web-app>
|
Là một ứng dụng sử dụng Spring Framework, nên không thể thiếu beans configuration, file springmvc-servlet.xml
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
|
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc.xsd">
<context:component-scan base-package="vn.smartjob.demospring"/>
<context:annotation-config/>
<mvc:annotation-driven validator="validator" />
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/pages/" />
<property name="suffix" value=".jsp" />
</bean>
<bean id="messageSource" class="org.springframework.context.support.ReloadableResourceBundleMessageSource">
<property name="basename" value="classpath:messages" />
</bean>
<bean id="validator" class="org.springframework.validation.beanvalidation.LocalValidatorFactoryBean">
<property name="validationMessageSource" ref="messageSource"/>
</bean>
</beans>
|
Mỗi công việc (job) được mô tả bởi entity Job. Việc sử dụng các annotation nhằm mục đích để Hibernate Validator biết được rule validate.
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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
|
package vn.smartjob.demospring.domain;
import javax.validation.constraints.NotNull;
import javax.validation.constraints.Size;
import java.math.BigDecimal;
import java.util.Date;
public class Job {
@Size(min = 32, max = 256)
@NotNull
String title;
@NotNull
@Size(max = 256)
String company;
@NotNull
String companyAddress;
@NotNull
@Size(min = 128)
String content;
@NotNull
Date startDate;
@NotNull
Date endDate;
@NotNull
BigDecimal salary;
@NotNull
Date createDate;
public String getTitle() {
return title;
}
public void setTitle(String title) {
this.title = title;
}
public String getCompany() {
return company;
}
public void setCompany(String company) {
this.company = company;
}
public String getCompanyAddress() {
return companyAddress;
}
public void setCompanyAddress(String companyAddress) {
this.companyAddress = companyAddress;
}
public String getContent() {
return content;
}
public void setContent(String content) {
this.content = content;
}
public Date getStartDate() {
return startDate;
}
public void setStartDate(Date startDate) {
this.startDate = startDate;
}
public Date getEndDate() {
return endDate;
}
public void setEndDate(Date endDate) {
this.endDate = endDate;
}
public BigDecimal getSalary() {
return salary;
}
public void setSalary(BigDecimal salary) {
this.salary = salary;
}
public Date getCreateDate() {
return createDate;
}
public void setCreateDate(Date createDate) {
this.createDate = createDate;
}
}
|
Trong controller xử lý luồng đi của ứng dụng, có 2 method để xử lý 2 màn hình: Màn hình thêm công việc và màn hình hiển thị thông báo thành công. Mỗi method đều được gắn annotation @RequestMapping của Spring Framework.
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
|
package vn.smartjob.demospring.controller;
import vn.smartjob.demospring.domain.Job;
import org.springframework.stereotype.Controller;
import org.springframework.validation.BindingResult;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.servlet.ModelAndView;
@Controller
public class JobController {
@RequestMapping(value = "/form")
public ModelAndView job() {
return new ModelAndView("addJob", "job", new Job());
}
@RequestMapping(value = "/result", method = RequestMethod.POST)
public ModelAndView processJob(Job job, BindingResult result) {
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("j", job);
if (result.hasErrors()) {
modelAndView.setViewName("addJob");
} else {
modelAndView.setViewName("resultJob");
}
return modelAndView;
}
}
|
Trang addJob.jsp là giao diện để thêm công việc mới. Trong file JSP có phần CSS, phần này chỉ có tác dụng giúp giao diện nhập dữ liệu công việc và hiển thị thông báo thành công, kết quả được đẹp và dễ nhìn hơn. Không tác động vào nghiệp vụ cũng như luồng xử lý nghiệp vụ. Mỗi công việc có có các thuộc tính như sau (được tô màu highlight trong mã nguồn):
- title: Tiêu đề công việc
- company: Công ty cần tuyển người
- companyAddress: Địa chỉ công ty, cũng thường là địa điểm làm việc
- content: Nội dung chi tiết: yêu cầu công việc, kỹ năng, các chế độ đãi ngộ
- startDate: ngày bắt đầu đăng tin
- endDate: ngày gỡ bỏ tin tuyển dụng
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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
<%@ page contentType="text/html;charset=UTF-8" %>
<%@taglib prefix="mvc" uri="http://www.springframework.org/tags/form" %>
<html>
<head>
<title>Thêm công việc mới</title>
<style type="text/css">
.error {
background-color: #f00;
}
table{
width: 600px;
background-color: lightblue;
}
td{
width: 300px;
}
</style>
</head>
<body>
<h2>Thêm công việc mới</h2>
<mvc:form modelAttribute="job" action="result.mvc">
<table>
<tr>
<td><mvc:label path="title">Tiêu đề công việc</mvc:label></td>
<td><mvc:input path="title" cssErrorClass="error"/></td>
<td><mvc:errors path="title"/></td>
</tr>
<tr>
<td><mvc:label path="company">Công ty</mvc:label></td>
<td><mvc:input path="company" cssErrorClass="error"/></td>
<td><mvc:errors path="company"/></td>
</tr>
<tr>
<td><mvc:label path="companyAddress">Địa chỉ làm việc</mvc:label></td>
<td><mvc:input path="companyAddress" cssErrorClass="error"/></td>
<td><mvc:errors path="companyAddress"/></td>
<td></td>
</tr>
<tr>
<td><mvc:label path="content">Nội dung tuyển dụng</mvc:label></td>
<td><mvc:textarea path="content" cssErrorClass="error"/></td>
<td><mvc:errors path="content"/></td>
</tr>
<tr>
<td><mvc:label path="salary">Mức lương</mvc:label></td>
<td><mvc:input path="salary" cssErrorClass="error"/></td>
<td><mvc:errors path="salary"/></td>
</tr>
<tr>
<td><mvc:label path="startDate">Ngày bắt đầu đăng tin (mm/dd/yyyy)</mvc:label></td>
<td><mvc:input path="startDate" cssErrorClass="error"/></td>
<td><mvc:errors path="startDate"/></td>
</tr>
<tr>
<td><mvc:label path="endDate">Ngày gỡ bỏ tin (mm/dd/yyyy)</mvc:label></td>
<td><mvc:input path="endDate" cssErrorClass="error"/></td>
<td><mvc:errors path="endDate"/></td>
</tr>
<tr>
<td colspan="3">
<input type="submit" value="Gửi">
</td>
</tr>
</table>
</mvc:form>
</body>
</html>
|
Trang resultJob.jsp là giao diện để thông báo thành công và trả về kết quả
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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
|
<%@ page contentType="text/html;charset=UTF-8" %>
<%@taglib prefix="mvc" uri="http://www.springframework.org/tags/form" %>
<html>
<head>
<title>Kết quả</title>
<style type="text/css">
.error {
background-color: #f00;
}
table{
width: 600px;
background-color: lightblue;
}
td{
width: 300px;
}
</style>
</head>
<body>
<h2>Nội dung công việc đã gửi</h2>
<table>
<tr>
<td>Tiêu đề công việc</td>
<td>${j.title}</td>
</tr>
<tr>
<td>Công ty</td>
<td>${j.company}</td>
</tr>
<tr>
<td>Địa chỉ làm việc</td>
<td>${j.companyAddress}</td>
</tr>
<tr>
<td>Nội dung</td>
<td>${j.content}</td>
</tr>
<tr>
<td>Mức lương</td>
<td>${j.salary}</td>
</tr>
<tr>
<td>Ngày bắt đầu đăng tin</td>
<td>${j.startDate}</td>
</tr>
<tr>
<td>Ngày gỡ bỏ tin</td>
<td>${j.endDate}</td>
</tr>
</table>
</body>
</html>
|
File index.jsp để trỏ trang chủ website về trang thêm công việc mới (addJob.jsp)
|
|
<% response.sendRedirect("form.mvc");%>
|
Để đa ngôn ngữ (sau này), các item resources bundle được khai báo trong file messages.propertiess nằm trong thư mục resources (đây là thư mục quy ước theo cấu trúc project Maven):
|
|
NotNull.job.company=Tên công ty không được để trống
|
Bạn đã hoàn thành ứng dụng, và có thể deploy trên server Apache Tomcat, truy cập link http://localhost:8080 để xem kết quả (trên máy của bạn, có thể port Tomcat sẽ khác số 8080).
Nguồn: http://smartjob.vn/kiem-tra-tinh-hop-le-cua-du-lieu-dau-vao-form-spring-web-mvc-boi-hibernate-validator-4551/
