SpringMVC 入门
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在系统中的位置
![image-20200206122121806](https://tva1.sinaimg.cn/large/006tNbRwgy1gbmk8rad3pj30mn0f7wg6.jpg)
可以看出
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)"