文章目录
一、创建maven
工程步骤
1.添加web
模块
如果我们在创建maven
工程时,没有添加web
模块,就是可以手动添加web
模块
注意是:type
中点击+
号可以添加,路径一定要存放在src/mainwebapp
目录下
Web resouces dirctory path:
路径是:
2.打包方式在pom.xml
中修改打包方式为war
方式
3.引入依赖
<dependencies>
<!-- SpringMVC -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.3.1</version>
</dependency>
<!-- 日志 -->
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
<version>1.2.3</version>
</dependency>
<!--
ServletAPI
<scope>provided</scope>表示是在打成`war包`时,将不会再该jar打入
原因是tomcat服务器因为提供了 servlet和jsp的jar包了
jar由于服务器提供
-->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.1.0</version>
<scope>provided</scope>
</dependency>
<!-- Spring5和Thymeleaf整合包 -->
<dependency>
<groupId>org.thymeleaf</groupId>
<artifactId>thymeleaf-spring5</artifactId>
<version>3.0.12.RELEASE</version>
</dependency>
</dependencies>
二、配置web.xml
文件
注册SpringMVC
的前端控制器DispatcherServlet
,本质是DispatcherServlet
是Servlet
进行了封装,所以需要注册SpringMVC
前端控制器,对浏览器所发送请求统一进行处理
<?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">
<!--开启组件扫描-->
<context:component-scan base-package="com.haiknag.mvc.controller"/>
<!--
注册springMVC的前端控制器,对浏览器所发送的请求统一进行处理
在此配置文件下,SpringMVC的配置文件具有默认的位置和名称
默认的位置是:WEB-INF
默认的名称:<servlet-name>-servlet.xml
-->
<servlet>
<servlet-name>SpringMVC</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!--通过初始化参数指定SpringMVC配置文件的位置和名称-->
<init-param>
<!--contextConfigLocation-->
<param-name>contextConfigLocation</param-name>
<!--使用classPath:表示类路径查找配置文件,例如:maven工程中的`src/main/resources`-->
<param-value>classpath:springMVC.xml</param-value>
</init-param>
<!--
作为框架的核心组件,在启动过程中有大量的初始化操作要做
而这些操作放在第一次请求时才执行会严重影响访问速度
表示在服务器启动时,初始化`DispatcherServlet`
-->
<load-on-startup>1</load-on-startup>
</servlet>
<!--
设置springMVC的核心控制器所能处理的请求的请求路径
/所匹配的请求可以是/login或.html或.js或.css方式的请求路径
但是/不能匹配.jsp请求路径的请求
-->
<servlet-mapping>
<servlet-name>SpringMVC</servlet-name>
<!--
配置为`/`的目的是过滤`jsp`页面相关的对应,对`jsp`页面请求不进行处理,
因为是`jsp`页面本质就是一个特殊的`servlet`,需要由特殊`servlet`进行处理
如果使用是`DispatcherServlet`前端进行处理,则会被`DispatcherServlet`前端控制器当作普通的请求处理,
而不是当作一个`jsp`页面请求
-->
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
注意是:上面配置文件中配置前端控制器时<url-pattern>/</url-pattern>
,对jsp
页面进行不处理,因为是jsp
页面是一个特殊的servlet
,需要由特殊servlet
进行处理,如果使用是DispatcherServlet
前端控制器进行处理,则会被DispatcherServlet
前端控制器当作普通的请求处理, 而不是当作一个jsp
页面请求
2.扩展配置方式【web.xml文件配置
】【重点掌握这种方式】
可以通过init-param
标签设置SpringMVC
配置文件的位置和名称,通过load-on-startup
标签设置SpringMVC
前端控制器DispatcherServlet
的初始化时间
配置init-param
标签设置的SpringMVC
配置文件的位置和名称
注意是:
`<url-pattern>`标签中使用`/`和`/*`区别:
`/`所匹配的请求可以是`/login`或`.html`或`.js`或`.css`方式的请求路径,但是`/`不能配置`.jsp`请求路径的请求
因此就可以避免在访问`jsp`页面时,该请求被`DispatcherServlet`处理,从而找到相应的页面
`/*`则能够匹配所有请求,例如在使用过滤器时,若需要对所有请求进行过滤,就需要使用`/*`的写法
3.创建请求控制器
由于前端控制器对浏览器发送的请求进行了统一的处理,但是具体的请求有不同的处理过程,因此需要创建处理具体请求的类,即为请求控制器
请求控制器中的每一个处理请求的方法成为控制器方法
因为SpringMVC
控制器由一个POJO
(普通的java
类)担任,因此需要通过@Controller
注解将其标识为一个控制器层组件,交给Spring
的ioc
容器管理,此时SpringMVC
才能够识别控制器的存在。
@Controller
public class MyController {
}
4.创建SpringMVC
文件
<!-- 自动扫描包 -->
<context:component-scan base-package="com.atguigu.mvc.controller"/>
<!-- 配置Thymeleaf视图解析器 -->
<bean id="viewResolver" class="org.thymeleaf.spring5.view.ThymeleafViewResolver">
<!--配置Thymeleeaf视图解析器的优先级-->
<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>
<!--
处理静态资源,例如html、js、css、jpg
若只设置该标签,则只能访问静态资源,其他请求则无法访问
此时必须设置<mvc:annotation-driven/>解决问题
-->
<mvc:default-servlet-handler/>
<!-- 开启mvc注解驱动 -->
<mvc:annotation-driven>
<mvc:message-converters>
<!-- 处理响应中文内容乱码 -->
<bean class="org.springframework.http.converter.StringHttpMessageConverter">
<property name="defaultCharset" value="UTF-8" />
<property name="supportedMediaTypes">
<list>
<value>text/html</value>
<value>application/json</value>
</list>
</property>
</bean>
</mvc:message-converters>
</mvc:annotation-driven>
5.在Controller
层中编写方法对请求进行处理
在请求控制器中创建处理请求的方法
@Controller
public class MyController {
// 配置请求映射
// 通过`@RequestMapper`注解,可以通过请求路径匹配要处理具体的请求
// `/`表示当前工程的上下文路径,表示就是:localhost:8080/springMVC/
@RequestMapping("/")
public String index(){
// 返回视图名称,就是需要跳转到的指定页面名称
return "index";
}
}
跳转指定的目标页面
编写相关的指定跳转页面
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>首页</title>
</head>
<body>
<h3 style="color: green">欢迎来到首页!</h3>
<a th:href="@{/target}">请求点击,跳转到目标页面!</a>
</body>
</html>
// 接收指定的跳转页面
@RequestMapping("/target")
public String target(){
// 跳转到指定的页面
return "target";
}
总结
当浏览器发送请求,若请求地址符合前端控制器的url-pattern
[就是除了jsp
页面不能处理,其他请求都可以被处理]
该请求就会被前端控制器DispatcherServlet
处理。
前端控制器会读取SpringMVC
的核心配置文件,通过扫描组件找到控制器
将请求地址和控制器中的@RequestMapping
注解的value
属性值进行匹配
若匹配成功,该注解所标识的控制器方法就是处理请求的方法。处理请求的方法需要返回一个字符串类型的视图名称
该视图名称会被视图解析器解析,加上前缀和后缀组成视图路径,通过Thymeleaf
对视图进行渲染,最终转发到视图所对应页面
注意点
在SpringMVC
中是如何定位到我们需要访问的页面的,例如:我们在控制器类Controller类
中方法上添加@RequestMapper("/")代表是http://localhost:8080/SpringMVC_hello1_war/
时,那个/
代表当前项目的虚拟目录
[也就是上下文件目录],在Controller
类的方法返回视图的名称index
,又因为在SpringMVC.xml
文件中配置了前缀和后缀
,添加上相关的前缀 和 后缀后组成用户的访问的路径http://localhost:8080/SpringMVC_hello1_war/index.html
,如果在@RequestMapper("/target")
则组成的访问路径是:http://localhost:8080/SpringMVC_hello1_war/target/index.html
// 通过`@RequestMapper`注解,可以通过请求路径匹配要处理具体的请求
// `/`表示是当前工程上下文路径:`http://localhost:8080/SpringMVC_hello1_war/`
@RequestMapping("/")
public String index(){
// 返回视图名称,就是需要跳转到的指定页面名称
// 根据前端控制器配置的前缀加上,再加上后缀组成了跳转指定的页面
// `http://localhost:8080/SpringMVC_hello1_war/WEB-INF/templates/index.html`
return "index";
}