SpringMVC-HelloWorld

一、SpringMVC简介

1.1 SpringMVC和三层架构

MVC是一种软件架构思想，将软件按照模型、视图和控制器三个部分划分。

M：model，模型层，指工程中的JavaBean，用于处理数据。JavaBean分为两类：
- 实体类Bean：用于存储业务数据，如Student类等。
- 业务处理Bean：Service或Dao对象，专门用于处理业务逻辑和数据访问。Dao对象用于实现对数据的增删改查，Service对象用于实现带业务逻辑的增删改查。
V：View，视图层，指工程中的html或jsp等页面，作用是与用户进行交互，展示数据。
C：Controller，控制层，指工程中的Servlet，作用是接收请求和做出响应。
MVC工作流程：用户通过视图层发送请求给服务器，服务器通过Controller调用Model层的API来处理请求，然后得到处理结果，并由Controller响应给客户端。

三层架构是指将软件划分为三个层次：表示层、业务逻辑层和数据访问层。

表示层：主要指与用户交互的界面，接收用户请求并做出响应。
业务逻辑层：用于处理业务逻辑。
数据访问层：完成对数据库的基本操作。

SpringMVC是Spring为表示层开发提供的一整套完备的解决方案，具有以下特点：

Spring家族原生产品，与IOC容器等基础设施无缝对接。
通过功能强大的前端控制器DispatcherServlet，对请求和响应进行统一处理。
表示层各细分领域需要解决的问题全方位覆盖，提供全面的解决方案。
代码简洁，大幅度提升开发效率。
内部组件化程度高，可插拔式组件即插即用。
性能卓越，尤其适合大型、超大型互联网项目需求。

二、HelloWorld

2.1 创建工程

首先在IDEA中创建一个空项目，接着记得在项目结构中添加使用的JDK版本，然后创建一个maven工程。接着配置使用的maven，可以配置本地maven，也可以使用默认的maven。+ 接着将maven工程转换成web工程。首先将工程的打包方式声明为war，接着在项目结构中右键单击项目，为项目添加web组件，在src/main/webapp/WEB-INF目录下配置web.xml文件。
最后导入项目所需要的依赖。

xml 复制代码

<dependencies>
        <!--注意依赖的版本，不对可能会报错，建议使用和下面一样的版本-->
        
        <!--springMVC-->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>5.3.9</version>
        </dependency>
        <!--thymeleaf和spring5的整合-->
        <dependency>
            <groupId>org.thymeleaf</groupId>
            <artifactId>thymeleaf-spring5</artifactId>
            <version>3.0.11.RELEASE</version>
        </dependency>

        <!--日志-->
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-classic</artifactId>
            <version>1.2.3</version>
        </dependency>

        <!--ServletAPI-->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.1.0</version>
            <!--设置依赖范围为provided，因为Tomcat提供了servletAPI-->
            <scope>provided</scope>
        </dependency>

    </dependencies>

2.2 配置web.xml

在web.xml中配置SpringMVC的前端控制器DispatcherServlet。

2.2.1 默认配置方式

在默认配置方式下，SpringMVC的配置文件默认位于WEB-INF目录下，默认名称为<servlet-name>-servlet.xml。

xml 复制代码

    <servlet>
        <servlet-name>DispatcherServlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>DispatcherServlet</servlet-name>
        <!--/可以匹配除jsp外的所有资源，也就是说除jsp外的所有请求都会由DispatcherServlet处理
            由于jsp需要特殊的servlet处理，所以不由DispatcherServlet处理
            /*表示匹配所有的请求，包括jsp-->
        <url-pattern>/</url-pattern>
    </servlet-mapping>

2.2.2 扩展配置方式

可以通过init-param标签设置SpringMVC配置文件的位置和名称，然后在resources目录下创建spring的配置文件，通过load-on-startup标签设置前端控制器DispatcherServlet的初始化时间。

将springMVC配置文件放在resources目录下是因为我们在实际中，也是将配置文件都放在这个目录下的，所以需要使用扩展配置方式，而不是让springMVC配置文件在WEB-INF目录下。

xml 复制代码

    <servlet>
        <servlet-name>DispatcherServlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <!--contextConfigLocation是固定值-->
            <param-name>contextConfigLocation</param-name>
            <!--使用classpath表示从类路径查找配置文件
                类路径即打包后的classes文件夹
                在工程中也就是src/main下的java目录和resources目录-->
            <param-value>classpath:springMVC.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>DispatcherServlet</servlet-name>
        <!--/可以匹配除jsp外的所有资源，也就是说除jsp外的所有请求都会由DispatcherServlet处理
            由于jsp需要特殊的servlet处理，所以不由DispatcherServlet处理
            /*表示匹配所有的请求，包括jsp-->
        <url-pattern>/</url-pattern>
    </servlet-mapping>

2.3 创建请求控制器

由于前端控制器需要对每一个浏览器发送的请求进行出路，但是不同的请求有不同的处理过程，因此需要创建处理具体请求的类，即请求控制器。

springMVC的控制器由一个POJO（普通Java类）担任，需要使用@Controller注解将其标识为一个控制层组件，交给IOC容器管理。

请求控制器中的方法称为控制器方法。

2.4 创建springMVC配置文件

要使得控制器能被识别，还需要开启扫描。接着配置thymeleaf视图解析器。

xml 复制代码

	<!--组件扫描-->
    <context:component-scan base-package="pers.beiluo.springMVC.hello" />
    <!--配置thymeleaf视图解析器-->
    <bean id="viewResolver" class="org.thymeleaf.spring5.view.ThymeleafViewResolver">
        <property name="order" value="1"/>
        <property name="characterEncoding" value="UTF-8"/>
        <property name="templateEngine">
            <bean class="org.thymeleaf.spring5.SpringTemplateEngine">
                <property name="templateResolver">
                    <bean class="org.thymeleaf.spring5.templateresolver.SpringResourceTemplateResolver">
                        <!--在收到请求后，请求控制器方法会返回视图的名称给前端控制器
                            视图名称和前缀后缀组合成完整的资源路径，用于定位资源-->
                        <!-- 视图前缀 -->
                        <property name="prefix" value="/WEB-INF/templates/"/>
                        <!-- 视图后缀 -->
                        <property name="suffix" value=".html"/>
                        <property name="templateMode" value="HTML5"/>
                        <property name="characterEncoding" value="UTF-8" />
                    </bean>
                </property>
            </bean>
        </property>
    </bean>

2.5 访问index.html

在WEB-INF目录下的templates目录下创建index.html文件，并且要在html标签中加入 xmlns:th="http://www.thymeleaf.org"属性。并且index.html文件位于WEB-INF目录下，是受保护的资源，需要通过请求转发来访问。

要访问index.html文件，就需要在请求控制器中通过控制方法返回视图名称给前端控制器，并通过thymeleaf视图解析器获得资源完整路径再进行请求转发。

java 复制代码

/**
     * @RequestMapping注解用于指定请求地址与请求控制器方法的映射关系
     * 使用字符串作为参数就是直接给value属性赋值
     * /表示输入当前项目的时匹配的就是这个方法，也就是访问index.html视图
     * @return 返回视图名称，并通过thymeleaf视图解析器得到完整路径
     */
    @RequestMapping("/")
    public String toIndex(){
        return "index";
    }

2.6 通过a标签跳转页面

设置a标签

html 复制代码

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<h1>HelloWorld</h1>
<!--如果通过href跳转页面，路径中就需要写上项目的上下文路径
    但是项目的上下文路径是可以改变的，所以这不方便
    可以通过thymeleaf语法来自动获得项目的上下文路径
    因为要使用thymeleaf语法，所以必须加上 xmlns:th="http://www.thymeleaf.org"-->
<a th:href="@{/target}">通过a标签跳转到指定页面</a>
</body>
</html>

配置处理该请求的方法：

java 复制代码

/**
     * 处理/springMVC/target请求的方法
     * @return 返回视图的名称
     */
    @RequestMapping("/target")
    public String toTarget(){
        return "target";
    }

2.7 总结

浏览器发送请求后，若请求地址符合前端控制器的url-pattern，该请求就会交由前端控制器来处理，前端控制器会根据springMVC.xml配置文件，扫描组件找到控制器，将请求地址与控制器方法的@RequestMapping注解的value属性进行比较，如果匹配成功，就执行匹配成功的控制器方法。该方法返回一个字符串类型的视图名称，该名称会被thymeleaf视图解析器解析，加上前后缀组成完整路径，通过thymeleaf对视图进行渲染，最终转发到视图对应页面。