1、SpringMVC简介
Spring为展现层提供的基于MVC设计理念的优秀的Web框架,是目前最主流的MVC框架之一。
Spring3.0后全面超越Struts2,成为最优秀的MVC框架。
SpringMVC通过一套MVC注解,让POJO成为处理请求的控制器,而无须实现任何接口。
支持REST风格的URL请求。
采用了松散耦合可插拔组件结构,比其他MVC框架更具扩展性和灵活性。
2、SpringMVC的HelloWorld
(1)在Eclipse中,创建一个Web工程,项目名称为springmvc_01,并加入jar包
(2)在web.xml文件中配置DispatcherServlet,并通过contextConfigLocation参数指定SpringMVC配置文件的位置。
web.xml:
<?xml version="1.0" encoding="UTF-8"?>
<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_2_5.xsd"
id="WebApp_ID" version="2.5">
<!-- 配置 DispatcherServlet -->
<servlet>
<servlet-name>dispatcherServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!-- 配置 DispatcherServlet 的一个初始化参数: 配置 SpringMVC 配置文件的位置和名称 -->
<!--
实际上也可以不通过 contextConfigLocation 来配置 SpringMVC 的配置文件, 而使用默认的.
默认的配置文件为: /WEB-INF/<servlet-name>-servlet.xml
-->
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:springmvc.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>dispatcherServlet</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
(3)在指定文职创建SpringMVC的配置文件,名称为springmvc.xml。在springmvc.xml中配置注解和视图解析器。
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"
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-4.0.xsd">
<!-- 配置自定扫描的包 -->
<context:component-scan base-package="com.sjk.springmvc"></context:component-scan>
<!-- 配置视图解析器: 如何把 handler 方法返回值解析为实际的物理视图 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/views/"></property>
<property name="suffix" value=".jsp"></property>
</bean>
</beans>
(4)创建请求处理类HelloWorld.java
HelloWorld.java:
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class HelloWorld {
/**
* 1. 使用 @RequestMapping 注解来映射请求的 URL
* 2. 返回值会通过视图解析器解析为实际的物理视图, 对于 InternalResourceViewResolver 视图解析器, 会做如下的解析:
* 通过 prefix + returnVal + 后缀 这样的方式得到实际的物理视图, 然会做转发操作
*
* /WEB-INF/views/success.jsp
*
* @return
*/
@RequestMapping("/helloworld")
public String hello(){
System.out.println("hello world");
return "success";
}
}
(5)创建测试页面index.jsp
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
<a href="helloworld">Hello World</a>
</body>
</html>
(6)创建index.jsp中点击超链接后转移到的页面WEB-INF/views/success.jsp
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
<h4>Success</h4>
</body>
</html>
注:点击index.jsp中的超链接之后的执行过程:
点击index.jsp中的超链接“Hello World”→web.xml中配置的DispatcherServlet会拦截该请求→在springmvc.xml中寻找处理请求的处理器(即使用@Controller注解标识的类)的对应方法(即使用@RequestMapping标识的方法)→处理完请求之后,方法返回值与web.xml中配置的视图解析器的前缀和后缀组成转移URL地址WEB-INF/views/success.jsp→转移至success.jsp页面。
3、SpringMVC的配置细节
3.1@RequestMapping注解
SpringMVC使用@RequestMapping 注解为控制器指定可以处理哪些URL请求,在控制器的类定义及方法定义处都可标注: – 类定义处:提供初步的请求映射信息。相对于 WEB 应用的根目录; – 方法处:提供进一步的细分映射信息。相对于类定义处的 URL。若类定义处未标注 @RequestMapping,则方法处标记的URL相对于WEB应用的根目录。 DispatcherServlet 截获请求后,就通过控制器上@RequestMapping提供的映射信息确定请求所对应的处理方法。
映射请求参数、请求方法或请求头:
@RequestMapping 除了可以使用请求 URL 映射请求外,还可以使用请求方法、请求参数及请求头映射请求。 @RequestMapping 的 value、method、params 及 headers分别表示请求URL、请求方法、请求参数及请求头的映射条件,他们之间是与的关系,联合使用多个条件可让请求映射更加精确化。
注: params 和 headers支持简单的表达式: – param1: 表示请求必须包含名为 param1 的请求参数 – !param1: 表示请求不能包含名为 param1 的请求参数 – param1 != value1: 表示请求包含名为 param1 的请求参数,但其值 不能为 value1 – {“param1=value1”, “param2”}: 请求必须包含名为 param1 和param2 的两个请求参数,且 param1 参数的值必须为 value1
(1)映射请求方法:
(2)映射请求参数和请求头
Ant风格的URL
Ant 风格资源地址支持 3 种匹配符: – ?:匹配文件名中的一个字符 – *:匹配文件名中的任意字符 – **:** 匹配多层路径 @RequestMapping 还支持 Ant 风格的 URL: – /user/*/createUser: 匹配 /user/aaa/createUser、/user/bbb/createUser 等 URL – /user/**/createUser: 匹配 /user/createUser、/user/aaa/bbb/createUser 等 URL – /user/createUser??: 匹配 /user/createUseraa、/user/createUserbb 等 URL
3.2@PathVariable注解
通过 @PathVariable 可以将 URL 中占位符参数绑定到控制器处理方法的入参中:URL 中的 {xxx} 占位符可以通过@PathVariable("xxx") 绑定到操作方法的入参中。
3.3 REST
REST:即 Representational State Transfer。(资源)表现层状态转化。是目前最流行的一种互联网软件架构。它结构清晰、符合标准、易于理解、扩展方便,所以正得到越来越多网站的采用 资源(Resources):网络上的一个实体,或者说是网络上的一个具体信息。它可以是一段文本、一张图片、一首歌曲、一种服务,总之就是一个具体的存在。可以用一个URI(统一资源定位符)指向它,每种资源对应一个特定的 URI 。要获取这个资源,访问它的URI就可以,因此 URI 即为每一个资源的独一无二的识别符。 表现层(Representation):把资源具体呈现出来的形式,叫做它的表现层(Representation)。比如,文本可以用 txt 格式表现,也可以用 HTML 格式、XML 格式、JSON 格式表现,甚至可以采用二进制格式。 状态转化(State Transfer):每发出一个请求,就代表了客户端和服务器的一次交互过程。HTTP协议,是一个无状态协议,即所有的状态都保存在服务器端。因此,如果客户端想要操作服务器,必须通过某种手段,让服务器端发生“状态转化”(State Transfer)。而这种转化是建立在表现层之上的,所以就是 “表现层状态转化”。具体说,就是 HTTP 协议里面,四个表示操作方式的动词:GET、POST、PUT、DELETE。它们分别对应四种基本操作:GET 用来获取资源,POST 用来新建资源,PUT 用来更新资源,DELETE 用来删除资源。 示例: – /order/1 HTTP GET :得到 id = 1 的 order – /order/1 HTTP DELETE:删除 id = 1的 order – /order/1 HTTP PUT:更新id = 1的 order – /order HTTP POST:新增 order HiddenHttpMethodFilter:浏览器 form 表单只支持 GET与 POST 请求,而DELETE、PUT 等 method 并不支 持,Spring3.0 添加了一个过滤器,可以将这些请求转换为标准的http方法,使得支持 GET、POST、PUT 与 DELETE 请求。 发送PUT和DELETE请求的方法:1. 需要配置 HiddenHttpMethodFilter 2. 需要发送 POST 请求 3. 需要在发送 POST 请求时携带一个 name="_method" 的隐藏域, 值为 DELETE 或 PUT
3.3 @RequestParam和@RequestHeader
(1)在处理方法入参处使用 @RequestParam 可以把请求参数传递给请求方法 – value:参数名 – required:是否必须。默认为 true, 表示请求参数中必须包含对应的参数,若不存在,将抛出异常 –default:参数的默认值 (2)通过 @RequestHeader 即可将请求头中的属性值绑定到处理方法的入参中。用法同@RequestParam。
3.3 @CookieValue
@CookieValue 可让处理方法入参绑定某个 Cookie 值。用法同 @RequestParam。
3.4使用 POJO 对象绑定请求参数值
Spring MVC 会按请求参数名和POJO属性名进行自动匹配,自动为该对象填充属性值。支持级联属性。 如:dept.deptId、dept.address.tel 等
3.5 使用 Servlet API 作为入参
可以使用 Serlvet 原生的 API 作为目标方法的参数 具体支持以下类型: •HttpServletRequest • HttpServletResponse • HttpSession • java.security.Principal • Locale • InputStream • OutputStream • Reader • Writer
3.6 处理模型数据
Spring MVC 提供了以下几种途径输出模型数据: – ModelAndView: 处理方法返回值类型为 ModelAndView时, 方法体即可通过该对象添加模型数据。 – Map 及 Model: 入参为org.springframework.ui.Model、org.springframework.ui。 ModelMap 或 java.uti.Map 时,处理方法返回时,Map中的数据会自动添加到模型中。 – @SessionAttributes: 将模型中的某个属性暂存到HttpSession 中,以便多个请求之间可以共享这个属性。 – @ModelAttribute: 方法入参标注该注解后, 入参的对象就会放到数据模型中。
(1)ModelAndView
控制器处理方法的返回值如果为 ModelAndView, 则其既 包含视图信息,也包含模型数据信息。 • 添加模型数据: – MoelAndView addObject(String attributeName, Object attributeValue) – ModelAndView addAllObject(Map<String, ?> modelMap) • 设置视图: – void setView(View view) – void setViewName(String viewName)j
(2)Map 及 Model
Spring MVC 在内部使用了一个org.springframework.ui.Model 接口存储模型数据。 具体步骤: – Spring MVC 在调用方法前会创建一个隐含的模型对象作为模型数据的存储容器。 – 如果方法的入参为 Map 或 Model 类型,Spring MVC 会将隐含模型的引用传递给这些入参。在方法体内,开发者可以通过这个入参对象访问到模型中的所有数据,也可以向模型中添加新的属性数据。
(3)@SessionAttributes
•若希望在多个请求之间共用某个模型属性数据,则可以在控制器类上标注一个 @SessionAttributes, Spring MVC将在模型中对应的属性暂存到 HttpSession 中。 • @SessionAttributes 除了可以通过属性名指定需要放到会话中的属性外,还可以通过模型属性的对象类型指定哪些模型属性需要放到会话中 – @SessionAttributes(types=User.class) 会将隐含模型中所有类型为 User.class 的属性添加到会话中。 – @SessionAttributes(value={“user1”, “user2”}) – @SessionAttributes(types={User.class, Dept.class}) – @SessionAttributes(value={“user1”, “user2”},types={Dept.class})
(4)@ModelAttribute
• 在方法定义上使用 @ModelAttribute 注解:Spring MVC在调用目标处理方法前,会先逐个调用在方法级上标注了@ModelAttribute 的方法。 • 在方法的入参前使用 @ModelAttribute 注解: – 可以从隐含对象中获取隐含的模型数据中获取对象,再将请求参数绑定到对象中,再传入入参 – 将方法入参对象添加到模型中
3.7 视图解析器
Spring MVC如何解析视图?
视图和视图解析器: • 请求处理方法执行完成后,最终返回一个 ModelAndView对象。对于那些返回 String,View 或 ModeMap 等类型的处理方法,Spring MVC 也会在内部将它们装配成一个ModelAndView 对象,它包含了逻辑名和模型对象的视图; • Spring MVC 借助视图解析器(ViewResolver)得到最终的视图对象(View),最终的视图可以是 JSP ,也可能是Excel、JFreeChart 等各种表现形式的视图; • 对于最终究竟采取何种视图对象对模型数据进行渲染,处理器并不关心,处理器工作重点聚焦在生产模型数据的工作上,从而实现 MVC 的充分解耦。 视图: • 视图的作用是渲染模型数据,将模型里的数据以某种形式呈现给客户。 • 为了实现视图模型和具体实现技术的解耦,Spring 在org.springframework.web.servlet 包中定义了一个高度抽象的 View接口。 • 视图对象由视图解析器负责实例化。由于视图是无状态的,所以他们不会有线程安全的问题。 视图解析器: • SpringMVC 为逻辑视图名的解析提供了不同的策略,可以在 Spring WEB 上下文中配置一种或多种解析策略,并指定他们之间的先后顺序。每一种映射策略对应一个具体的视图解析器实现类。 • 视图解析器的作用比较单一:将逻辑视图解析为一个具体的视图对象。 • 所有的视图解析器都必须实现 ViewResolver 接口。
注:
• 程序员可以选择一种视图解析器或混用多种视图解析器
• 每个视图解析器都实现了 Ordered 接口并开放出一个 order 属性,可以通过 order 属性指定解析器的优先顺序,order 越小优先级越高。
• SpringMVC 会按视图解析器顺序的优先顺序对逻辑视图名进行解析,直到解析成功并返回视图对象,否则将抛出 ServletException 异常。
注:
• 若项目中使用了 JSTL,则 SpringMVC 会自动把视图由InternalResourceView 转为 JstlView
• 若使用 JSTL 的 fmt 标签则需要在 SpringMVC 的配置文件中配置国际化资源文件:
<!-- 配置国际化资源文件 -->
<bean id="messageSource"
class="org.springframework.context.support.ResourceBundleMessageSource">
<property name="basename" value="i18n"></property>
</bean>
• 若希望直接响应通过 SpringMVC 渲染的页面,可以使用 mvc:viewcontroller 标签实现:
<!-- 配置直接转发的页面 -->
<!-- 可以直接相应转发的页面,而无需再经过Handler的方法 -->
<mvc:view-controller path="/success" view-name="sucess"/>
<!-- 在实际开发中通常都需配置MVC:annotation-driven标签 -->
<mvc:annotation-driven></mvc:annotation-driven>
3.8 重定向
• 一般情况下,控制器方法返回字符串类型的值会被当成逻辑视图名处理; • 如果返回的字符串中带 forward: 或 redirect: 前缀时,SpringMVC 会对他们进行特殊处理:将 forward: 和 redirect: 当成指示符,其后的字符串作为 URL 来处理。 – redirect:success.jsp:会完成一个到 success.jsp 的重定向的操作 – forward:success.jsp:会完成一个到 success.jsp 的转发操作
本博客内容来自尚硅谷佟刚老师的课程—《SpringMVC》
本博客中的源码