SpringMVC快速入门、代码实现

好奇的7号

已于 2022-09-29 17:00:25 修改

阅读量502

点赞数

文章标签： servlet java tomcat spring maven

于 2022-09-27 10:42:54 首次发布

本文链接：https://blog.csdn.net/weixin_44440311/article/details/126854012

版权

前言：

在学过Spring5，JavaWeb部分的基础后，可以开始SpringMVC框架的学习了。

一. 综述

1.1 流程

在web服务中，一般的流程都要先从客户端接受请求，在Tomcat服务器接收到请求后，将信息封装成代表请求的req和代表响应的resp，再调用所请求的资源（也就是你配置的ServletMapping对应的Servlet程序）。
调用请求的资源时，其实就是调用Servlet相应的程序，而对于这个Servlet的部分可以划分为两部分：
1.Servlet中的共有行为：例如接收数据、封装实体等。
2.特有行为：功能可能不一致，比如cookie的编写、表单的校验，需要我们人为地编写。

1.2 引入SpringMVC

基于抽取的思想，把Servlet的共有行为提取出来，这部分整体由框架来封装，称之为“前端控制器”。例如本文要学习的SpringMVC，就是其中一种。使用SpringMVC框架来自动实现“共有行为”的部分，增加开发效率。

总体步骤：
1.先导入SpringMVC的jar包，然后就有了前端控制器（通过maven坐标实现）。
2.但如果想用它，就需要配置了：因为Tomcat的请求过来以后，都要先去找这个“共有行为”的Servlet。（在web.xml文件配置）
3.然后编写“特有行为”，称之为“Controller”，负责调用业务层、指派视图等具体特殊功能。
4.将步骤3的POJO整体配置成bean标签或者注解，从而配置到Spring容器中，例如使用注解@Controller来实现。
5.最后，配置组件扫描（spring-mvc.xml文件）
6.测试一下。

二.具体步骤

1.创建maven工程

如何maven工程可以参考这篇博主的文章：(37条消息) idea配置maven项目（超详细）_普通网友的博客-CSDN博客_idea配置maven

2.配置pom中的坐标

在pom.xml文件中配置坐标即可（配置坐标，听着很nb，其实就是通过maven工具自动下载并导入所需jar包，而不用像原来那样把jar包一个个加入lib再add as library了）

    <!--Spring坐标-->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>5.0.5.RELEASE</version>
    </dependency>
    <!--SpringMVC坐标-->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>5.0.5.RELEASE</version>
    </dependency>
    <!--Servlet坐标-->
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>servlet-api</artifactId>
      <version>2.5</version>
    </dependency>
    <!--Jsp坐标-->
    <dependency>
      <groupId>javax.servlet.jsp</groupId>
      <artifactId>jsp-api</artifactId>
      <version>2.0</version>
    </dependency>

3.在web.xml文件中配置SpringMVC的核心控制器

<!DOCTYPE web-app PUBLIC
 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "http://java.sun.com/dtd/web-app_2_3.dtd" >

<web-app>
  <display-name>Archetype Created Web Application</display-name>
  <servlet>
    <servlet-name>DispatchServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>DispatchServlet</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>
</web-app>

其中，在配置DispatchServlet的跳转地址时候我们配置为“/”，为了每次访问时，任何请求都要走这个servlet，也就是共有的servlet，即DispatchServlet。

4.编写具体功能（例如要返回的页面），配置Spring容器Controller注解

首先可以在webapp包下建造一个jsp文件，称为success，作为返回的页面。
作为测试，我们可以在com.zqh包下创建一个controller包，以及在里面创建UserController类。使用 @Controller 的Spring注解把这个类配置成容器。
这个UserController测试类里面我们可以创建一个方法save。其实，此时的这个save方法就相当于javaweb中的每一个servlet程序了。

对于这个特有部分的servlet程序，也就是save方法，我们通过配置 @RequestMapping 注解，相当于提供了请求地址，也就是“/quick”。而通过return就可以跳到jsp视图之中。

5.在resources下创建spring-mvc.xml文件(springConfig文件)，并配置组件扫描

注意，这一步骤如果beans没配置好可能会报500的错误，而且jdk版本也要对应（不要过高，本文采用的16.0.2版本），否则也可能会报http500的错误。

<?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:aop="http://www.springframework.org/schema/aop"
        xmlns:tx="http://www.springframework.org/schema/tx"
        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/aop
http://www.springframework.org/schema/aop/spring-aop.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx.xsd">
<!--    Controller的组件扫描-->
    <context:component-scan base-package="com.zqh.controller"/>
</beans>

在配置好组件扫描文件后，最后要在web.xml文件配置SpringMVC前端控制器中，添加一个初始化。因为spring-mvc.xml是要给SpringMVC来使用的，SpringMVC负责去自动创建Controller注解下的类的对象。

6.测试即可

在地址中输入/quick，即可跳转到success页面。

7.此外

（1）注解

关于一些其他SpringMVC的注解,都写在之后

（2）关于服务器地址

例如，可以为整个类配置RequestMapping，（本例为/user）。那么再次访问/user/quick时，就要将return部分多加一个反斜杠。
因为：默认情况下（没有斜杠的情况），跳转的地址就是将尾部替换成跳转的地址。例如本文本来应该跳转http://localhost:8088/SpringMVC/quick，然后将quick替换成了success.jsp，其实就是请求转发，http://localhost:8088/SpringMVC/success.jsp

