(* 笔记内容均来自 尚硅谷 佟刚老师的视频,例子是在学习中照着敲的)
内容概要
• 1.SpringMVC概述
• 2.SpringMVC的HelloWorld
• 3.使用@RequestMapping映射请求
• 4.映射请求参数&请求头
• 5.处理模型数据
• 6.视图和视图解析器
• 7.RESTful CRUD
• 8.SpringMVC表单标签&处理静态资源
• 9.数据转换&数据格式化&数据校验
• 10.处理JSON:使用HttpMessageConverter
• 11.国际化
• 12.文件的上传
• 13.使用拦截器
• 14.异常处理
• 15.SpringMVC运行流程
• 16.在Spring的环境下使用SpringMVC
• 17.SpringMVC对比Struts2
1.SpringMVC概述
• Spring为展现层提供的基于MVC设计理念的优秀的Web框架,是
目前
最主流
的
MVC
框架
之一
• Spring3.0后全面超越Struts2,成为最优秀的MVC框架
• Spring MVC通过一套MVC注解,让POJO成为处理请求的控制器,而无须实现任何接口。
• 支持REST风格的URL请求
• 采用了松散耦合可插拔组件结构,比其他MVC框架更具扩展性和灵活性
2.HelloWorld
❤ 步
骤
:
–
在
web.xml
中配置
DispatcherServlet
–
编
写
处
理
请
求的
处
理器,并
标识为处
理器
❤ jar包
– commons-logging-1.1.3.jar
– spring-aop-4.0.0.RELEASE.jar
– spring-beans-4.0.0.RELEASE.jar
– spring-context-4.0.0.RELEASE.jar
– spring-core-4.0.0.RELEASE.jar
– spring-expression-4.0.0.RELEASE.jar
– spring-web-4.0.0.RELEASE.jar
– spring-webmvc-4.0.0.RELEASE.jar
❤ 在web.xml中配置DispatcherServlet
DispatcherServlet默认加载/WEB-INF/<servletName-servlet>.xml的Spring
配置文件
,
启动
WEB
层
的
Spring
容器
。可以通
过
contextConfigLocation
初始化参数自定
义
配置文件的
位置
和名称
- <!-- 配置 DispatcherServlet -->
- <servlet>
- <servlet-name>helloworld</servlet-name>
- <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
- <!-- 配置DispatcherServlet初始化参数:配置springmvc配置文件的位置和名称 -->
- <!--
- 实际上也可以不通过 contextConfigLocation 来配置 SpringMVC 的配置文件, 而使用默认的.
- 默认的配置文件为: /WEB-INF/<servlet-name>-servlet.xml
- 这样配置文件就不是放在src下了,而是放在WEB-INF下,此时名字叫做helloworld-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>helloworld</servlet-name>
- <url-pattern>/</url-pattern>
- </servlet-mapping>
❤ 创建Spring MVC配置文件
–配置视图解析器:视图名称解析器:将视图逻辑名解析为: /WEB-INF/pages/<viewName>.jsp
- <!-- 配置自动扫描的包 -->
- <context:component-scan base-package="com.starfish.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>
❤ 创建请求处理器类
- @Controller
- public class HelloWorld {
-
-
-
-
-
-
-
- @RequestMapping("/helloWorld")
- public String helloWorld(){
- System.out.println("springMVC HelloWorld!");
- return "success";
- }
- }
3.使用@RequestMapping映射请求
• Spring MVC 使用@RequestMapping注解为控制器指定可以处理哪些URL 请求
• 在控制器的类定义及方法定义处都可标注@RequestMapping
– 类定义处:提供初步的请求映射信息。相对于WEB 应用的根目录
– 方法处:提供进一步的细分映射信息。相对于类定义处的URL。若类定义处未标注@RequestMapping,则方法处标记的URL 相对于WEB 应用的根目录
• DispatcherServlet截获请求后,就通过控制器上@RequestMapping提供的映射信息确定请求所对应的处理方法。
❤ 使用@RequestMapping映射请求示例
❤ 映射请求参数、请求方法或请求头
• 标准的HTTP请求报头
• @RequestMapping除了可以使用请求URL映射请求外,还可以使用请求方法、请求参数及请求头映射请求
• @RequestMapping的value、method、params及heads 分别表示请求URL、请求方法、请求参数及请求头的映射条件,他们之间是与的关系,联合使用多个条件可让请求映射更加精确化。
• params和headers支持简单的表达式:
– param1: 表示请求必须包含名为param1 的请求参数
– !param1: 表示请求不能包含名为param1 的请求参数
– param1 != value1: 表示请求包含名为param1 的请求参数,但其值不能为value1
– {“param1=value1”, “param2”}: 请求必须包含名为param1 和param2 的两个请求参数,且param1 参数的值必须为value1
- @Controller
- @RequestMapping("springmvc")
- public class SpringMVCTest {
- private static final String SUCCESS = "success";
-
- @RequestMapping(value="testParamsAndHeader",params={"username","age!=24"},headers={"Accept-Language=zh-CN,zh;q=0.8"})
- public String testParamsAndHeader(){
- System.out.println("testParamsAndHeader...");
- return SUCCESS;
- }}
❤ @RequestMapping映射的url还可以使用通配符(需要使用Ant风格)
• 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
- @Controller
- @RequestMapping("springmvc")
- public class SpringMVCTest {
- private static final String SUCCESS = "success";
-
- @RequestMapping("/testAntPath/*/abc")
- public String testAntPath() {
- System.out.println("testAntPath");
- return SUCCESS;
- } }
❤ @PathVariable映射URL 绑定的占位符
• 带占位符的
URL 是Spring3.0
新增的功能,该功能在
SpringMVC
向
REST
目标挺进发展过程中具有里程碑的意义
• 通
过@PathVariable可以将URL 中占位符参数绑定到控
制器处理方法的参数中:
URL
中的
{xxx}
占位符可以通 过
@PathVariable("xxx")
绑定到操作方法的入参中。
(占位符中的名字需要和@PathVariable中的名字一样)
- @Controller
- @RequestMapping("springmvc")
- public class SpringMVCTest {
- private static final String SUCCESS = "success";
- @RequestMapping("testPathVariable/{id}")
- public String testPathVariable(@PathVariable("id") Integer id){
- System.out.println("testPathVariable:" + id);
- return SUCCESS;
- } }
- jsp: <a:href="springmvc/testPathVariable/1">Test PathVariable</a>
❤ 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/1HTTP PUT:更新id = 1的order
–/order HTTP POST:新增order
• HiddenHttpMethodFilter:浏览器form 表单只支持GET 与POST 请求,而DELETE、PUT 等method 并不支持,Spring3.0 添加了一个过滤器,可以将这些请求转换为标准的http 方法,使得支持GET、POST、PUT 与DELETE 请求。
- <!-- 在web.xml中配置 org.springframework.web.filter.HiddenHttpMethodFilter: 可以把 POST 请求转为 DELETE 或 PUT 请求 -->
- <filter>
- <filter-name>HiddenHttpMethodFilter</filter-name>
- <filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
- </filter>
- <filter-mapping>
- <filter-name>HiddenHttpMethodFilter</filter-name>
- <url-pattern>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- @RequestMapping(value = "/testRest/{id}", method = RequestMethod.PUT)
- public String testRestPut(@PathVariable Integer id) {
- System.out.println("testRest Put: " + id);
- return SUCCESS;
- }
-
- @RequestMapping(value = "/testRest/{id}", method = RequestMethod.DELETE)
- public String testRestDelete(@PathVariable Integer id) {
- System.out.println("testRest Delete: " + id);
- return SUCCESS;
- }
-
- @RequestMapping(value = "/testRest", method = RequestMethod.POST)
- public String testRest() {
- System.out.println("testRest POST");
- return SUCCESS;
- }
-
- @RequestMapping(value = "/testRest/{id}", method = RequestMethod.GET)
- public String testRest(@PathVariable Integer id) {
- System.out.println("testRest GET: " + id);
- return SUCCESS;
- } }
- ————————————————jsp————————————————————————————————————
- <form action="springmvc/testRest/1" method="post">
- <input type="hidden" name="_method" value="PUT"/>
- <input type="submit" value="TestRest PUT"/>
- </form>
- <br><br>
-
- <form action="springmvc/testRest/1" method="post">
- <input type="hidden" name="_method" value="DELETE"/>
- <input type="submit" value="TestRest DELETE"/>
- </form>
- <br><br>
-
- <form action="springmvc/testRest" method="post">
- <input type="submit" value="TestRest POST"/>
- </form>
- <br><br>
-
- <a href="springmvc/testRest/1">Test Rest Get</a>
- <br><br>
4. 映射请求参数&请求参数
• SpringMVC
通过分析处理方法的签名,将HTTP请求信息绑定到处理方法的相应人参中
。
• Spring MVC
对控制器处理方法签名的限制是很宽松的,
几乎可以按喜欢的任何方式对方法进行签名。
• 必要时可以对方法及方法入参标注相应的注解(
@PathVariable、@RequestParam、@RequestHeader
等)、
Spring MVC
框架会将
HTTP
请求的信息绑定到相应的方法入参中,并根据方法的返回值类型做出相应的后续处理。
- ————————————————jsp————————————————————————————————————
- <a href="springmvc/testRequestParam?userName=starfish&age=22">Test RequestParam</a>
- ————————————————action——————————————————————————————————
- @Controller
- @RequestMapping("springmvc")
- public class SpringMVCTest {
-
- private static final String SUCCESS = "success";
-
- @RequestMapping("/testRequestParam")
- public String testRequestParam(@RequestParam(value="userName") String userName,
- @RequestParam(value="age",required=false,defaultValue="18") int age){
- System.out.println("testRequestParam--> userName :"+ userName + ", age:"+ age);
- return SUCCESS;
- }
❤ 使用@RequestParam绑定请求参数值(开发中经常用到)
• 在处理方法入参处使用@RequestParam可以把请求参数传递给请求方法
– value:参数名
– required:是否必须。默认为true, 表示请求参数中必须包含对应的参数,若不存在,将抛出异常
- @Controller
- @RequestMapping("springmvc")
- public class SpringMVCTest {
-
- private static final String SUCCESS = "success";
-
- @RequestMapping("/testRequestParam")
- public String testRequestParam(@RequestParam(value="userName") String userName,
- @RequestParam(value="age",required=false,defaultValue="0") int age){
- System.out.println("testRequestParam--> userName :"+ userName + ", age:"+ age);
- return SUCCESS;
- }
- ——————————————————
- jsp:
- <a href="springmvc/testRequestParam?userName=starfish&age=22">Test RequestParam</a>
❤ 使用@RequestHeader绑定请求报头的属性值
• 请求头包含了若干个属性,服务器可据此获知客户端的信
息,通过
@RequestHeader即可将请求头中的属性值绑定到处理方法的入参中
在开发者工具中查看请求头
- @Controller
- @RequestMapping("springmvc")
- public class SpringMVCTest {
-
- private static final String SUCCESS = "success";
-
- @RequestMapping("/testRequestHeader")
- public String testRequestHeader(
- @RequestHeader(value = "Accept-Language") String al) {
- System.out.println("testRequestHeader, Accept-Language: " + al);
- return SUCCESS;
- }
- ——————————————————
- jsp:
- <a href="springmvc/testRequestHeader">Test RequestHeader</a>
❤ 使用@CookieValue绑定请求中的Cookie 值
• @CookieValue可让处理方法入参绑定某个Cookie 值
- @Controller
- @RequestMapping("springmvc")
- public class SpringMVCTest {
-
- private static final String SUCCESS = "success";
-
-
- @RequestMapping("/testCookieValue")
- public String testCookieValue(@CookieValue("JSESSIONID") String sessionId) {
- System.out.println("testCookieValue: sessionId: " + sessionId);
- return SUCCESS;
- }
- ——————————————————
- jsp: <a href="springmvc/testCookieValue">Test CookieValue</a>
❤ 使用POJO 对象绑定请求参数值(一般用的都是对象)
• Spring MVC 会按请求参数名和POJO 属性名进行自动匹配,自动为该对象填充属性值。支持级联属性。如:dept.deptId、dept.address.tel等
- ————————————POJO————————————————
- public class User {
- private String userName;
- private int age;
- private Address address;
- toString()方法和set,get方法省略。。}
- public class Address{
- private String province;
- private String city;
- toString()方法和set,get方法省略。。}
- ————————————action————————————————
- @Controller
- @RequestMapping("springmvc")
- public class SpringMVCTest {
-
- private static final String SUCCESS = "success";
- @RequestMapping("/testPOJO")
- public String testPOJO(User user){
- System.out.println(user);
- return SUCCESS;
- }}
- ——————————jsp——————————————————
- <form action="springmvc/testPOJO">
- username:<input type="text" name="userName"><br><br>
- age:<input type="text" name="age"><br><br>
- province:<input type="text" name="address.province"><br><br>
- city:<input type="text" name="address.city"><br><br>
- <input type="submit" value="Submit">
- </form>
❤
使用ServletAPI作为入参
可以使用Servlet原生的API作为目标方法的参数
MVC 的Handler 方法可以接受哪些ServletAPI类型的参数:
• HttpServletRequest
• HttpServletResponse
• HttpSession
• java.security.Principal•Locale
• InputStream
• OutputStream
• Reader
• Writer
- ————————————action————————————————
- @Controller
- @RequestMapping("/testServletAPI")
- public void testServletAPI(HttpServletRequest request,
- HttpServletResponse response, Writer out) throws IOException {
- System.out.println("testServletAPI, " + request + ", " + response);
- out.write("hello springmvc");
-
- }
- }
- ——————————jsp——————————————————
- <a href="springmvc/testServletAPI">Test ServletAPI</a>
5.处理模型数据
❤ Spring MVC 提供了以下几种途径输出模型数据:
将处理后的模型数据输出为视图
– ModelAndView: 处理方法返回值类型为ModelAndView时, 方法体即可通过该对象添加模型数据
– Map 及Model: 入参为org.springframework.ui.Model、org.springframework.ui.ModelMap或java.uti.Map时,处理方法返回时,Map 中的数据会自动添加到模型中。
– @SessionAttributes: 将模型中的某个属性暂存到HttpSession中,以便多个请求之间可以共享这个属性
– @ModelAttribute: 方法入参标注该注解后, 入参的对象就会放到数据模型中
• 控制器处理方法的返回值如果为ModelAndView, 则其既包含视图信息,也包含模型数据信息。
• 添加模型数据:
– MoelAndView addObject(String attributeName, Object attributeValue)
– ModelAndView addAllObject(Map<String, ?> modelMap)
• 设置视图:
– void setView(View view)
– void setViewName(String viewName)j
- ————————————action————————————————
-
-
-
- 页面中用${requestScope.time }取出来
-
-
- @RequestMapping("/testModelAndView")
- public ModelAndView testModelAndView(){
- String viewName = SUCCESS;
- ModelAndView modelAndView = new ModelAndView(viewName);
-
-
- modelAndView.addObject("time", new Date());
-
- return modelAndView;
- }
- ——————————jsp——————————————————
- <a href="springmvc/testModelAndView">Test ModelAndView</a>
- success page: time: ${requestScope.time }
❤
Map及Model
• Spring MVC 在内部使用了一个org.springframework.ui.Model接口存储模型数据
• 具体步骤:
– Spring MVC 在调用方法前会创建一个隐含的模型对象作为模型数据的存储容器。
– 如果方法的入参为Map 或Model 类型,Spring MVC 会将隐含模型的引用传递给这些入参。在方法体内,开发者可以通过这个入参对象访问到模型中的所有数据,也可以向模型中添加新的属性数据
- ————————————action————————————————
-
-
-
-
-
- @RequestMapping("/testMap")
- public String testMap(Map<String, Object> map){
- System.out.println(map.getClass().getName());
- map.put("names", Arrays.asList("Tom", "Jerry", "Mike"));
- return SUCCESS;
- }
- ——————————jsp——————————————————
- <a href="springmvc/testMap">Test testMap
- </a> success page:
- names: ${requestScope.name }
前边几种方法都是把模型数据放到域对象中,也可以放在session中
•
若希望在多个请求之间共用某个模型属性数据,则可以在控制器
类上标注一个
@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})
- ————————————action————————————————
- @Controller
- @RequestMapping("springmvc")
- @SessionAttributes(value={"user"},types={String.class})
- public class SpringMVCTest {
-
-
-
-
-
- @RequestMapping("/testSessionAttributes")
- public String testSessionAttributes(Map<String,Object> map){
- User user = new User("starfish", 24);
- map.put("school", "naoyao");
- map.put("user", user);
- return SUCCESS;
- } }
- ——————————jsp——————————————————
- <a href="springmvc/testSessionAttributes">Test SessionAttributes</a>
-
- success page:
- request user: ${requestScope.user }
- <br><br>
- session user: ${sessionScope.user }
- <br><br>
- request school: ${requestScope.school }
- <br><br>
- session school: ${sessionScope.school }
1)应用场景:
当我们需要修改一个user的信息时,我们希望只修改部分属性值,其他属性值保留。
这个时候我们就需要用@ModelAttribute定义一个方法,这个方法在目标方法执行之前执行。
先到数据库查询到需要修改的user,转到目标方法,将表单的数据赋值到这个user中,最后将user作为目标方法的入参传给目标方法处理。
由于我们先从数据库中查询到了user,并将表单中的数据(这些数据只是user实体中的部分属性)赋值给该user,这样我们就达到了我们的需求。
即:当我们需要修改一个user的信息时,我们希望只修改部分属性值,其他属性值保留。
如:有一条属性是插入创建时间,它是不能被修改的
在方法定义上使用@ModelAttribute注解:
• Spring MVC 在调用目标处理方法前,会先逐个调用在方法级上标注了@ModelAttribute的方法。
在方法的入参前使用@ModelAttribute注解:
– 可以从隐含对象中获取隐含的模型数据中获取对象,再将请求参数绑定到对象中,再传入入参
– 将方法入参对象添加到模型中
- ————————————action————————————————
- @Controller
- @RequestMapping("springmvc")
- public class SpringMVCTest {
-
-
-
-
-
-
- @ModelAttribute
- public void getUser(@RequestParam(value="id",required=false) Integer id,
- Map<String, Object> map){
- System.out.println("modelAttribute method");
- if(id != null){
-
- User user = new User(1, "Tom", "123456", "tom@atguigu.com", 12);
- System.out.println("从数据库中获取一个对象: " + user);
- map.put("user", user);
- } }
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- @RequestMapping("/testModelAttribute")
- public String testModelAttribute(User user){
- System.out.println("修改: " + user);
- return SUCCESS;
- }}
- ——————————————jsp————————————————————
- <!--
- 模拟修改操作
- 1. 原始数据为: 1, Tom, 123456,tom@atguigu.com,12
- 2. 密码不能被修改.
- 3. 表单回显, 模拟操作直接在表单填写对应的属性值
- -->
- <form action="springmvc/testModelAttribute" method="Post">
- <input type="hidden" name="id" value="1"/>
- username: <input type="text" name="username" value="Tom"/>
- <br>
- email: <input type="text" name="email" value="tom@atguigu.com"/>
- <br>
- age: <input type="text" name="age" value="12"/>
- <br>
- <input type="submit" value="Submit"/>
- </form>
- <br><br>
❤
由@SessionAttributes引发的异常
• 如果在处理类定义处标注了@SessionAttributes(“xxx”),则尝试从会话中获取该属性,并将其赋给该入参,然后再用请求消息填充该入参对象。如果在会话中找不到对应的属性,则抛出HttpSessionRequiredExcep
tion异常
如何避免@SessionAttributes引发的异常
(必须加上如下带有@ModelAttribute的方法)