一、什么是Spring MVC
1.Spring介绍
- Spring MVC 是Spring 体系的轻量级Web MVC 框架
- Spring MVC 的核心 Controller 控制器,用于处理请求,产生响应
- Spring MVC 基于Spring IOC容器运行,所有对象被IOC管理
2.Spring5.x的变化
- Spring 5.x最低要求JDK8与J2EE 7(Servlet 3.1/Tomcat 8.5+)
- Spring 5.x支持JDK8、9,可以使用新特性
- Spring 5.x最重要的新特性支持响应式编程
二、Spring MVC 环境配置
1.Spring MVC配置步骤
- Maven依赖spring-webmvc
- web.xml配置DispatchServlet
- 配置applicationContext的mvc标记
- 开发Controller控制器
2.代码实例
<?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.learn</groupId>
<artifactId>FistSpringMVC</artifactId>
<version>1.0-SNAPSHOT</version>
<properties>
<maven.compiler.source>8</maven.compiler.source>
<maven.compiler.target>8</maven.compiler.target>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.3.19</version>
</dependency>
</dependencies>
</project>
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
version="3.1">
<!-- DispatchServlet -->
<servlet>
<servlet-name>springmvc</servlet-name>
<!--
DispatcherServlet是Spring MVC最核心的对象
DispatcherServlet用于拦截Http请求
并根据请求的URL调用与之相对应的Controller方法,来完成Http请求的处理
-->
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!-- applicationContext.xml -->
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:applicationContext.xml</param-value>
</init-param>
<!--
在Web应用启动时自动创建Spring IOC容器,
并初始化DispatcherServlet
-->
<load-on-startup>0</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>springmvc</servlet-name>
<!-- “/”代表拦截所有请求 -->
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
<?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.xsd">
<!--
context:component-scan标签作用
在Spring IOC初始化过程中,自动创建并管理com.learn.springmvc及子包中拥有
以下注解的对象.
@Repository
@Service
@Controller
@Component
-->
<context:component-scan base-package="com.learn.springmvc"></context:component-scan>
<!-- 启用Spring MVC的注解开发 -->
<mvc:annotation-driven/>
<!-- 将图片、js、css等静态资源排除在外,可提高执行效率 -->
<mvc:default-servlet-handler/>
</beans>
3.注解表
注解 | 说明 |
---|---|
@Component | 组件注解,通用注解,被该注解描述的类将被IOC容器管理并实例化 |
@Controller | 语义注解,说明当前类是MVC应用中的控制器类 |
@Service | 语义注解,说明当前类是Service业务服务类 |
@Repository | 语义注解,说明当前类用于业务持久层,通常描述对应的Dao类 |
三、Spring MVC数据绑定
1.URL Mapping(URL映射)
- URL Mapping指将URL与Controller方法绑定
- 通过将URL与方法绑定,Spring MVC 便可以通过Tomcat对外的暴露服务
2.URL Mapping注解
注解 | 说明 |
---|---|
@RequestMapping | 通用绑定,放在类上设置根映射,放在方法上,不再区分get、post请求,但我们并不推荐在方法使用它 |
@GetMapping | 绑定Get请求,作用于方法上 |
@PostMapping | 绑定Post请求,作用于方法上 |
3.接收请求参数
接收请求参数的常用作法
- 使用Controller方法参数接收
- 使用Java Bean接受数据
- @RequestParam
- GET请求与Java命名规范不相同,为符合二者需求,@RequestParam 可以将GET请求传过来的参数注入到符合Java命名规范的变量中
使用Java Bean接受请求参数
@PostMapping("/p1")
@ResponseBody
public String postMapping(User user){
System.out.println(user.getUsername() + ":" + user.getPassword());
return "This is post method!";
}
package com.learn.springmvc.entity;
public class User {
private String username;
private Long password;
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public Long getPassword() {
return password;
}
public void setPassword(Long password) {
this.password = password;
}
}
4.案例——接受表单复合数据
- 利用数组或者List接收请求中的复合数据
- 利用@RequestParam为参数设置默认值
- 使用Map对象接收请求参数及注意事项
- Map对象只能接收单个数据,接受复合数据会存在数据丢失
package com.learn.springmvc.controller;
import com.learn.springmvc.entity.Form;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;
import java.util.List;
import java.util.Map;
@Controller
public class FormController {
@PostMapping("/apply1")
@ResponseBody
public String apply(@RequestParam(defaultValue = "ANON") String name, String course, Integer[] purpose){
System.out.println(name);
System.out.println(course);
for(Integer p: purpose){
System.out.println(p);
}
return "SUCCESS";
}
@PostMapping("/apply2")
@ResponseBody
public String apply(String name, String course, List<Integer> purpose) {
System.out.println(name);
System.out.println(course);
for (Integer p : purpose) {
System.out.println(p);
}
return "SUCCESS";
}
@PostMapping("/apply3")
@ResponseBody
public String apply(Form form) {
System.out.println(form.getName());
System.out.println(form.getCourse());
for (Integer p : form.getPurpose()) {
System.out.println(p);
}
return "SUCCESS";
}
@PostMapping("/apply")
@ResponseBody
public String apply(@RequestParam Map map){
System.out.println(map);
return "SUCCESS";
}
}
四、关联对象赋值
1.案例——复杂内容表单
- 关联对象赋值是指在一个对象中调用另一个对象
- 对包含在当前类中的某一个类的对象(如下代码中Form类中包含的Delivery对象)通过表单进行赋值时,需要将表单中的name属性以object.attribute的形式
@PostMapping("/apply")
@ResponseBody
public String applyDelivery(Form form){
System.out.println(form.getDelivery().getName());
return "SUCCESS";
}
package com.learn.springmvc.entity;
public class Delivery {
private String name;
private String address;
private String mobile;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getAddress() {
return address;
}
public void setAddress(String address) {
this.address = address;
}
public String getMobile() {
return mobile;
}
public void setMobile(String mobile) {
this.mobile = mobile;
}
}
<h3>收货人</h3>
<input name= "delivery.name" class="text" style="width: 150px">
<h3>联系电话</h3>
<input name= "delivery.mobile" class="text" style="width: 150px">
<h3>收货地址</h3>
<input name="delivery.address" class="text" style="width:150px";>
五、日期类型转换
- 前端传送的数据往往作为字符串的形式发送,我们在后端中需要进行类型转换,如果直接转换成Date类型,由于Spring不知道如何区分年月日,则会反馈String类型无法转换为Date类型的错误异常。
- @DateTimeFormat(pattern = “yyyy-MM-dd”) 按照指定格式将前台的字符串转换为对应的的Date对象
- 引入全局默认时间转换器
- 如果既存在@DateTimeFormat注解,又存在全局时间转换器类,则优先使用全局默认时间转换器类,而之前的存在@DateTimeFormat则会被忽略
- 如果需要使用不同的日期格式,需要通过全局时间转换器通过判断类进行相应的输出
<mvc:annotation-driven conversion-service="conversionService"/>
<bean id="conversionService" class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
<property name="converters">
<set>
<bean class="com.learn.springmvc.converter.MyDateConverter"></bean>
</set>
</property>
</bean>
package com.learn.springmvc.converter;
import org.springframework.core.convert.converter.Converter;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
public class MyDateConverter implements Converter<String, Date> {
@Override
public Date convert(String source) {
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
try {
Date d = sdf.parse(source);
return d;
} catch (ParseException e) {
return null;
}
}
}
六、解决请求中的中文乱码
1.Web应用中中文乱码的由来:
- Tomcat默认使用字符集ISO-8859-1,属于西欧字符集
- 解决乱码的核心思路是将ISO-8859-1转换为UTF-8
- Controller中请求与响应都需要设置UTF-8字符集
2.中文乱码的配置
-
解决Get请求乱码 - server.xml增加URIEncoding属性
如果是TomCat 8.0以后的版本可以忽略此项
-
解决Post请求乱码 - web.xml配置CharacterEncodingFilter
<filter>
<filter-name>characterFilter</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>characterFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
- 解决Response响应乱码 - Spring配置StringHttpMessageConverter
<mvc:annotation-driven conversion-service="conversionService">
<mvc:message-converters>
<bean class="org.springframework.http.converter.StringHttpMessageConverter">
<property name="supportedMediaTypes">
<list>
<value>text/html;charset=utf-8</value>
</list>
</property>
</bean>
</mvc:message-converters>
</mvc:annotation-driven>
七、响应输出结果
1.响应中产生结果
- @ResponseBody - 产生响应文本
- @ResponseBody直接产生响应体的数据,过程不涉及任何视图
- @ResponseBody可产生标准字符串/JSON/XML等格式数据
- @ResponseBody被StringHttpMessageConverter所影响
- MoelAndView - 利用模板引擎渲染输出
- ModelAndView对象是指“模型(数据)与视图(界面)”对象
- 通过ModelAndView可将包含数据对象与模板引擎进行绑定
- Spring MVC中默认的View是JSP,也可以配置其他模板引擎
2.ModelAndView对象核心用法
- mav.addObject()方法设置的属性默认存放在当前请求中
- ModelAndView默认使用请求转发(forward)页面
- 页面重定向使用new ModelAndView(“redirect:/index.jsp”)
3.String 与ModelMap实现ModelAndView
- 方法被@ResponseBody描述,SpringMVC直接响应String字符串本身
- 方法不存在@ResponseBody,则SpringMVC处理String指代的视图(页面)
//String 与ModelMap实现ModelAndView
//Controller方法返回String的情况
//1.方法被@ResponseBody描述,SpringMVC直接响应String字符串本身
//2.方法不存在@ResponseBody,则SpringMVC处理String指代的视图(页面)
public String showView1(Integer userId, ModelMap modelMap){
String view = "/um/view.jsp";
User user = new User();
if (userId == 1){
user.setUsername("lily");
}else if(userId == 2){
user.setUsername("smith");
}else if(userId == 3){
user.setUsername("lina");
}
modelMap.addAttribute("u", user);
return view;
}
八.Spring MVC整合Freemarker
- pom.xml引入依赖
<dependency>
<groupId>org.freemarker</groupId>
<artifactId>freemarker-gae</artifactId>
<version>2.3.28</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context-support</artifactId>
<version>5.3.19</version>
</dependency>
- 启用Freemarker引擎
<bean id="ViewResolver" class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver">
<property name="contentType" value="text/html;charset=utf-8"/>
<property name="suffix" value=".ftl"/>
</bean>
- 配置Freemarker参数
<bean id="freemarkerConfig" class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
<property name="templateLoaderPath" value="/WEB-INF/ftl"/>
<property name="freemarkerSettings">
<props>
<prop key="defaultEncoding">UTF-8</prop>
</props>
</property>
</bean>