而如果是有斜杆的情况：斜杠，代表着根目录的地址，可以理解为配置tomcat后默认跳转的地址，即 http://localhost:8088/SpringMVC

（3）利用视图解析器简化return

在spring-xml文件中配置视图解析器，相当于自动给return的内容加上前缀后缀。

三.SpringMVC的数据响应

返回字符串的形式，即上文的return success，可以增加前缀、后缀，设置转发or重定向。这里不做重复解释。

3.1 通过ModelAndVieew对象返回

这里只演示最终版本：

3.2 通过ResponseBody注解直接返回字符串

若要返回json格式字符串：
先在pom.xml配置json坐标

然后再

3.3 返回对象和集合

这一步骤也不需要我们自己像上图一样配置xml文件，而是采用mvc的一个注解驱动：

四.SpringMVC请求数据

4.1 获得基本类型参数

然后访问quick9的时候，设置请求参数即可。关键在于，请求的参数与传入的形参名称要一致，SpringMVC才会自动映射匹配相应参数。http://localhost:8088/SpringMVC/user/quick9?username=%22cnm%22&age=18

但是也有可能遇到形参名称不一致的情况（比如传入的叫“name”而不是username），那么我们可以使用 @requestParam注解来完成映射：

4.2 获得POJO类型（对象、封装实体）参数

直接传入封装好的User，MVC底层会自动通过反射、set方法来注入参数

4.3 获得数组类型参数

http://localhost:8080/SpringMVC/quick11?strs=111&strs=222&strs=333

4.4 获得集合类型参数

集合类型参数。例如List<User>的List集合类，无法直接封装。

创建jsp文件：向vo对象中的每一个userList注入内容即可

不进行封装的方法：
当使用ajax提交时，可以指定contentType为json形式，那么在方法参数位置使用@RequestBody可以直接接收集合数据而无需使用POJO进行包装。当使用ajax提交时，可以指定contentType为json形式，那么在方法参数位置使用@RequestBody可以直接接收集合数据而无需使用POJO进行包装。

4.5 获取Restful风格参数

Restful风格，含义就是：原本我们在网页地址发送请求参数要使用 ?usernam="dadad"&...&..这样的格式，现在替换为更简洁更有层次的方法，直接在后面加参数内容即可：

使用@PathVariable注解，通过SpringMVC来获取参数：

4.6文件上传

文件上传客户端3要素：
表单项type=“file”、表单的提交方式是post、表单的enctype属性是多部分表单形式，及enctype=“multipart/form-data”

步骤一：由于表单文件的上传时，请求正文的内容变为多部分内容，底层是通过fileupload实现的，因此要先导入坐标：

<!--    导入fileupload和io坐标-->
    <dependency>
      <groupId>commons-fileupload</groupId>
      <artifactId>commons-fileupload</artifactId>
      <version>1.2.2</version>
    </dependency>
    <dependency>
      <groupId>commons-io</groupId>
      <artifactId>commons-io</artifactId>
      <version>2.4</version>
    </dependency>

步骤二：在spring-MVC配置文件中配置文件上传解析器

<bean id="multipartResolver" 
class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<!--上传文件总大小-->
<property name="maxUploadSize" value="5242800"/>
<!--上传单个文件的大小-->
<property name="maxUploadSizePerFile" value="5242800"/>
<!--上传文件的编码类型-->
<property name="defaultEncoding" value="UTF-8"/>
</bean>

步骤三：编写文件上传代码
注意，这里传入的参数name和uploadFile，要与上传表单的name属性一致，springmvc才可以实现自动映射。

@RequestMapping("/quick20")
@ResponseBody
public void quickMethod20(String name,MultipartFile uploadFile) throws 
IOException {
//获得文件名称
String originalFilename = uploadFile.getOriginalFilename();
//保存文件
uploadFile.transferTo(new File("C:\\upload\\"+originalFilename));
}

五. SpringMVC拦截器（Interceptor）

springMVC的拦截器其实类似于Servlet中的过滤器Filter，作用是对处理器进行预处理和后处理。只有使用了 SpringMVC 框架的工程才能用Interceptor。

5.1 快速入门

步骤1：创建目标资源和对应返回的jsp页面

步骤2：在com.zqh下创建拦截器类实现HandlerInterceptor接口。此接口有三个方法，其含义顾名思义即可。

public class MyHandlerInterceptor1 implements HandlerInterceptor {
public boolean preHandle(HttpServletRequest request, HttpServletResponse 
response, Object handler) {
//在目标方法之前执行
System.out.println("preHandle running...");
return true;
}
public void postHandle(HttpServletRequest request, HttpServletResponse 
response, Object handler, ModelAndView modelAndView) {
//在目标方法之后、返回视图之前执行
System.out.println("postHandle running...");
}
public void afterCompletion(HttpServletRequest request, HttpServletResponse 
response, Object handler, Exception ex) {
//流程执行完毕后执行
System.out.println("afterCompletion running...");
}
}

步骤3：配置拦截器

<!--配置拦截器-->
<mvc:interceptors>
    <mvc:interceptor>
        <!--下面这行表示对哪些资源执行拦截操作-->
        <mvc:mapping path="/**"/>

        <!--下面这行告诉SpringMVC拦截器是谁：MyHandlerInterceptor1-->
        <bean class="com.zqh.interceptor.MyHandlerInterceptor1"/>
    </mvc:interceptor>
</mvc:interceptors>

测试执行的顺序：