Spring MVC

一、什么是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>