Spring MVC
Spring MVC 是目前主流的实现 MVC 设计模式的企业级开发框架,Spring 框架的一个子模块,无需整合,开发起来更加便捷。
什么是 MVC 设计模式?
将应用程序分为 Controller、Model、View 三层,Controller 接收客户端请求,调用 Model 生成业务数据,传递给 View。
Spring MVC 就是对这套流程的封装,屏蔽了很多底层代码,开放出接口,让开发者可以更加轻松、便捷地完成基于 MVC 模式的 Web 开发。
处理流程
-
一个请求匹配前端控制器 DispatcherServlet 的请求映射路径(在 web.xml中指定), WEB 容器将该请求转交给 DispatcherServlet 处理
-
DispatcherServlet 接收到请求后, 将根据 请求信息 交给 处理器映射器 (HandlerMapping)
-
HandlerMapping 根据用户的url请求 查找匹配该url的 Handler,并返回一个执行链
-
DispatcherServlet 再请求 处理器适配器(HandlerAdapter) 调用相应的 Handler 进行处理并返回 ModelAndView 给 DispatcherServlet
-
DispatcherServlet 将 ModelAndView 请求 ViewReslover(视图解析器)解析,返回具体 View
-
DispatcherServlet 对 View 进行渲染视图(即将模型数据填充至视图中)
-
DispatcherServlet 将页面响应给用户
组件说明
用户请求到达前端控制器,它就相当于mvc模式中的c,dispatcherServlet是整个流程控制的中心,
由它调用其它组件处理用户的请求,dispatcherServlet的存在降低了组件之间的耦合性。
HandlerMapping负责根据用户请求url找到Handler即处理器,springmvc提供了不同的映射器实现不同的映射方式,
例如:配置文件方式,实现接口方式,注解方式等。
Handler 是继DispatcherServlet前端控制器的后端控制器,在DispatcherServlet的控制下Handler对具体的用户请求进行处理。
由于Handler涉及到具体的用户业务请求,所以一般情况需要程序员根据业务需求开发Handler。
通过HandlerAdapter对处理器进行执行,这是适配器模式的应用,通过扩展适配器可以对更多类型的处理器进行执行。
View Resolver负责将处理结果生成View视图,View Resolver首先根据逻辑视图名解析成物理视图名即具体的页面地址,
再生成View视图对象,最后对View进行渲染将处理结果通过页面展示给用户。
springmvc框架提供了很多的View视图类型的支持,包括:jstlView、freemarkerView、pdfView等。我们最常用的视图就是jsp。
一般情况下需要通过页面标签或页面模版技术将模型数据通过页面展示给用户,需要由程序员根据业务需求开发具体的页面。
如何使用?
- 创建 Maven 工程,pom.xml
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.0.11.RELEASE</version>
</dependency>
</dependencies>
- 在 web.xml 中配置 DispatcherServlet。
<!DOCTYPE web-app PUBLIC
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd" >
<web-app>
<display-name>Archetype Created Web Application</display-name>
<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:springmvc.xml</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>dispatcherServlet</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
- springmvc.xml
<?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-3.2.xsd">
<!-- 自动扫描 -->
<context:component-scan base-package="com.southwind"></context:component-scan>
<!-- 配置视图解析器 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/"></property>
<property name="suffix" value=".jsp"></property>
</bean>
</beans>
- 创建 Handler
package com.southwind.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class HelloHandler {
@RequestMapping("/index")
public String index(){
System.out.println("执行了index...");
return "index";
}
}
静态资源处理
处理的是 使用/ 替换了tomcat默认servlet处理
有三种方式:
- 方式一:手动排除法
在我们的web.xml
添加如下配置
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.jpg</url-pattern>
</servlet-mapping>
其他地方保持不变,这个粒度显然是比<url-pattern>/</url-pattern>
更小的,它会将*.jpg文件交给servlet-name
为default的servlet去处理该请求,默认的servlet为什么就没有拦截了呢?因为它是直接访问。
当然不好的地方是,如果你需要拦截*.html
又得配一个,所以比较麻烦。一般不采用
- 方式二:在springmvc的配置文件中加入
<mvc:default-servlet-handler/>
<mvc:default-servlet-handler/>
- 方式三:在springmvc配置文件中手动指定静态资源路径(一般情况使用这种)
<!-- 设置静态资源不过滤 -->
<mvc:resources location="/css/" mapping="/css/**" />
<mvc:resources location="/img/" mapping="/img/**" />
<mvc:resources location="/js/" mapping="/js/**" />
<mvc:resources location="/plugins/" mapping="/plugins/**" />
,这种方式更灵活,功能更丰富,也是可以的
Spring MVC 注解
- @RequestMapping
Spring MVC 通过 @RequestMapping 注解将 URL 请求与业务方法进行映射,在 Handler 的类定义处以及方法定义处都可以添加 @RequestMapping ,在类定义处添加,相当于客户端多了一层访问路径。
- @Controller
@Controller 在类定义处添加,将该类交个 IoC 容器来管理(结合 springmvc.xml 的自动扫描配置使用),同时使其成为一个控制器,可以接收客户端请求。
package com.southwind.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
@RequestMapping("/hello")
public class HelloHandler {
@RequestMapping("/index")
public String index(){
System.out.println("执行了index...");
return "index";
}
}
- @RequestMapping 相关参数
1、value:指定 URL 请求的实际地址,是 @RequestMapping 的默认值。
@RequestMapping("/index")public String index(){ System.out.println("执行了index..."); return "index";}
等于
@RequestMapping(value="/index")public String index(){ System.out.println("执行了index..."); return "index";}
2、method:指定请求的 method 类型,GET、POST、PUT、DELET。
@RequestMapping(value = "/index",method = RequestMethod.GET)public String index(){ System.out.println("执行了index..."); return "index";}
上述代码表示 index 方法只能接收 GET 请求。
3、params:指定请求中必须包含某些参数,否则无法调用该方法。
@RequestMapping(value = "/index",method = RequestMethod.GET,params = {"name","id=10"})public String index(){ System.out.println("执行了index..."); return "index";}
上述代码表示请求中必须包含 name 和 id 两个参数,同时 id 的值必须是 10。
关于参数绑定,在形参列表中通过添加 @RequestParam 注解完成 HTTP 请求参数与业务方法形参的映射。
@RequestMapping(value = "/index",method = RequestMethod.GET,params = {"name","id=10"})public String index(@RequestParam("name") String str,@RequestParam("id") int age){ System.out.println(str); System.out.println(age); System.out.println("执行了index..."); return "index";}
上述代码表示将请求的参数 name 和 id 分别赋给了形参 str 和 age ,同时自动完成了数据类型转换,将 “10” 转为了 int 类型的 10,再赋给 age,这些工作都是由 HandlerAdapter 来完成的。
Spring MVC 也支持 RESTful 风格的 URL。
传统类型:http://localhost:8080/hello/index?name=zhangsan&id=10
REST:http://localhost:8080/hello/index/zhangsan/10
@RequestMapping("/rest/{name}/{id}")public String rest(@PathVariable("name") String name,@PathVariable("id") int id){ System.out.println(name); System.out.println(id); return "index";}
通过 @PathVariable 注解完成请求参数与形参的映射。
- 映射 Cookie
Spring MVC 通过映射可以直接在业务方法中获取 Cookie 的值。
@RequestMapping("/cookie")public String cookie(@CookieValue(value = "JSESSIONID") String sessionId){ System.out.println(sessionId); return "index";}
- 使用 JavaBean 绑定参数
Spring MVC 会根据请求参数名和 JavaBean 属性名进行自动匹配,自动为对象填充属性值,同时支持及联属性。
package com.southwind.entity;import lombok.Data;@Datapublic class Address { private String value;}
package com.southwind.entity;import lombok.Data;@Datapublic class User { private long id; private String name; private Address address;}
<%-- Created by IntelliJ IDEA. User: southwind Date: 2019-03-13 Time: 15:33 To change this template use File | Settings | File Templates.--%><%@ page contentType="text/html;charset=UTF-8" language="java" %><html><head> <title>Title</title></head><body> <form action="/hello/save" method="post"> 用户id:<input type="text" name="id"/><br/> 用户名:<input type="text" name="name"/><br/> 用户地址:<input type="text" name="address.value"/><br/> <input type="submit" value="注册"/> </form></body></html>
@RequestMapping(value = "/save",method = RequestMethod.POST)public String save(User user){ System.out.println(user); return "index";}
如果出现中文乱码问题,只需在 web.xml 添加 Spring MVC 自带的过滤器即可。
<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></filter><filter-mapping> <filter-name>encodingFilter</filter-name> <url-pattern>/*</url-pattern></filter-mapping>
- JSP 页面的转发和重定向:
Spring MVC 默认是以转发的形式响应 JSP。
1、转发
@RequestMapping("/forward")public String forward(){ return "forward:/index.jsp"; // return "index";}
2、重定向
@RequestMapping("/redirect")public String redirect(){ return "redirect:/index.jsp";}
返回值适用情况
ModelAndView(数据和视图)
返回值为视图和数据的包装类型,用于返回逻辑视图名称和视图需要展示的数据
等同于在Request中添加了属性,然后进行了请求转发
String
适合返回一个界面 通过字符串 进行forword转发操作
如果有@ResponseBaby这个注解 如果有返回数据
void
适合返回json数据 处理Ajax请求 手工写回json数据
Object
任意类型,自己把控
Spring MVC 数据绑定
数据绑定:在后端的业务方法中直接获取客户端 HTTP 请求中的参数,将请求参数映射到业务方法的形参中,Spring MVC 中数据绑定的工作是由 HandlerAdapter 来完成的。
- 基本数据类型
@RequestMapping("/baseType")@ResponseBodypublic String baseType(int id){ return id+"";}
@ResponseBody 表示 Spring MVC 会直接将业务方法的返回值响应给客户端,如果不加 @ResponseBody 注解,Spring MVC 会将业务方法的放回值传递给 DispatcherServlet,再由 DisptacherServlet 调用 ViewResolver 对返回值进行解析,映射到一个 JSP 资源。
- 包装类
@RequestMapping("/packageType")@ResponseBodypublic String packageType(@RequestParam(value = "num",required = false,defaultValue = "0") Integer id){ return id+"";}
包装类可以接收 null,当 HTTP 请求没有参数时,使用包装类定义形参的数据类型,程序不会抛出异常。
@RequestParam
value = “num”:将 HTTP 请求中名为 num 的参数赋给形参 id。
requried:设置 num 是否为必填项,true 表示必填,false 表示非必填,可省略。
defaultValue = “0”:如果 HTTP 请求中没有 num 参数,默认值为0.
- 数组
@RestController@RequestMapping("/data")public class DataBindHandler { @RequestMapping("/array") public String array(String[] name){ String str = Arrays.toString(name); return str; }}
@RestController 表示该控制器会直接将业务方法的返回值响应给客户端,不进行视图解析。
@Controller 表示该控制器的每一个业务方法的返回值都会交给视图解析器进行解析,如果只需要将数据响应给客户端,而不需要进行视图解析,则需要在对应的业务方法定义处添加 @ResponseBody。
@RestController@RequestMapping("/data")public class DataBindHandler { @RequestMapping("/array") public String array(String[] name){ String str = Arrays.toString(name); return str; }}
等同于
@Controller@RequestMapping("/data")public class DataBindHandler { @RequestMapping("/array") @ResponseBody public String array(String[] name){ String str = Arrays.toString(name); return str; }}
- List
Spring MVC 不支持 List 类型的直接转换,需要对 List 集合进行包装。
集合封装类
package com.southwind.entity;import lombok.Data;import java.util.List;@Datapublic class UserList { private List<User> users;}
JSP
<%-- Created by IntelliJ IDEA. User: southwind Date: 2019-03-14 Time: 09:12 To change this template use File | Settings | File Templates.--%><%@ page contentType="text/html;charset=UTF-8" language="java" %><html><head> <title>Title</title></head><body> <form action="/data/list" method="post"> 用户1编号:<input type="text" name="users[0].id"/><br/> 用户1名称:<input type="text" name="users[0].name"/><br/> 用户2编号:<input type="text" name="users[1].id"/><br/> 用户2名称:<input type="text" name="users[1].name"/><br/> 用户3编号:<input type="text" name="users[2].id"/><br/> 用户3名称:<input type="text" name="users[2].name"/><br/> <input type="submit" value="提交"/> </form></body></html>
业务方法
@RequestMapping("/list")public String list(UserList userList){ StringBuffer str = new StringBuffer(); for(User user:userList.getUsers()){ str.append(user); } return str.toString();}
处理 @ResponseBody 中文乱码,在 springmvc.xml 中配置消息转换器。
<mvc:annotation-driven> <!-- 消息转换器 --> <mvc:message-converters register-defaults="true"> <bean class="org.springframework.http.converter.StringHttpMessageConverter"> <property name="supportedMediaTypes" value="text/html;charset=UTF-8"></property> </bean> </mvc:message-converters></mvc:annotation-driven>
- Map
自定义封装类
package com.southwind.entity;import lombok.Data;import java.util.Map;@Datapublic class UserMap { private Map<String,User> users;}
业务方法
@RequestMapping("/map")public String map(UserMap userMap){ StringBuffer str = new StringBuffer(); for(String key:userMap.getUsers().keySet()){ User user = userMap.getUsers().get(key); str.append(user); } return str.toString();}
JSP
<%-- Created by IntelliJ IDEA. User: southwind Date: 2019-03-14 Time: 09:12 To change this template use File | Settings | File Templates.--%><%@ page contentType="text/html;charset=UTF-8" language="java" %><html><head> <title>Title</title></head><body> <form action="/data/map" method="post"> 用户1编号:<input type="text" name="users['a'].id"/><br/> 用户1名称:<input type="text" name="users['a'].name"/><br/> 用户2编号:<input type="text" name="users['b'].id"/><br/> 用户2名称:<input type="text" name="users['b'].name"/><br/> 用户3编号:<input type="text" name="users['c'].id"/><br/> 用户3名称:<input type="text" name="users['c'].name"/><br/> <input type="submit" value="提交"/> </form></body></html>
- JSON
客户端发生 JSON 格式的数据,直接通过 Spring MVC 绑定到业务方法的形参中。
处理 Spring MVC 无法加载静态资源,在 web.xml 中添加配置即可。
<servlet-mapping> <servlet-name>default</servlet-name> <url-pattern>*.js</url-pattern></servlet-mapping>
JSP
<%-- Created by IntelliJ IDEA. User: southwind Date: 2019-03-14 Time: 10:35 To change this template use File | Settings | File Templates.--%><%@ page contentType="text/html;charset=UTF-8" language="java" %><html><head> <title>Title</title> <script type="text/javascript" src="js/jquery-3.3.1.min.js"></script> <script type="text/javascript"> $(function(){ var user = { "id":1, "name":"张三" }; $.ajax({ url:"/data/json", data:JSON.stringify(user), type:"POST", contentType:"application/json;charset=UTF-8", dataType:"JSON", success:function(data){ alter(data.id+"---"+data.name); } }) }); </script></head><body></body></html>
业务方法
@RequestMapping("/json")public User json(@RequestBody User user){ System.out.println(user); user.setId(6); user.setName("张六"); return user;}
Spring MVC 中的 JSON 和 JavaBean 的转换需要借助于 fastjson,pom.xml 引入相关依赖。
<dependency> <groupId>com.alibaba</groupId> <artifactId>fastjson</artifactId> <version>1.2.32</version></dependency>
springmvc.xml 添加 fastjson 配置。
<mvc:annotation-driven> <!-- 消息转换器 --> <mvc:message-converters register-defaults="true"> <bean class="org.springframework.http.converter.StringHttpMessageConverter"> <property name="supportedMediaTypes" value="text/html;charset=UTF-8"></property> </bean> <!-- 配置fastjson --> <bean class="com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter4"></bean> </mvc:message-converters></mvc:annotation-driven>
Spring MVC 模型数据解析
JSP 四大作用域对应的内置对象:pageContext、request、session、application。
模型数据的绑定是由 ViewResolver 来完成的,实际开发中,我们需要先添加模型数据,再交给 ViewResolver 来绑定。
Spring MVC 提供了以下几种方式添加模型数据:
- Map
- Model
- ModelAndView
- @SessionAttribute
- @ModelAttribute
将模式数据绑定到 request 对象。
1、Map
@RequestMapping("/map")public String map(Map<String,User> map){ User user = new User(); user.setId(1L); user.setName("张三"); map.put("user",user); return "view";}
JSP
<%-- Created by IntelliJ IDEA. User: southwind Date: 2019-03-14 Time: 11:36 To change this template use File | Settings | File Templates.--%><%@ page contentType="text/html;charset=UTF-8" language="java" %><%@ page isELIgnored="false" %><html><head> <title>Title</title></head><body> ${requestScope.user}</body></html>
2、Model
@RequestMapping("/model")public String model(Model model){ User user = new User(); user.setId(1L); user.setName("张三"); model.addAttribute("user",user); return "view";}
3、ModelAndView
@RequestMapping("/modelAndView")public ModelAndView modelAndView(){ User user = new User(); user.setId(1L); user.setName("张三"); ModelAndView modelAndView = new ModelAndView(); modelAndView.addObject("user",user); modelAndView.setViewName("view"); return modelAndView;}@RequestMapping("/modelAndView2")public ModelAndView modelAndView2(){ User user = new User(); user.setId(1L); user.setName("张三"); ModelAndView modelAndView = new ModelAndView(); modelAndView.addObject("user",user); View view = new InternalResourceView("/view.jsp"); modelAndView.setView(view); return modelAndView;}@RequestMapping("/modelAndView3")public ModelAndView modelAndView3(){ User user = new User(); user.setId(1L); user.setName("张三"); ModelAndView modelAndView = new ModelAndView("view"); modelAndView.addObject("user",user); return modelAndView;}@RequestMapping("/modelAndView4")public ModelAndView modelAndView4(){ User user = new User(); user.setId(1L); user.setName("张三"); View view = new InternalResourceView("/view.jsp"); ModelAndView modelAndView = new ModelAndView(view); modelAndView.addObject("user",user); return modelAndView;}@RequestMapping("/modelAndView5")public ModelAndView modelAndView5(){ User user = new User(); user.setId(1L); user.setName("张三"); Map<String,User> map = new HashMap<>(); map.put("user",user); ModelAndView modelAndView = new ModelAndView("view",map); return modelAndView;}@RequestMapping("/modelAndView6")public ModelAndView modelAndView6(){ User user = new User(); user.setId(1L); user.setName("张三"); Map<String,User> map = new HashMap<>(); map.put("user",user); View view = new InternalResourceView("/view.jsp"); ModelAndView modelAndView = new ModelAndView(view,map); return modelAndView;}@RequestMapping("/modelAndView7")public ModelAndView modelAndView7(){ User user = new User(); user.setId(1L); user.setName("张三"); ModelAndView modelAndView = new ModelAndView("view","user",user); return modelAndView;}@RequestMapping("/modelAndView8")public ModelAndView modelAndView8(){ User user = new User(); user.setId(1L); user.setName("张三"); View view = new InternalResourceView("/view.jsp"); ModelAndView modelAndView = new ModelAndView(view,"user",user); return modelAndView;}
4、HttpServletRequest
@RequestMapping("/request")public String request(HttpServletRequest request){ User user = new User(); user.setId(1L); user.setName("张三"); request.setAttribute("user",user); return "view";}
5、@ModelAttribute
- 定义一个方法,该方法专门用来返回要填充到模型数据中的对象。
@ModelAttributepublic User getUser(){ User user = new User(); user.setId(1L); user.setName("张三"); return user;}
@ModelAttributepublic void getUser(Map<String,User> map){ User user = new User(); user.setId(1L); user.setName("张三"); map.put("user",user);}
@ModelAttributepublic void getUser(Model model){ User user = new User(); user.setId(1L); user.setName("张三"); model.addAttribute("user",user);}
- 业务方法中无需再处理模型数据,只需返回视图即可。
@RequestMapping("/modelAttribute")public String modelAttribute(){ return "view";}
将模型数据绑定到 session 对象
1、直接使用原生的 Servlet API。
@RequestMapping("/session")public String session(HttpServletRequest request){ HttpSession session = request.getSession(); User user = new User(); user.setId(1L); user.setName("张三"); session.setAttribute("user",user); return "view";}@RequestMapping("/session2")public String session2(HttpSession session){ User user = new User(); user.setId(1L); user.setName("张三"); session.setAttribute("user",user); return "view";}
2、@SessionAttribute
@SessionAttributes(value = {"user","address"})public class ViewHandler {}
对于 ViewHandler 中的所有业务方法,只要向 request 中添加了 key = “user”、key = “address” 的对象时,Spring MVC 会自动将该数据添加到 session 中,保存 key 不变。
@SessionAttributes(types = {User.class,Address.class})public class ViewHandler {}
对于 ViewHandler 中的所有业务方法,只要向 request 中添加了数据类型是 User 、Address 的对象时,Spring MVC 会自动将该数据添加到 session 中,保存 key 不变。
将模型数据绑定到 application 对象
@RequestMapping("/application")public String application(HttpServletRequest request){ ServletContext application = request.getServletContext(); User user = new User(); user.setId(1L); user.setName("张三"); application.setAttribute("user",user); return "view";}
Spring MVC 自定义数据转换器
数据转换器是指将客户端 HTTP 请求中的参数转换为业务方法中定义的形参,自定义表示开发者可以自主设计转换的方式,HandlerApdter 已经提供了通用的转换,String 转 int,String 转 double,表单数据的封装等,但是在特殊的业务场景下,HandlerAdapter 无法进行转换,就需要开发者自定义转换器。
客户端输入 String 类型的数据 “2019-03-03”,自定义转换器将该数据转为 Date 类型的对象。
- 创建 DateConverter 转换器,实现 Conveter 接口。
package com.southwind.converter;import org.springframework.core.convert.converter.Converter;import java.text.ParseException;import java.text.SimpleDateFormat;import java.util.Date;public class DateConverter implements Converter<String, Date> { private String pattern; public DateConverter(String pattern){ this.pattern = pattern; } @Override public Date convert(String s) { SimpleDateFormat simpleDateFormat = new SimpleDateFormat(this.pattern); Date date = null; try { date = simpleDateFormat.parse(s); } catch (ParseException e) { e.printStackTrace(); } return date; }}
- springmvc.xml 配置转换器。
<!-- 配置自定义转换器 --><bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean"> <property name="converters"> <list> <bean class="com.southwind.converter.DateConverter"> <constructor-arg type="java.lang.String" value="yyyy-MM-dd"></constructor-arg> </bean> </list> </property></bean><mvc:annotation-driven conversion-service="conversionService"> <!-- 消息转换器 --> <mvc:message-converters register-defaults="true"> <bean class="org.springframework.http.converter.StringHttpMessageConverter"> <property name="supportedMediaTypes" value="text/html;charset=UTF-8"></property> </bean> <!-- 配置fastjson --> <bean class="com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter4"></bean> </mvc:message-converters></mvc:annotation-driven>
- JSP
<%-- Created by IntelliJ IDEA. User: southwind Date: 2019-03-14 Time: 14:47 To change this template use File | Settings | File Templates.--%><%@ page contentType="text/html;charset=UTF-8" language="java" %><html><head> <title>Title</title></head><body> <form action="/converter/date" method="post"> 请输入日期:<input type="text" name="date"/>(yyyy-MM-dd)<br/> <input type="submit" value="提交"/> </form></body></html>
- Handler
package com.southwind.controller;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RestController;import java.util.Date;@RestController@RequestMapping("/converter")public class ConverterHandler { @RequestMapping("/date") public String date(Date date){ return date.toString(); }}
String 转 Student
StudentConverter
package com.southwind.converter;import com.southwind.entity.Student;import org.springframework.core.convert.converter.Converter;public class StudentConverter implements Converter<String, Student> { @Override public Student convert(String s) { String[] args = s.split("-"); Student student = new Student(); student.setId(Long.parseLong(args[0])); student.setName(args[1]); student.setAge(Integer.parseInt(args[2])); return student; }}
springmvc.xml
<!-- 配置自定义转换器 --><bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean"> <property name="converters"> <list> <bean class="com.southwind.converter.DateConverter"> <constructor-arg type="java.lang.String" value="yyyy-MM-dd"></constructor-arg> </bean> <bean class="com.southwind.converter.StudentConverter"></bean> </list> </property></bean><mvc:annotation-driven conversion-service="conversionService"> <!-- 消息转换器 --> <mvc:message-converters register-defaults="true"> <bean class="org.springframework.http.converter.StringHttpMessageConverter"> <property name="supportedMediaTypes" value="text/html;charset=UTF-8"></property> </bean> <!-- 配置fastjson --> <bean class="com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter4"></bean> </mvc:message-converters></mvc:annotation-driven>
JSP
<%-- Created by IntelliJ IDEA. User: southwind Date: 2019-03-14 Time: 15:23 To change this template use File | Settings | File Templates.--%><%@ page contentType="text/html;charset=UTF-8" language="java" %><html><head> <title>Title</title></head><body> <form action="/converter/student" method="post"> 请输入学生信息:<input type="text" name="student"/>(id-name-age)<br/> <input type="submit" value="提交"/> </form></body></html>
Handler
@RequestMapping("/student")public String student(Student student){ return student.toString();}
Spring MVC REST
REST:Representational State Transfer,资源表现层状态转换,是目前比较主流的一种互联网软件架构,它结构清晰、标准规范、易于理解、便于扩展。
- 资源(Resource)
网络上的一个实体,或者说网络中存在的一个具体信息,一段文本、一张图片、一首歌曲、一段视频等等,总之就是一个具体的存在。可以用一个 URI(统一资源定位符)指向它,每个资源都有对应的一个特定的 URI,要获取该资源时,只需要访问对应的 URI 即可。
- 表现层(Representation)
资源具体呈现出来的形式,比如文本可以用 txt 格式表示,也可以用 HTML、XML、JSON等格式来表示。
- 状态转换(State Transfer)
客户端如果希望操作服务器中的某个资源,就需要通过某种方式让服务端发生状态转换,而这种转换是建立在表现层之上的,所有叫做"表现层状态转换"。
特点
- URL 更加简洁。
- 有利于不同系统之间的资源共享,只需要遵守一定的规范,不需要进行其他配置即可实现资源共享。
如何使用
REST 具体操作就是 HTTP 协议中四个表示操作方式的动词分别对应 CRUD 基本操作。
GET 用来表示获取资源。
POST 用来表示新建资源。
PUT 用来表示修改资源。
DELETE 用来表示删除资源。
Handler
package com.southwind.controller;import com.southwind.entity.Student;import com.southwind.entity.User;import com.southwind.repository.StudentRepository;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.stereotype.Repository;import org.springframework.web.bind.annotation.*;import javax.servlet.http.HttpServletResponse;import java.util.Collection;@RestController@RequestMapping("/rest")public class RESTHandeler { @Autowired private StudentRepository studentRepository; @GetMapping("/findAll") public Collection<Student> findAll(HttpServletResponse response){ response.setContentType("text/json;charset=UTF-8"); return studentRepository.findAll(); } @GetMapping("/findById/{id}") public Student findById(@PathVariable("id") long id){ return studentRepository.findById(id); } @PostMapping("/save") public void save(@RequestBody Student student){ studentRepository.saveOrUpdate(student); } @PutMapping("/update") public void update(@RequestBody Student student){ studentRepository.saveOrUpdate(student); } @DeleteMapping("/deleteById/{id}") public void deleteById(@PathVariable("id") long id){ studentRepository.deleteById(id); }}
StudentRepository
package com.southwind.repository;import com.southwind.entity.Student;import java.util.Collection;public interface StudentRepository { public Collection<Student> findAll(); public Student findById(long id); public void saveOrUpdate(Student student); public void deleteById(long id);}
StudentRepositoryImpl
package com.southwind.repository.impl;import com.southwind.entity.Student;import com.southwind.repository.StudentRepository;import org.springframework.stereotype.Repository;import java.util.Collection;import java.util.HashMap;import java.util.Map;@Repositorypublic class StudentRepositoryImpl implements StudentRepository { private static Map<Long,Student> studentMap; static{ studentMap = new HashMap<>(); studentMap.put(1L,new Student(1L,"张三",22)); studentMap.put(2L,new Student(2L,"李四",23)); studentMap.put(3L,new Student(3L,"王五",24)); } @Override public Collection<Student> findAll() { return studentMap.values(); } @Override public Student findById(long id) { return studentMap.get(id); } @Override public void saveOrUpdate(Student student) { studentMap.put(student.getId(),student); } @Override public void deleteById(long id) { studentMap.remove(id); }}
Spring MVC 文件上传下载
单文件上传
底层是使用 Apache fileupload 组件完成上传,Spring MVC 对这种方式进行了封装。
- pom.xml
<dependency> <groupId>commons-io</groupId> <artifactId>commons-io</artifactId> <version>2.5</version></dependency><dependency> <groupId>commons-fileupload</groupId> <artifactId>commons-fileupload</artifactId> <version>1.3.3</version></dependency>
- JSP
<%-- Created by IntelliJ IDEA. User: southwind Date: 2019-03-15 Time: 09:09 To change this template use File | Settings | File Templates.--%><%@ page contentType="text/html;charset=UTF-8" language="java" %><%@ page isELIgnored="false" %><html><head> <title>Title</title></head><body> <form action="/file/upload" method="post" enctype="multipart/form-data"> <input type="file" name="img"/> <input type="submit" value="上传"/> </form> <img src="${path}"></body></html>
1、input 的 type 设置为 file。
2、form 的 method 设置为 post(get 请求只能将文件名传给服务器)
3、from 的 enctype 设置为 multipart-form-data(如果不设置只能将文件名传给服务器)
- Handler
package com.southwind.controller;import org.springframework.stereotype.Controller;import org.springframework.web.bind.annotation.PostMapping;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.multipart.MultipartFile;import javax.servlet.http.HttpServletRequest;import java.io.File;import java.io.IOException;@Controller@RequestMapping("/file")public class FileHandler { @PostMapping("/upload") public String upload(MultipartFile img, HttpServletRequest request){ if(img.getSize()>0){ //获取保存上传文件的file路径 String path = request.getServletContext().getRealPath("file"); //获取上传的文件名 String name = img.getOriginalFilename(); File file = new File(path,name); try { img.transferTo(file); //保存上传之后的文件路径 request.setAttribute("path","/file/"+name); } catch (IOException e) { e.printStackTrace(); } } return "upload"; }}
- springmvc.xml
<!-- 配置上传组件 --><bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"></bean>
- web.xml 添加如下配置,否则客户端无法访问 png
<servlet-mapping> <servlet-name>default</servlet-name> <url-pattern>*.png</url-pattern></servlet-mapping>
多文件上传
pom.xml
<dependency> <groupId>jstl</groupId> <artifactId>jstl</artifactId> <version>1.2</version></dependency><dependency> <groupId>taglibs</groupId> <artifactId>standard</artifactId> <version>1.1.2</version></dependency>
JSP
<%-- Created by IntelliJ IDEA. User: southwind Date: 2019-03-15 Time: 09:32 To change this template use File | Settings | File Templates.--%><%@ page contentType="text/html;charset=UTF-8" language="java" %><%@ page isELIgnored="false" %><%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %><html><head> <title>Title</title></head><body> <form action="/file/uploads" method="post" enctype="multipart/form-data"> file1:<input type="file" name="imgs"/><br/> file2:<input type="file" name="imgs"/><br/> file3:<input type="file" name="imgs"><br/> <input type="submit" value="上传"/> </form> <c:forEach items="${files}" var="file" > <img src="${file}" width="300px"> </c:forEach></body></html>
Handler
@PostMapping("/uploads")public String uploads(MultipartFile[] imgs,HttpServletRequest request){ List<String> files = new ArrayList<>(); for (MultipartFile img:imgs){ if(img.getSize()>0){ //获取保存上传文件的file路径 String path = request.getServletContext().getRealPath("file"); //获取上传的文件名 String name = img.getOriginalFilename(); File file = new File(path,name); try { img.transferTo(file); //保存上传之后的文件路径 files.add("/file/"+name); } catch (IOException e) { e.printStackTrace(); } } } request.setAttribute("files",files); return "uploads";}
下载
- JSP
<%-- Created by IntelliJ IDEA. User: southwind Date: 2019-03-15 Time: 10:36 To change this template use File | Settings | File Templates.--%><%@ page contentType="text/html;charset=UTF-8" language="java" %><html><head> <title>Title</title></head><body> <a href="/file/download/1">1.png</a> <a href="/file/download/2">2.png</a> <a href="/file/download/3">3.png</a></body></html>
- Handler
@GetMapping("/download/{name}")public void download(@PathVariable("name") String name, HttpServletRequest request, HttpServletResponse response){ if(name != null){ name += ".png"; String path = request.getServletContext().getRealPath("file"); File file = new File(path,name); OutputStream outputStream = null; if(file.exists()){ response.setContentType("application/forc-download"); response.setHeader("Content-Disposition","attachment;filename="+name); try { outputStream = response.getOutputStream(); outputStream.write(FileUtils.readFileToByteArray(file)); outputStream.flush(); } catch (IOException e) { e.printStackTrace(); } finally { if(outputStream != null){ try { outputStream.close(); } catch (IOException e) { e.printStackTrace(); } } } } }}
Spring MVC 表单标签库
- Handler
@GetMapping("/get")public ModelAndView get(){ ModelAndView modelAndView = new ModelAndView("tag"); Student student = new Student(1L,"张三",22); modelAndView.addObject("student",student); return modelAndView;}
- JSP
<%-- Created by IntelliJ IDEA. User: southwind Date: 2019-03-15 Time: 10:53 To change this template use File | Settings | File Templates.--%><%@ page contentType="text/html;charset=UTF-8" language="java" %><%@ page isELIgnored="false" %><%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %><html><head> <title>Title</title></head><body> <h1>学生信息</h1> <form:form modelAttribute="student"> 学生ID:<form:input path="id"/><br/> 学生姓名:<form:input path="name"/><br/> 学生年龄:<form:input path="age"/><br/> <input type="submit" value="提交"/> </form:form></body></html>
1、JSP 页面导入 Spring MVC 表单标签库,与导入 JSTL 标签库的语法非常相似,前缀 prefix 可以自定义,通常定义为 from。
<%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %>
2、将 form 表单与模型数据进行绑定,通过 modelAttribute 属性完成绑定,将 modelAttribute 的值设置为模型数据对应的 key 值。
Handeler:modelAndView.addObject("student",student);JSP:<form:form modelAttribute="student">
3、form 表单完成绑定之后,将模型数据的值取出绑定到不同的标签中,通过设置标签的 path 属性完成,将 path 属性的值设置为模型数据对应的属性名即可。
学生ID:<form:input path="id"/><br/>学生姓名:<form:input path="name"/><br/>学生年龄:<form:input path="age"/><br/>
常用的表单标签
- from
<form:from modelAttribute="student"/>
渲染的是 HTML 中的<form></from>
,通过 modelAttribute 属性绑定具体的模型数据。
- input
<form:input path="name"/>
渲染的是 HTML 中的 <input type="text"/>
,from 标签绑定的是模型数据,input 标签绑定的是模型数据中的属性值,通过 path 属性可以与模型数据中的属性名对应,并且支持及联操作。
<from:input path="address.name"/>
- password
<form:password path="password"/>
渲染的是 HTML 中的 <input type="password"/>
,通过 path 属性与模型数据的属性值进行绑定,password 标签的值不会在页面显示。
- checkbox
<form:checkbox path="hobby" value="读书"/>
student.setFlag(false);
checkbox:<form:checkbox path="flag" value="flag"></form:checkbox><br/>
渲染的是 HTML 中的 <input type="checkbox"/>
,通过 path 与模型数据的属性值进行绑定,可以绑定 boolean、数组和集合。
如果绑定 boolean 值,若该变量的值为 true,则表示该复选框选中,否则表示不选中。
如果绑定数组或者集合,数组/集合中的元素等于 checkbox 的 value 值,则选中。
student.setHobby(Arrays.asList("读书","看电影","玩游戏"));modelAndView.addObject("student",student);
爱好:<form:checkbox path="hobby" value="摄影"></form:checkbox>摄影<br/><form:checkbox path="hobby" value="读书"></form:checkbox>读书<br/><form:checkbox path="hobby" value="听音乐"></form:checkbox>听音乐<br/><form:checkbox path="hobby" value="看电影"></form:checkbox>看电影<br/><form:checkbox path="hobby" value="旅游"></form:checkbox>旅游<br/><form:checkbox path="hobby" value="玩游戏"></form:checkbox>玩游戏<br/><input type="submit" value="提交"/>
- checkboxes
<form:checkboxes items=${student.hobby} path="selecHobby"/>
渲染的是 HTML 中的一组 <input type="checkbox"/>
,是对 <form:checkbox/>
的一种简化,需要结合 items 和 path 属性来使用,items 绑定被遍历的集合或数组,path 绑定被选中的集合或数组,可以这样理解,items 为全部可选集合,path 为默认的选中集合。
student.setHobby(Arrays.asList("摄影","读书","听音乐","看电影","旅游","玩游戏"));student.setSelectHobby(Arrays.asList("摄影","读书","听音乐"));modelAndView.addObject("student",student);
爱好:<form:checkboxes path="selectHobby" items="${student.hobby}"/><br/>
需要注意的是 path 可以直接绑定模型数据的属性值,items 则需要通过 EL 表达式的形式从域对象中获取数据,不能直接写属性名。
- rabiobutton
<from:radiobutton path="radioId" value="0"/>
渲染的是 HTML 中的一个 <input type="radio"/>
,绑定的数据与标签的 value 值相等则为选中,否则不选中。
student.setRadioId(1);modelAndView.addObject("student",student);
radiobutton:<form:radiobutton path="radioId" value="1"/>radiobutton<br/>
- radiobuttons
<form:radiobuttons itmes="${student.grade}" path="selectGrade"/>
渲染的是 HTML 中的一组 <input type="radio"/>
,这里需要结合 items 和 path 两个属性来使用,items 绑定被遍历的集合或数组,path 绑定被选中的值,items 为全部的可选类型,path 为默认选中的选项,用法与 <form:checkboxes/>
一致。
Map<Integer,String> gradeMap = new HashMap<>();gradeMap.put(1,"一年级");gradeMap.put(2,"二年级");gradeMap.put(3,"三年级");gradeMap.put(4,"四年级");gradeMap.put(5,"五年级");gradeMap.put(6,"六年级");student.setGradeMap(gradeMap);student.setSelectGrade(3);modelAndView.addObject("student",student);
学生年级:<form:radiobuttons items="${student.gradeMap}" path="selectGrade"/><br/>
- select
<form:select items="${student.citys}" path="selectCity"/>
渲染的是 HTML 中的一个 <select/>
标签,需要结合 items 和 path 两个属性来使用,items 绑定被遍历的集合或数组,path 绑定被选中的值,用法与 <from:radiobuttons/>
一致。
Map<Integer,String> cityMap = new HashMap<>();cityMap.put(1,"北京");cityMap.put(2,"上海");cityMap.put(3,"广州");cityMap.put(4,"深圳");student.setCityMap(cityMap);student.setSelectCity(3);modelAndView.addObject("student",student);
所在城市:<form:select items="${student.cityMap}" path="selectCity"></form:select><br/>
- options
form:select
结合 form:options
的使用,from:select
只定义 path 属性,在 form:select
标签内部添加一个子标签 form:options
,设置 items 属性,获取被遍历的集合。
所在城市:<form:select path="selectCity"> <form:options items="${student.cityMap}"></form:options> </form:select><br/>
-
option
form:select
结合form:option
的使用,from:select
定义 path 属性,给每一个form:option
设置 value 值,path 的值与哪个 value 值相等,该项默认选中。
所在城市:<form:select path="selectCity"> <form:option value="1">杭州</form:option> <form:option value="2">成都</form:option> <form:option value="3">西安</form:option> </form:select><br/>
- textarea
渲染的是 HTML 中的一个 <textarea/>
,path 绑定模型数据的属性值,作为文本输入域的默认值。
student.setIntroduce("你好,我是...");modelAndView.addObject("student",student);
信息:<form:textarea path="introduce"/><br/>
- errors
处理错误信息,一般用在数据校验,该标签需要结合 Spring MVC 的验证器结合起来使用。
Spring MVC 数据校验
Spring MVC 提供了两种数据校验的方式:1、基于 Validator 接口。2、使用 Annotation JSR - 303 标准进行校验。
基于 Validator 接口的方式需要自定义 Validator 验证器,每一条数据的验证规则需要开发者手动完成,使用 Annotation JSR - 303 标准则不需要自定义验证器,通过注解的方式可以直接在实体类中添加每个属性的验证规则,这种方式更加方便,实际开发中推荐使用。
基于 Validator 接口
- 实体类 Account
package com.southwind.entity;import lombok.Data;@Datapublic class Account { private String name; private String password;}
- 自定义验证器 AccountValidator,实现 Validator 接口。
package com.southwind.validator;import com.southwind.entity.Account;import org.springframework.validation.Errors;import org.springframework.validation.ValidationUtils;import org.springframework.validation.Validator;public class AccountValidator implements Validator { @Override public boolean supports(Class<?> aClass) { return Account.class.equals(aClass); } @Override public void validate(Object o, Errors errors) { ValidationUtils.rejectIfEmpty(errors,"name",null,"姓名不能为空"); ValidationUtils.rejectIfEmpty(errors,"password",null,"密码不能为空"); }}
- 控制器
package com.southwind.controller;import com.southwind.entity.Account;import org.springframework.stereotype.Controller;import org.springframework.ui.Model;import org.springframework.validation.BindingResult;import org.springframework.validation.annotation.Validated;import org.springframework.web.bind.annotation.GetMapping;import org.springframework.web.bind.annotation.PostMapping;import org.springframework.web.bind.annotation.RequestMapping;@Controller@RequestMapping("/validator")public class ValidatorHandler { @GetMapping("/login") public String login(Model model){ model.addAttribute("account",new Account()); return "login"; } @PostMapping("/login") public String login(@Validated Account account, BindingResult bindingResult){ if(bindingResult.hasErrors()){ return "login"; } return "index"; }}
- springmvc.xml 配置验证器。
<bean id="accountValidator" class="com.southwind.validator.AccountValidator"></bean><mvc:annotation-driven validator="accountValidator"></mvc:annotation-driven>
- JSP
<%-- Created by IntelliJ IDEA. User: southwind Date: 2019-03-18 Time: 10:31 To change this template use File | Settings | File Templates.--%><%@ page contentType="text/html;charset=UTF-8" language="java" %><%@ page isELIgnored="false" %><%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %><%@ taglib prefix="from" uri="http://www.springframework.org/tags/form" %><html><head> <title>Title</title></head><body> <form:form modelAttribute="account" action="/validator/login" method="post"> 姓名:<form:input path="name"/><from:errors path="name"></from:errors><br/> 密码:<form:input path="password"/><from:errors path="password"></from:errors><br/> <input type="submit" value="登录"/> </form:form></body></html>
Annotation JSR - 303 标准
使用 Annotation JSR - 303 标准进行验证,需要导入支持这种标准的依赖 jar 文件,这里我们使用 Hibernate Validator。
- pom.xml
<!-- JSR-303 --><dependency> <groupId>org.hibernate</groupId> <artifactId>hibernate-validator</artifactId> <version>5.3.6.Final</version></dependency><dependency> <groupId>javax.validation</groupId> <artifactId>validation-api</artifactId> <version>2.0.1.Final</version></dependency><dependency> <groupId>org.jboss.logging</groupId> <artifactId>jboss-logging</artifactId> <version>3.3.2.Final</version></dependency>
- 通过注解的方式直接在实体类中添加相关的验证规则。
package com.southwind.entity;import lombok.Data;import org.hibernate.validator.constraints.Email;import org.hibernate.validator.constraints.NotEmpty;import javax.validation.constraints.Pattern;import javax.validation.constraints.Size;@Datapublic class Person { @NotEmpty(message = "用户名不能为空") private String username; @Size(min = 6,max = 12,message = "密码6-12位") private String password; @Email(regexp = "^[a-zA-Z0-9_.-]+@[a-zA-Z0-9-]+(\\\\.[a-zA-Z0-9-]+)*\\\\.[a-zA-Z0-9]{2,6}$",message = "请输入正确的邮箱格式") private String email; @Pattern(regexp = "^((13[0-9])|(14[5|7])|(15([0-3]|[5-9]))|(18[0,5-9]))\\\\\\\\d{8}$",message = "请输入正确的电话") private String phone;}
- ValidatorHandler
@GetMapping("/register")public String register(Model model){ model.addAttribute("person",new Person()); return "register";}@PostMapping("/register")public String register(@Valid Person person, BindingResult bindingResult){ if(bindingResult.hasErrors()){ return "register"; } return "index";}
- springmvc.xml
<mvc:annotation-driven />
- JSP
<%-- Created by IntelliJ IDEA. User: southwind Date: 2019-03-18 Time: 11:29 To change this template use File | Settings | File Templates.--%><%@ page contentType="text/html;charset=UTF-8" language="java" %><%@ page isELIgnored="false" %><%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %><html><head> <title>Title</title></head><body> <form:form modelAttribute="person" action="/validator/register2" method="post"> 用户名:<form:input path="username"></form:input><form:errors path="username"/><br/> 密码:<form:password path="password"></form:password><form:errors path="password"/><br/> 邮箱:<form:input path="email"></form:input><form:errors path="email"/><br/> 电话:<form:input path="phone"></form:input><form:errors path="phone"/><br/> <input type="submit" value="提交"/> </form:form></body></html>
校验规则详解:
@Null 被注解的元素必须为null
@NotNull 被注解的元素不能为null
@Min(value) 被注解的元素必须是一个数字,其值必须大于等于指定的最小值
@Max(value) 被注解的元素必须是一个数字,其值必须小于于等于指定的最大值
@Email 被注解的元素必须是电子邮箱地址
@Pattern 被注解的元素必须符合对应的正则表达式
@Length 被注解的元素的大小必须在指定的范围内
@NotEmpty 被注解的字符串的值必须非空
Null 和 Empty 是不同的结果,String str = null,str 是 null,String str = “”,str 不是 null,其值为空。