项目搭建
1、maven构建一个普通web项目
在idea下,新建一个maven管理的普通web项目,初始目录只有webapp,其他的目录像java目录resources目录需要自己建立并配置。
2、导入依赖
2.1)新建maven项目的时候就会弹出是否开启自动导入依赖,开启后无需再次设置,如果没有开启,可以在setting中,搜索auto 相关的关键字设置即可。
2.2)如果之搭建SpringMVC的环境,只需要将一个spring-webmvc
核心jar的依赖写入pom.xml后,maven自动导入其他依赖。
2.3)因为DispatcherServlet
是基于Servlet的,所以必须导入javax.servlet
的一个jar,如果项目中还用到了jsp、jstl表达式相关的一些东西,还需要额外导入两个相关的jar。
下面展示了一个springmvc所用到的依赖,jsp和jstl相关的jar可以根据实际项目进行排除,所以如果想要搭建SpringMVC的环境,至少需要写两个依赖。
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.1.9.RELEASE</version>
</dependency>
<!-- https://mvnrepository.com/artifact/javax.servlet/javax.servlet-api -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>4.0.1</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>javax.servlet.jsp</groupId>
<artifactId>jsp-api</artifactId>
<version>2.2</version>
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>jstl</artifactId>
<version>1.2</version>
</dependency>
3、注册前端控制器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>dispatcher</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>dispatcher</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
4、配置SpringMVC应用上下文,添加应用启动所必须的配置文件
没有设置<load-on-startup>1</load-on-startup>
该选项,DispatcherServlet
在第一次请求时才会初始化,设置<load-on-startup>1</load-on-startup>
,当容器启动的时候就会自动加载该servlet,DispatcherServlet
的加载必须要相应的配置文件,没有相应的配置文件,这时候控制台会立即报错提示。相比没有设置,只是把报错往后延时到了第一次请求的时候,总之,DispatcherServlet
的初始化,必须要相应的配置文件,没有则报错。
配置文件的设置:
1)采取默认设置,DispatcherServlet
初始化的时候会自动加载WEB-IFN/servletName-servlet.xml
文件,根据上述web.xml配置,只要把以dispatcher-servlet.xml
的文件放入WEB-IFN/
目录下即可被自动加载。
2)不想以servletName-servlet.xml
名字作为配置文件名,自定义文件名,文件的位置还是在WEB-IFN/
目录下。可以通过<servlet>
标签下<init-param>
属性设置,如下
还是借用上面的web.xml配置,假设WEB-INF/
下的springMVC要想被自动加载,这时候可以通过添加如下配置:
<servlet>
<servlet-name>dispatcher</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>namespace</param-name>
<param-value>springMVC</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
3)加载类路径下的配置文件
<servlet>
<servlet-name>dispatcher</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>1</load-on-startup>
</servlet>
5、设置包扫描,视图过滤器、开启注解等配置。
实例:
<?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 base-package="controller"/>
<mvc:annotation-driven/>
</beans>
<context:component-scan
:包扫描,主要是加载bean,并将其存放到到IOC中。
<mvc:annotation-driven/>
的作用:注册了一系列基础bean,和一些classpath上依赖进来的bean。基础bean只能提供最基础的服务,其它的扩展功能,比如JSON、XML、Valid等等,根据classpath有没有相关的依赖来决定要不要添加对应的bean或者属性。
如果没有配置可能会出现:Map类型的对象JSON序列化出现问题(如下),静态资源得不到处理等。
19-Oct-2020 18:54:20.847 警告 [http-nio-8080-exec-6] org.springframework.web.servlet.handler.AbstractHandlerExceptionResolver.logException Resolved [org.springframework.http.converter.HttpMessageNotWritableException: No converter found for return value of type: class java.util.HashMap]
创建web容器
1、web容器的创建要依赖相应的配置文件,否则就有可能出现错误。
2、配置文件定义了web容器的属性和其中能够存放的bean。
3、容器创建的目的就是存放bean,将配置文件中的bean标签下的类实例化放入容器,提供web请求和响应的处理域对象。
4、web容器默认都会有一个根容器,SpringMVC在初始化的时候会将根容器作为它的父容器,web容器可以使用父容器中已存在的任何bean,容器的关系可以以类中继承的特性去理解。
开发中创建web容器的常用方式:
(1)上下文层次结构
上面也是最常见的分层开发,各个层次的bean在自己的容器中被管理,就像我们在spring-mvc.xml(或者其他web层.xml文件)配置的<context:component-scan package="*.controller|web包下"/>
属性,将controller包下的bean放入web容器中管理,其他层的bean则放入Spring容器中管理。在web层下,可以利用上层即根容器的bean。上图很完美地展示了这一关系。
web.xml文件中一般都是如下配置
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<servlet>
<servlet-name>dispatcher</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!--默认扫描WEB-INF/(servlet-name)-servlet.xml 或者 采用下面 -->
<!--自定义配置-->
<!--
<init-param>
<param-name>namespace</param-name>
<param-value>spring-mvc.xml</param-value>
</init-param>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/spring-mvc.xml</param-value>
</init-param>
-->
</servlet>
关键点:
- 注册监听器类
ContextLoaderListener
,如果不提供<context-param>
默认扫描WEB-INF/applicationContext.xml
的文件,创建根容器,web容器的父容器。
(2)SpringMVC的单根上下文
正如上图,这种方式创建的web容器,所有的bean实例都在上层根容器中,web容器中没有任何相关的bean。在web.xml文件中做如下配置就能实现图中所示的效果。
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<servlet>
<servlet-name>dispatcher</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value></param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
...
servlet下的contextConfigLocation属性值是一个空,其实这无关紧要,如果该路径提供的配置文件里面并没有相关的bean或者开启注解、注解扫描之类的标签配置,那么就不会有相应的web层对象产生并交由web容器处理,之后监听器监听到容器启动默认扫描WEB-INF/applicationContext.xml
的文件,创建根容器,在applicationContext.xml
配置文件中可以将包扫描范围由service、dao等层级扩大到controller层,这样所有的bean对象就都能被根容器所管理。
疑点
1、contextConfigLocation
配置范围
contextConfigLocation
可以在<context-param>
标签下还可以在<servlet><init-param>
标签下配置,两者为代表的所创建的容器是不一样的,可以这样理解,<context-param>
标签下配置所创建的容器是一个根容器或者全局容器,而<servlet><init-param>
标签下配置所创建的容器是一个web容器或者局部容器。
2、ContextLoaderListener
监听器的意义
单层开发,只存在web层,在入门学习SpringMVC的时候就是单层,不配置这个监听器web容器也能创建,可以理解为将所有的bean都放在了web层而不是根层或者说根容器中是空的。
<servlet>
<servlet-name>dispatcher</servlet-name>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/spring-mvc.xml</param-value>
</init-param>
</servlet>
contextConfigLocation属性加载的web容器,必须指定value,因为它不会像监听器
ContextLoaderListener
那样自动去寻找配置文件,如果不指定value,web容器可以创建成功,但是容器中是空的,当请求特定的controller时,因为没有对象在容器中,结果会404。