前言
声明:本专栏文章为观看动力节点王鹤老师三大框架的视频所撰写的笔记,笔者实力有限,内容如有错误欢迎各位小伙伴在评论区指出。
视频链接:SSM-SpringMVC
1、@RequestMapping定义请求规则
1.1指定模块名称
指定模块名称是指当我们在一个控制器类下的方法指定@RequestMapping的请求具有公共前缀时,我们就可以把不同请求的共同前缀放到类的@RequestMapping上面进行指定,也就是模块名称。如下:
像这样的情况,就可以利用类上的@RequestMapping将共同前缀转移,简化代码。
1.2定义请求提交方式
定义请求提交方式也就是设置@RequestMapping的method属性的值,RequestMethod的枚举常量指定提交方式,常用的就是RequestMethod.GET和RequestMethod.POST。如下:
控制器
首页页面
执行结果
总结,客户端浏览器常用的请求方式如下:
序号 | 请求方式 | 提交方式 |
1 | 地址栏请求 | GET请求 |
2 | 超链接请求 | GET请求 |
3 | src资源路径请求 | GET请求 |
4 | form表单请求 | 默认GET请求,可以指定POST请求 |
5 | AJAX请求 | 默认GET请求,可以指定POST请求 |
2、处理器请求参数
处理器方法内可以包含以下四个参数,选用哪个参数以及选用几个参数可以自行定义。
- HttpServletRequest
- HttpServletResponse
- HttpSession
- 请求中携带的参数
2.1逐个接收请求参数
控制器处理请求方法的形参和首页传递的参数名称必须一样,控制器接收如下:
1)最好使用包装类型,例如Integer能接收空值情况,为null。
2)框架的String能实现到int、long、double等的类型转换。
/**
* 控制器
* */
@Controller
public class SomeController {
/**
* 请求处理方法,逐个接收参数
* 要求:请求提交的参数名称要和控制器方法中形参名称一样
*
* 参数接收:
* 1.框架使用request对象,接收参数
* String name = request.getParameter("name");
* String age = request.getParameter("age");
* 2.在中央调度器的内部调用doProperParam方法时,按照名称传递参数
* doProperParam(name, Integer.valueOf(age))
* */
@RequestMapping(value = "ProperParam.do")
public ModelAndView doProperParam(String name,Integer age){
ModelAndView mv = new ModelAndView();
mv.addObject("name",name);
mv.addObject("age",age);
mv.setViewName("show");
return mv;
}
}
首页index.jsp改造如下:
<%--
Created by IntelliJ IDEA.
User: 尼根的猜想
Date: 2022/1/13
Time: 16:25
To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>首页</title>
</head>
<body>
<p1>逐个接收参数</p1>
<br/>
<form action="ProperParam.do" method="post">
姓名:<input type="text" name="name"/><br/>
年龄:<input type="text" name="age"/><br/>
<input type="submit" value="发送一个POST请求">
</form>
</body>
</html>
浏览器访问结果:
2.2请求参数中文乱码问题解决
上述姓名参数如果输入中文,会出现下面的乱码问题。
Spring框架针对这样的中文乱码问题,给出了专门的字符集过滤器,在web.xml配置文件中配置即可,如下:
<!--注册过滤器-->
<filter>
<filter-name>characterEncodingFilter</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>
<!--强制Request使用字符集-->
<init-param>
<param-name>forceRequestEncoding</param-name>
<param-value>true</param-value>
</init-param>
<!--强制Response使用字符集-->
<init-param>
<param-name>forceResponseEncoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>characterEncodingFilter</filter-name>
<url-pattern>*.do</url-pattern>
</filter-mapping>
</web-app>
访问效果:
2.3校正请求参数名@RequestParam
由上面的表述可知,如果请求中的参数名和控制器方法中形参名不一致,那么方法中参数就无法接收到。但是,实际过程中一定要求不一样或者由于代码量过大出现失误,如何避免这种情况呢?解决的办法就是使用注解@RequestParam
首页index.jsp
<p1>逐个接收参数</p1>
<br/>
<form action="ReceiveParam.do" method="post">
姓名:<input type="text" name="myname"/><br/>
年龄:<input type="text" name="myage"/><br/>
<input type="submit" value="发送一个POST请求">
</form>
控制器请求处理方法,在形参的的前面添加@RequestParam注解解决参数不一致的问题;
1)@RequestParam value属性添加请求名称
@RequestMapping(value = "ReceiveParam.do")
public ModelAndView doReceiveParam(@RequestParam(value = "myname")String name,
@RequestParam(value = "myage") Integer age){
ModelAndView mv = new ModelAndView();
mv.addObject("name",name);
mv.addObject("age",age);
mv.setViewName("show");
return mv;
}
访问:
如果我们请求表单可以提交,但是没有参数,例如下面这样:
<p1>逐个接收参数</p1>
<br/>
<form action="ReceiveParam.do" method="post">
<input type="submit" value="发送一个POST请求">
</form>
该表单下提交的请求将会出现错误,如下:
2)@RequestParam required 属性可以解决上述问题;
required属性默认是true,自动检测参数有无,否则404报错,可以手动设置为false,屏蔽检测。
@RequestMapping(value = "ReceiveParam.do")
public ModelAndView doReceiveParam(@RequestParam(value = "myname",required = false)String name,
@RequestParam(value = "myage",required = false) Integer age){
ModelAndView mv = new ModelAndView();
mv.addObject("name",name);
mv.addObject("age",age);
mv.setViewName("show");
return mv;
}
这样设置后,访问正常但参数值为空:
2.4对象参数接收
将控制器方法的参数定义为一个对象,只要保证参数名与这个对象的属性名相同即可。
第一步:定义类Student
public class Student {
private String name;
private Integer age;
public Student(String name, Integer age) {
this.name = name;
this.age = age;
}
public String getName() {
return name;
}
public Integer getAge() {
return age;
}
public void setName(String name) {
this.name = name;
}
public void setAge(Integer age) {
this.age = age;
}
}
第二部:修改控制器类
框架首先会自动根据参数的对象名称创建对象,然后找到对应的属性名调用set方法对其赋值。
1、name--->student.setName()
2、age--->student.setAge()
@RequestMapping(value = "ProperParam.do")
public ModelAndView doProperParam(Student student){
ModelAndView mv = new ModelAndView();
mv.addObject("name",student.getName());
mv.addObject("age",student.getAge());
mv.setViewName("show");
return mv;
}
3、处理器返回值
使用@Controller注解的控制器方法的返回值有以下四类:
1)ModelAndView
2)String
3)无返回值型void
4)自定义类型对象
2.3.1 ModelAndView返回值
若控制器方法处理完后,需要跳转到其它资源,且又要在跳转的资源间传递数据,此时控制器方法返回ModelAndView比较好。当然,若返回ModelAndView,控制器方法中需要定义ModelAndView对象。 在使用时,若该控制器方法只是进行跳转而不传递数据,或只是传递数据而并不向任何资源跳转(如对页面的Ajax异步响应),此时若返回ModelAndView,则将总是有一部分多余:要么Model多余,要么View多余。即此时返回ModelAndView将不合适。
2.3.2 String返回值
控制器方法返回的字符串可以指定逻辑视图名,通过视图解析器解析可以将其转换为物理视图地址。
若要跳转的资源为内部资源,则视图解析器可以使用InternalResourceViewResolver内部资源视图解析器。此时处理器方法返回的字符串就是要跳转页面的文件名去掉文件扩展名后的部分。这个字符串与视图解析器中的prefix、suffix相结合,即可形成要访问的URI。
<!--试图解析器--> <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <!--视图页面前缀--> <property name="prefix" value="/WEB-INF/view/"/> <!--视图页面扩展名--> <property name="suffix" value=".jsp"/> </bean>
控制器类处理方法修改
@RequestMapping(value = "ProperParam.do")
public String doProperParam(HttpServletRequest request,Student student){
request.setAttribute("student","student");
return "show";
}
2.3.3 无参数返回
对于处理器方法返回void的应用场景,AJAX响应.。
若处理器对请求处理后,无需跳转到其它任何资源,此时可以让处理器方法返回void。例如,对于AJAX的异步请求的响应。
Step1:maven加入jackson依赖 由于本项目中服务端向浏览器传回的是JSON数据,需要使用一个工具类将字符串包装为JSON格式,所以需要导入JSON的依赖。
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-core</artifactId>
<version>2.9.0</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.9.0</version>
</dependency>
Step2:引入jQuery库 由于本项目要使用jQuery的ajax()方法提交AJAX请求,所以项目中需要引入jQuery的库。在WebRoot下新建一个Folder(文件夹),命名为js,并将jquery-1.11.1.js文件放入其中。在需要使用ajax请求的页面引入该库。
<script type="text/javascript" src="js/jquery-1.11.1-min.js"></script>
Step3:定义index页面 index页面由两部分内容构成:
一个是<button/>,用于提交AJAX请求;
一个是<script/>,用于处理AJAX请求。
Step4: 定义对象Student
Step5:修改处理器类MyController 处理器对于AJAX请求中所提交的参数,可以使用逐个接收的方式,也可以以对象的方式整体接收。只要保证AJAX请求参数与接收的对象类型属性同名。 以逐个接收参数方式进行:
Step6:删除视图页面,由于是服务端直接向浏览器发回数据,所以也就无需视图页面了,所以需 要删除WEB-INF中的view目录及其中的show页面。
2.3.4 自定义对象类型返回
处理器方法也可以返回Object对象。这个Object可以是Integer,String,自定义对象,Map,List等。但返回的对象不是作为逻辑视图出现的,而是作为直接在页面显示的数据出现的。 返回对象,需要使用@ResponseBody注解,将转换后的JSON数据放入到响应体中。
(1)环境搭建
1)由于返回Object数据,一般都是将数据转化为了JSON对象后传递给浏览器页面的。而这个由Object转换为JSON,是由Jackson工具完成的。所以需要导入Jackson的相关Jar包。
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-core</artifactId>
<version>2.9.0</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.9.0</version>
</dependency>
2)声明注解驱动
将Object数据转化为JSON数据,需要由消息转换器HttpMessageConverter完成。而转换器的开启,需要由<mvc:annotation-driven/>来完成。 SpringMVC使用消息转换器实现请求数据和对象,处理器方法返回对象和响应输出之间的自动转换。
Spring容器进行初始化过程中,在<mvc:annotation-driven/>处创建注解驱动时,默认创建了七个HttpMessageConverter对象。也就是说,我们注册<mvc:annotation-driven/>,就是为了让容器为我们创建HttpMessageConverter对象。
HttpMessageConverter<T>接口定义的方法:
1) boolean canRead(Class<?> clazz,MediaType mediaType): 指定转换器可以读取的对象类型,即转换器是否可将请求信息转换为clazz 类型的对象,同时指定支持MIME 类型(text/html,applaiction/json等)
2) boolean canWrite(Class<?> clazz,MediaType mediaType):指定转换器是否可将clazz 类型的对象写到响应流中,响应流支持的媒体类型在MediaType 中定义。
3)LIst<MediaType> getSupportMediaTypes():该转换器支持的媒体类 型。
4)T read(Class<? extends T> clazz,HttpInputMessage inputMessage):将请求信息流转换为T 类型的对象。
5) void write(T t,MediaType contnetType,HttpOutputMessgae outputMessage):将T类型的对象写到响应流中,同时指定相应的媒体类型为contentType
HttpMessageConverter的几种实现类以及它们的作用:
HttpMessageConverter实现类 | 作用 |
ByteArrayHttpMessageConverter | 负责读取二进制格式的数据和写出二进制格式的数据 |
StringHttpMessageConverter | 负责读取字符串格式的数据和写出字符串格式的数据 |
ResourceHttpMessageConverter | 负责读取资源文件和写出资源文件数据 |
SourceHttpMessageConverter | 能够读/写来自HTTP的请求与响应的javax.xml.transform.Source ,支持DOMSource, SAXSource, 和 StreamSource 的XML格式 |
AllEncompassingFormHttpMessageConverter | 负责处理表单(form)数据 |
Jaxb2RootElementHttpMessageConverter | 使用 JAXB负责读取和写入xml 标签格式的数据 |
MappingJackson2HttpMessageConverter | 负责读取和写入json格式的数据。利用Jackson的ObjectMapper读写json数据,操作Object类型数据,可读取application/json,响应媒体类型为application/json |
(2)返回自定义类型对象
step1:定义数据类
step2:修改控制器Controller
step3:修改index.jsp
(3) 返回List集合
step1:修改控制器
step2:修改index.jsp
(4) 返回字符串对象
若要返回非中文字符串,将前面返回数值型数据的返回值直接修改为字符串即可。但若返回的字符串中带有中文字符,则接收方页面将会出现乱码。此时需要使用@RequestMapping的produces属性指定字符集。
修改控制器:
修改index.jsp:
4、<url-pattern/>解读
2.4.1 配置详解
(1) *.do
在没有特殊要求的情况下,SpringMVC的中央调度器DispatcherServlet的<url-pattern/>常使用后辍匹配方式,如写为*.do 或者 *.action, *.mvc等。
(2) /
可以写为/,因为DispatcherServlet会将向静态资源的获取请求,例如.css、.js、.jpg、.png等资源的获取请求,当作是一个普通的Controller请求。中央调度器会调用处理器映射器为其查找相应的处理器。当然也是找不到的,所以在这种情况下,所有的静态资源获取请求也均会报404错误。
(3)现在有这样一个需求
需求:在index.jsp页面中存在一个访问图片的链接。
结果:保持<url-pattern/>的值为 *.do,扩展名方式,图片会正常显示。
将<url-pattern/>的值修改为 / ,则图片将无法显示。
2.4.2 静态资源访问
<url-pattern/>的值并不是说写为/后,静态资源就无法访问了。经过一些配置后,该问题也是可以解决的。
(1) 使用<mvc:default-servlet-handler/>
声明了<mvc:default-servlet-handler />后,springmvc框架会在容器中创建DefaultServletHttpRequestHandler处理器对象。它会像一个检查员,对进入DispatcherServlet的URL进行筛查,如果发现是静态资源的请求,就将该请求转由Web应用服务器默认的Servlet处理。一般的服务器都有默认的Servlet。 在Tomcat中,有一个专门用于处理静态资源访问的Servlet 名叫DefaultServlet。其<servlet-name/>为default。可以处理各种静态资源访问请求。该Servlet注册在Tomcat服务器的web.xml中。
使用:
1)在springmvc.xml中添加<mvc:default-servlet-handler/>标签即可。
<mvc:default-servlet-handler>
2)引入mvc约束
<mvc:default-servlet-handler/>表示使用DefaultServletHttpRequestHandler处理器对象。而该处理器调用了Tomcat的DefaultServlet来处理静态资源的访问请求,所以需要引入mvc约束。
(2) 使用<mvc:resources/>(掌握)
在Spring3.0版本后,Spring定义了专门用于处理静态资源访问请求的处理器ResourceHttpRequestHandler。并且添加了<mvc:resources/>标签,专门用于解决静态资源无法访问问题。需要在springmvc配置文件中添加如下形式的配置:
location 表示静态资源所在目录。当然,目录不要使用/WEB-INF/及其子目录。
mapping表示对该资源的请求(以 /images/开始的请求,如 /image/beauty.jpg , /images/car.png 等)。注意,后面是两个星号**。
(3) 声明注解驱动
解决动态资源和静态资源冲突的问题,在springmvc配置文件加入: