SpringMVC 入门

空扰寡人 提交于 2020-02-06 23:53:09

SpringMVC 框架概述

Spring Web MVC是基于Servlet API构建的传统Web框架,并且从一开始就已包含在Spring框架中

与Spring Web MVC并行,Spring Framework 5.0引入了一个新的反应式Web框架,其名称“ Spring WebFlux;

理解:

首先SpringMVC 是一个MVC构架模式的web框架,是基于Servlet的,从Spring第一个版本就一起推出了,

传统web框架,指的是SpringMVC依然使用多线程同步并发的方式来处理请求,现如今大家都在鼓吹异步并发多么多么好,从测试数据来看异步并发效率的确更好,但是其并不成熟,极大多数公司项目还没有更新到异步技术,盲目的进行重构可能会引发更多的问题, 并且异步编程在代码结构上会产生较大的变化,对于初学者而言,掌握难度是较大的;

构架图:

Spring-MVC在系统中的位置

可以看出

SpringMVC 并没有代替Servlet,它只是在Servlet上提供了一套封装好的组件,提高开发效率;

还使得开发出的项目更加规范;否则每个人可能有每个人不同的MVC;

SpringMVC核心组件

思考:

若没有SpringMVC框架,我们该如何去编写一个较大的web项目呢,可以发现在选课系统中出现了大量的Servlet,因为一个请求地址就需要一个Servlet,使得项目体积变大,且Servlet是长期存在内存的;

第一步,我们希望用一个Servlet来处理多个请求甚至是所有请求,就需要实现能根据请求路径查找处理请求方法的逻辑,这也是SpringMVC要做的第一件事情;

  • DispatcherServlet:前端控制器
    用户请求首先到达前端控制器,它就相当于mvc模式中的c,DispatcherServlet是整个流程控制的调度中心,由它调用其它组件处理用户的请求,DispatcherServlet的存在降低了组件之间的耦合性。
  • Handler:处理器
    Handler是继DispatcherServlet前端控制器的后端控制器,DispatcherServlet会将请求发送至对应的Handler来进行处理。Handler是处理业务逻辑的地方,需要我们自己来编写具体代码,等同于之前的Service层
  • HandlerMapping:处理器映射器
    HandlerMapping负责根据用户请求路径找到Handler,springmvc提供了不同的映射器实现不同的映射方式,例如:BeanName映射,配置文件映射,注解映射等。
  • HandlAdapter:处理器适配器
    通过HandlerAdapter来执行Handler,因为Handler有不同形式,意味着调用方式是不同的,这是适配器模式的应用,我们也可以扩展适配器来实现新的Handler;
  • ViewResolver:视图解析器
    ViewResolver负责从Handler中获取数据和视图,根据逻辑视名称查找物理视图文件,并查找View对象,再生成View对象;
  • View:视图
    View的职责就是装配数据,SpringMVC框架提供了很多的View视图类型的支持,包括:jstlView、freemarkerView、pdfView等。常用视图就是jsp。我们需要根据业务需求,通过页面标签或页面模版技术将模型数据展示给用户

当然还有一些其他的

类型 说明
HandlerExceptionResolver Handler异常处理器
LocaleResolver 提供国际化的视图。根据不同地区显示不同内容
ThemeResolver 根据不同地区提供个性化的布局
MultipartResolver 解析multipart请求数据,如浏览器表单文件上传
FlashMapManager 常用于通过重定向将属性从一个请求传递到另一个请求

请求处理流程简述

入门程序

pom依赖

<?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>org.example</groupId>
  <artifactId>MVC01</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>war</packaging>

  <name>MVC01 Maven Webapp</name>
  <!-- FIXME change it to the project's website -->
  <url>http://www.example.com</url>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.7</maven.compiler.source>
    <maven.compiler.target>1.7</maven.compiler.target>
  </properties>

  <dependencies>
    <!--   SpringMVC -->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>5.2.2.RELEASE</version>
    </dependency>

    <!--JEE相关的-->
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>jstl</artifactId>
      <version>1.2</version>
    </dependency>
    <dependency>
      <groupId>javax.servlet.jsp</groupId>
      <artifactId>javax.servlet.jsp-api</artifactId>
      <version>2.3.3</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>4.0.1</version>
      <scope>provided</scope>
    </dependency>
  </dependencies>
</project>

web.xml配置

与在web项目中使用Spring中相同的是,我们也需要让SpringMVC随着web项目启动,SpringMVC的做法是利用DIspatcherServlet;

<?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_4_0.xsd"
         version="4.0">

    <servlet>
        <servlet-name>DispatcherServlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!--        初始化参数指定配置文件-->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:springmvc.xml</param-value>
        </init-param>
        <load-on-startup></load-on-startup>
    </servlet>

<!--    要交给SpringMVC处理的请求-->
    <servlet-mapping>
        <servlet-name>DispatcherServlet</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
</web-app>

DispatcherServlet做了两个事情,1:初始化一个Spring容器,2:注册一个Servlet

SpringMVC本质上也是一个Spring容器,在不涉及WEB时使用方法和Spring没有任何区别;ß

url-pattern

只有请求地址能够匹配到到被DispatcherServlet的url-pattern的请求才会被SpringMVC处理,那么那些请求要交给SpringMVC处理呢,通常是除静态资源以外的请求;

常用pattern:

pattern 说明
/ 除了.jsp 以外的所有请求
/* 所有请求
*.action 所有 以action结尾的请求

需要说明的是action并不是固定的不同公司可能不同,但无论是点什么,其目的都是为了和静态资源加以区分

创建控制器类

import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class TestController implements Controller {

    @Override
    public ModelAndView handleRequest(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse) throws Exception {
        ModelAndView modelAndView = new ModelAndView();//创建一个表示模型和视图的对象
        modelAndView.setViewName("index.jsp");//设置视图名称
        modelAndView.addObject("msg","hello springMVC");//添加视图需要的数据
        //httpServletRequest.setAttribute("msg","hello SpringMVC"); //等同于上面一行
        return modelAndView; //返回模型和视图给dispatcherServlet
    }
}

ModelAndView,其实就是把视图资源和数据打包到一起,然后视图名称交给视图解析器,Object放到请求中;

注册控制器到容器中

springmvc.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">

    <bean name="/testController" class="com.yh.controller.TestController"/>
</beans>

DispatcherServlet是按照请求路径来查找Handler,我们必须告诉SpringMVC,这个控制器是用来处理哪个请求地址的,默认情况下,SpringMVC会查找beanName与请求地址相同的Handler来处理;

测试:

打开浏览器输入地址:http://localhost:8080/MVC01_war_exploded/testController

我们在Request中添加了key为msg的字符内容hello SpringMVC

看到上述内容说明SpringMVC以及成功处理了请求;

注解配置Controller

上述方法每个Controller只能处理一个请求地址,不够灵活,且需要Controller实现指定接口,这是就需要使用注解来配置Controller了;

  • @Controller

    该注解写在类上,用于注册控制器bean到容器中,这是之前以及学习过的

  • @RequestMapping("url")

    该注解写在方法上时,用于为方法指定要匹配的url,该url是相对根路径的

    写在类上时类上的url是相对于根路径,而类中方法则相对于类的url

案列:

@Controller
//@RequestMapping("/user")
public class UserController {
    @RequestMapping("/getMsg")
    public ModelAndView getMsg(){
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.setViewName("/index.jsp");
        modelAndView.addObject("msg","hello SpringMVC annotation!");
        return modelAndView;
    }
}

请求地址:http://localhost:8080/MVC01_war_exploded/getMsg,可正常访问

当把类上注释的url打开时,上面的地址404了

正确地址:http://localhost:8080/MVC01_war_exploded/user/getMsg

需要注意的是:
viewName路径若不带/时则从当前请求的位置查找文件,带/则表示从根路径查找

默认配置阅览

我们完成了一个简单的入门案例,但是你会发现除了DispatcherServlet之外没有出现其他上面提到过的组件,那么它们是不是没有作用呢?

其实SpringMVC提供了很多默认配置,使我们可以快速的开项目,而无需繁琐的配置,在SpringMVC的包下可以找到一个DispatcherServlet.properties配置,这便是默认的配置文件了;

RouterFunctionMapping和HandlerFunctionAdapter都是webFlux中的这里不多关注;

HandlerMapping 映射方式
BeanNameUrlHandlerMapping 用beanName作为url
RequestMappingHandlerMapping 使用注解配置url
HandlerAdapter 处理对象:
HttpRequestHandlerAdapter 实现HttpRequestHandler的处理器
SimpleControllerHandlerAdapter 实现Controller的处理器
RequestMappingHandlerAdapter 使用注解的handler,无需实现接口
SimpleServletHandlerAdapter Servlet类Handler,需继承HttpServlet

SimpleServletHandlerAdapter默认是没有的,当需要使用Servlet相关API时使用,需要在配置文件中声明

<bean class="org.springframework.web.servlet.handler.SimpleServletHandlerAdapter"/>

注意:当手动添加了适配器后,系统就不会自动添加任何其他适配器了;

SimpleServletHandlerAdapter案例:

@Controller("/servletController")
public class YouController extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        resp.getWriter().println("servlet API");
    }
}

请求地址:http://localhost:8080/MVC01_war_exploded/servletController,记得注册Adapter到容器中;

在上述4中handler中最常用的是使用注解形式的;

视图解析配置

视图解析器用于查找视图文件,及生成视图对象,我们不用过多关注,唯一会用到的就是,为视图名称配置前缀和后缀从而简化,Handler中的书写

在一个实际项目中页面文件可能比较多,可以用文件夹管理,但是这导致我们在编写视图名称时更加繁琐,例如:

handler中:

这时就可在配置中对视图解析器进行相关设置;

<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
  <!--指定视图类型-->
    <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
  <!--指定前缀-->
    <property name="prefix" value="/pages/jsp/"/>
  <!--指定后缀-->
    <property name="suffix" value=".jsp"/>
</bean>

处理器中:

@RequestMapping("/getMsg")
public ModelAndView getMsg(){
    ModelAndView modelAndView = new ModelAndView();
    modelAndView.setViewName("index");
    modelAndView.addObject("msg","hello SpringMVC annotation!");
    return modelAndView;
}

视图解析器会自动在viewName前后分别拼接前缀和后缀;如:/pages/jsp/index.jsp

启用MVC 配置

上面提到,SpringMVC默认会加载DispatcherServlet.properties中的配置作为默认配置,当我们需要添加额外的自定义配置时该怎么办呢?这是我们需要启用MVC配置,通过在配置文件中添加以下标签

<mvc:annotation-driven/>

为了减少配置项,该标签向容器中添加了提供MVC基础服务的Bean,并添加了json,xml,的转换器

有兴趣可以源码位置:web包下的AnnotationDrivenBeanDefinitionParser,

此时看不出该标签对系统有什么影响,但在后续自定义验证器,转换器时就不得不使用到该标签了

官方原话:

"in XML configuration, you can use the `<mvc:annotation-driven/>` element to enable MVC configuration, the preceding example registers a number of Spring MVC infrastructure beans and adapts to dependencies available on the classpath (for example, payload converters for JSON, XML, and others)"
易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!