Spring MVC (2) 注解方式 + 数据校验
-
pom.xml
使用maven项目创建,添加相关依赖
spring-webmvc:添加依赖自动生成8个相关包
添加插件,jdk和tomcat
<?xml version="1.0" encoding="UTF-8"?> <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/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.shj</groupId> <artifactId>SpringMVC_test</artifactId> <version>1.0-SNAPSHOT</version> <packaging>war</packaging> <build> <plugins> <!-- define the project compile level --> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.6.1</version> <configuration> <source>1.8</source> <target>1.8</target> </configuration> </plugin> <!-- 添加tomcat插件 --> <plugin> <groupId>org.apache.tomcat.maven</groupId> <artifactId>tomcat7-maven-plugin</artifactId> <version>2.2</version> <configuration> <path>/</path> <port>8080</port> </configuration> </plugin> </plugins> </build> <dependencies> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>4.3.6.RELEASE</version> </dependency> <dependency> <groupId>javax.servlet.jsp</groupId> <artifactId>jsp-api</artifactId> <version>2.2</version> <scope>provided</scope> </dependency> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>3.0.1</version> <scope>provided</scope> </dependency> <dependency> <groupId>jstl</groupId> <artifactId>jstl</artifactId> <version>1.2</version> </dependency> </dependencies> </project>
-
web.xml配置
添加DispatcherServlet前端控制器,需要设置contextConfigLocation固定name.如果不设置,Spring MVC则会自动在WEB-INF下查找[servlet-name].servlet.xml文件当做SpringMVC的配置文件.
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" id="WebApp_ID" version="3.0"> <servlet> <servlet-name>dispatcherServlet</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:spring-mvc.xml</param-value> </init-param> </servlet> <servlet-mapping> <servlet-name>dispatcherServlet</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping> </web-app>
-
配置SpringMVC.xml
将SpringMVC.xml 放入classpath下,如果没有在web.xml配置contextConfigLocation则需要放入WEB-INF下,并命名为[servlet-name].servlet.xml
-
此案例中分别配置了视图解析器,消息资源管理器,servlet处理器,注解驱动,包扫描
视图解析器：InternalResourceViewResolver， 该属性里可以分别配置前缀和后缀，为了保证程序的安全性，可以将页面放在/WEB-INF/view/下，所以前缀可以直接配置为该值。如果没有这方面的需求，不配置该属性，则前缀为/，代表的是webapp目录，后缀可以根据项目需要设置为.jsp或者.html
消息资源：ReloadableResourceBundleMessageSource，该bean的配置有一个要求，id必须叫做messageSource，Spring MVC框架会读取该id所对应的bean对象来读取资源配置文件，里面设置了basename属性，用作读取该文件，该文件的配置只需要文件名，不能加后缀，为了更好的实现国际化，我们可以在msg文件后面拼接语言和国家，比如msg_zh_CN, msg_en_US以及其他国家的语言均可以按照这种方式来设定。有些ide环境可能只认识resources，则可以将msg文件放入resources目录下，否则不同的ide环境找不到该文件
缺省servlet处理器：mvc:default-servlet-handler，该配置可以保证Spring MVC项目可以直接访问静态资源，比如可以直接访问index.html
注解驱动器:mvc:annotation-driven,该配置使得当前项目可以使用注解来完成配置。在控制器类之上，可以添加Controller注解，里面还有RequestMapping，GetMapping，PostMapping，PathVariable等注解，可以完成各自的功能
上下文的包扫描：context:component-scan，使用该配置，可以使得该basePackage所对应的包下的所有Component组件直接被扫描出来使用，前提是需要在类之上添加@Component注解，但是我们的Controller以及后面要用的Service和Repositoy也都是Component组件，所以可以直接被扫描出来进行使用
<?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:mvc="http://www.springframework.org/schema/mvc" xmlns:context="http://www.springframework.org/schema/context" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd"> <!--视图资源解析器--> <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="prefix" value="/WEB-INF/view/"/> <property name="suffix" value=".jsp"/> </bean> <!--配置默认的servlet处理器,使得静态页面也可以直接访问--> <mvc:default-servlet-handler/> <!--包扫描--> <context:component-scan base-package="com.qfedu.controller"/> <!--配置注解驱动--> <mvc:annotation-driven/> <bean id="messageSource" class="org.springframework.context.support.ReloadableResourceBundleMessageSource"> <property name="basename" value="classpath:msg"/> </bean> </beans>
-
创建实例化对象product
public class Product { private String pname; private int pid; private double price; public String getPname() { return pname; } public void setPname(String pname) { this.pname = pname; } public int getPid() { return pid; } public void setPid(int pid) { this.pid = pid; } public double getPrice() { return price; } public void setPrice(double price) { this.price = price; } @Override public String toString() { final StringBuilder sb = new StringBuilder("Product{"); sb.append("pname='").append(pname).append('\''); sb.append(", pid=").append(pid); sb.append(", price=").append(price); sb.append('}'); return sb.toString(); } }
-
在Controller包新建ProductController类
Controller，代表当前类是一个控制器类，注意，通过查看源码，我们发现该类也是一个Component，所以刚刚的配置包扫描可以直接扫描到当前类，并将其作为一个组件来使用
RequestMapping，请求映射，目的是将某一个请求，映射到具体方法之上。该注解可以使用在类之上，也可以使用在方法之上。如果类和方法都有该配置，那么访问该方法的时候，需要同时拼接类之上的路径和方法之上的路径才能够访问该具体的方法。该注解可以使用method来区分不同的请求，method = RequestMethod.POST，或者GET可以分别来处理post和get请求
PostMapping和GetMapping也代表请求映射，使用起来会更直观，分别代表处理post和get的请求方式，但是这俩属性只能用于spring 4.3之后的版本。
PathVariable：路径变量，可以用来做路径传参功能，该功能相对于问号传参更加方便，可以直接指定变量的数据类型，而无需再做数据类型的转换，也可以实现传入多个参数，/{abc}/{xyz},方法里面可以使用 public String getPath（@PathVariable int abc，@PathVariable String xyz）方式来接收。注意路径传参会多一级目录，要注意访问路径
该类中的updateEmp（Emp e）方法再特别说一下：该方法可以自动接收表单里面的数据并将其封装为一个Emp对象，注意表单中的控件名一定要和Bean中的Emp类的属性要完全一致，否则找不到某些属性，这个也是Spring MVC中非常便利的地方，可以省去类型转换和封装对象的过程
该类中的方法都参数均很灵活，在需要的地方添加参数就可以直接使用
该类中的方法都返回值为String的都代表最终的展示页面。如果带有redirect，则代表重定向，意思是重定向到某一个具体的请求。
一个控制器里可以同时存在相同的路径url但是是不同的请求方式
关于校验这里，第一个GetMapping("/saveEmp")代表以get方式请求该资源，里面写了一个ModelAndView对象，传了三个参数，第一个是viewname，视图名，拼接上前后缀可以得到真正的物理视图，来打开该物理视图所对应的页面，第二个参数为modelname，模型名，相当于给模型起名字，这里要注意，该模型名意识要被叫做bean对象的小写形式Emp（emp），第三个参数为modelObject，模型对象，将该对象通过模型名传递给第一个参数viewname所对应的页面，在那个页面中可以渲染该数据
关于校验的第二个PostMapping("/saveEmp"),该注解的意思是页面上的表单通过post请求将saveEmp的请求来在这里进行处理。该方法包含有三个参数，第一个是Emp对象，可以自动封装表单中的属性为Bean对象，第二个参数为BindingResult对象，该对象我们通过源码可以发现是Spring中的Errors的子接口，可以用来接收并存储错误信息，这个对象可以接收从EmpValidate校验类中产生的错误信息，存储以交给错误页面的f：errors标签来展示错误信息，第三个参数是Model对象，可以用来储存对象，目的是可以使的bean对象的错误数据进行回显
import com.qfedu.bean.Product; import com.qfedu.service.ProductService; import com.qfedu.validate.EmpValidate; import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.validation.Errors; import org.springframework.web.bind.annotation.PathVariable; import org.springframework.web.bind.annotation.RequestMapping; import javax.servlet.http.HttpServletRequest; import java.util.List; /*标识为Controller,内部实现Component注解,可以被扫描到*/ @Controller public class ProductController { private ProductService productService = new ProductService(); @RequestMapping("/up") public String UpProduct() { return "index"; } /** * 获得上传信息 * * @param request * @param model * @return */ @RequestMapping("/show") public String show(HttpServletRequest request, Model model) { int pid = Integer.parseInt(request.getParameter("pid")); String pname = request.getParameter("pname"); double price = Double.parseDouble(request.getParameter("price")); Product product = new Product(); product.setPid(pid); product.setPname(pname); product.setPrice(price); model.addAttribute("p", product); return "detail"; } @RequestMapping("/upload/{id}") public String getId(@PathVariable int id) { System.out.println(id); return null; } /** * 得到所有的数据 * * @param model * @return */ @RequestMapping("/getAll") public String getAll(Model model) { List<Product> all = productService.getAll(); model.addAttribute("all", all); return "main"; } @RequestMapping("/update/{id}") public String update(@PathVariable int id, Model model) { Product product = productService.getProduct(id); model.addAttribute("product", product); return "update"; } @RequestMapping("/validate") public String validate(Product product, Errors errors, Model model) { EmpValidate empValidate = new EmpValidate(); empValidate.validate(product, errors); if (errors.hasErrors()) { model.addAttribute("product", product); return "update"; } return "redirect:/getAll"; } }
-
创建EmpValidate实现Validator作为对Product的数据校验
其中包含俩个方法,supports和validate:
supports:添加需要校验的实体类
validate:具体的校验方法
-
ValidationUtils工具类实现对非空字段的校验,其中包含三个参数
- 错误对象,储存错误的信息
- 需要校验的字段
- 在对应的配置文件中 配置的key的信息
import com.qfedu.bean.Product; import org.springframework.validation.Errors; import org.springframework.validation.ValidationUtils; import org.springframework.validation.Validator; public class EmpValidate implements Validator { /** * 指定当前类是否支持制定类的校验 * * @param clazz * @return */ @Override public boolean supports(Class<?> clazz) { return Product.class.isAssignableFrom(clazz); } /** * 校验方法 * * @param target * @param errors */ @Override public void validate(Object target, Errors errors) { Product p = (Product) target; ValidationUtils.rejectIfEmpty(errors, "pid", "p.pid"); ValidationUtils.rejectIfEmpty(errors, "price", "p.price"); double price = p.getPrice(); if (price < 0) { errors.rejectValue("price", "p.price.disqualification"); } } }
-
main.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %> <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <%@ taglib prefix="f" uri="http://www.springframework.org/tags/form" %> <html> <head> <title>main</title> </head> <body> <c:if test="${all != null}"> <table border="1" align="center" width="80%"> <tr> <th>eid</th> <th>name</th> <th>salary</th> <th>manage</th> </tr> <c:forEach items="${all}" var="e"> <tr> <td> ${e.pid}</td> <td> ${e.pname}</td> <td> ${e.price}</td> <td> <a href="/update/${e.pid}">update</a> <a href="/emp/deleteByEid/${e.pid}">delete</a></td> </tr> </c:forEach> </table> </c:if> </body> </html>
-
update.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %> <%@ taglib prefix="f" uri="http://www.springframework.org/tags/form" %> <html> <head> <title>product input page</title> </head> <body> <h1>this is product input page</h1> <f:form method="post" action="/validate" commandName="product"> pid:<f:input type="text" name="pid" path="pid"/> <f:errors path="pid" /><br> pname:<f:input type="text" name="pname" path="pname"/><f:errors path="pname" /> <br> price:<f:input type="text" name="price" path="price"/><f:errors path="price" /> <br> <input type="submit"> </f:form> </body> </html>
