SpringMVC 框架核心知识点详解与实战


引言

SpringMVC 是 Spring 框架中用于构建 Web 应用程序的模块,它基于 MVC(Model-View-Controller)设计模式,能够高效地处理 Web 请求并返回响应。本文将深入探讨 SpringMVC 框架的核心功能,包括响应数据与结果视图、文件上传、异常处理以及拦截器的使用,并结合详细的代码示例进行讲解。


一、响应数据和结果视图

1.1 开发环境搭建

在使用 SpringMVC 前,需要通过 Maven 引入相关依赖,包括 Spring 核心上下文、Web 模块和 WebMVC 模块,同时还需添加 Servlet 和 JSP 相关依赖。


<properties>
    <spring.version>5.0.2.RELEASE</spring.version>
</properties>
<dependencies>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-web</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>servlet-api</artifactId>
        <version>2.5</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>javax.servlet.jsp</groupId>
        <artifactId>jsp-api</artifactId>
        <version>2.0</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

同时,在web.xml中配置前端控制器DispatcherServlet和字符编码过滤器,确保请求能够正确分发和处理中文乱码问题。

<filter>
    <filter-name>characterEncodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>characterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

<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>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>dispatcherServlet</servlet-name>
    <url-pattern>*.do</url-pattern>
</servlet-mapping>

在springmvc.xml中配置注解扫描、视图解析器和启用注解驱动,完成基础环境搭建。

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:context="http://www.springframework.org/schema/context"
       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
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context.xsd">

    <context:component-scan base-package="com.qcbyjy" />

    <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/pages/" />
        <property name="suffix" value=".jsp" />
    </bean>

    <mvc:annotation-driven/>
</beans>

1.2 返回值类型

返回 String:Controller 方法返回字符串时,该字符串会被视为逻辑视图名,结合视图解析器转换为物理视图地址。例如:

@Controller
@RequestMapping("/user")
public class UserController {
    @RequestMapping("/save1.do")
    public String save1(){
        System.out.println("执行了...");
        return "suc";
    }
}

返回 void:若返回值为void,默认不会进行视图解析,可能会导致 404 异常。可通过请求转发或直接输出响应内容的方式进行处理。

@RequestMapping("/save2.do")
public void save2(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    System.out.println("执行了...");
    response.getWriter().print("hello");
}

返回 ModelAndView:ModelAndView对象可同时携带数据和指定视图名称,实现数据与视图的统一管理。

@RequestMapping("/save3.do")
public ModelAndView save3(){
    System.out.println("执行了...");
    ModelAndView mv = new ModelAndView();
    mv.addObject("msg","用户名或者密码已经存在");
    mv.setViewName("suc");
    return mv;
}

1.3 转发与重定向

通过在返回的字符串中添加forward:或redirect:前缀,可实现请求转发和重定向。

@RequestMapping("/save4.do")
public String save4(){
    System.out.println("执行了...");
    return "forward:/pages/suc.jsp";
}

@RequestMapping("/save5.do")
public String save5(){
    System.out.println("执行了...");
    return "redirect:/pages/suc.jsp";
}

1.4 响应 json 数据

引入 Jackson 相关依赖后,使用@ResponseBody注解可将 Java 对象自动转换为 JSON 格式并返回。

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.9.0</version>
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-core</artifactId>
    <version>2.9.0</version>
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-annotations</artifactId>
    <version>2.9.0</version>
</dependency>
@RequestMapping("/save6.do")
public @ResponseBody User save6(@RequestBody User user){
    System.out.println(user);
    user.setUsername("hello");
    user.setAge(100);
    return user;
}

1.5 静态资源处理

为避免DispatcherServlet拦截静态资源,可在springmvc.xml中配置静态资源映射。

<mvc:resources location="/css/" mapping="/css/**"/>
<mvc:resources location="/images/" mapping="/images/**"/>
<mvc:resources location="/js/" mapping="/js/**"/>

二、SpringMVC 实现文件上传

2.1 准备工作

导入commons-fileupload和commons-io依赖,用于处理文件上传操作。

<dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.3.1</version>
</dependency>
<dependency>
    <groupId>commons-io</groupId>
    <artifactId>commons-io</artifactId>
    <version>2.4</version>
</dependency>

编写文件上传的 JSP 页面,设置enctype="multipart/form-data"属性。

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>文件上传</title>
</head>
<body>
    <h3>文件上传</h3>
    <form action="/fileupload.do" method="post" enctype="multipart/form-data">
        选择文件:<input type="file" name="upload" /><br/>
        <input type="submit" value="上传" />
    </form>
</body>
</html>

2.2 传统方式文件上传

在springmvc.xml中配置文件上传解析器,并设置上传文件的最大大小。

<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <property name="maxUploadSize" value="8388608" />
</bean>

在 Controller 中使用MultipartFile对象接收上传文件,并实现文件保存逻辑。

@Controller
public class UploadController {
    @RequestMapping("/fileupload.do")
    public String upload(MultipartFile upload, HttpServletRequest request) throws IOException {
        String realPath = request.getSession().getServletContext().getRealPath("/uploads");
        File file = new File(realPath);
        if(!file.exists()){
            file.mkdirs();
        }
        String filename = upload.getOriginalFilename();
        String uuid = UUID.randomUUID().toString().replace("-", "").toUpperCase();
        filename = uuid+"_"+filename;
        upload.transferTo(new File(file,filename));
        return "suc";
    }
}

三、SpringMVC 的异常处理

3.1 异常处理思路

Controller 调用 service,service 调用 dao 时,异常会向上抛出,最终由DispatcherServlet找到异常处理器进行处理。

3.2 实现异常处理

定义自定义异常类SysException,用于封装特定的异常信息。

public class SysException extends Exception{
    private String message;
    @Override
    public String getMessage() {
        return message;
    }
    public void setMessage(String message) {
        this.message = message;
    }
    public SysException(String message) {
        this.message = message;
    }
}

创建自定义异常处理器SysExceptionResolver,实现HandlerExceptionResolver接口,根据异常类型进行相应处理。

public class SysExceptionResolver implements HandlerExceptionResolver {
    @Override
    public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object o, Exception e) {
        e.printStackTrace();
        SysException exception = null;
        if(e instanceof SysException){
            exception = (SysException)e;
        }else{
            exception = new SysException("系统正在维护,请联系管理员");
        }
        ModelAndView mv = new ModelAndView();
        mv.addObject("errorMsg",exception.getMessage());
        mv.setViewName("error");
        return mv;
    }
}

在springmvc.xml中配置异常处理器。

<bean id="sysExceptionResolver" class="cn.tx.demo3.SysExceptionResolver" />

在 Controller 中模拟异常抛出,触发异常处理流程。

@Controller
@RequestMapping("/role")
public class RoleController {
    @RequestMapping("/findAll.do")
    public String findAll(){
        System.out.println("执行了...");
        int a = 10/0;
        return "suc";
    }
}

四、SpringMVC 框架中的拦截器

4.1 拦截器概述

拦截器用于对处理器进行预处理和后处理,与过滤器功能类似,但拦截器是 SpringMVC 框架独有的,且只会对控制器中的方法进行拦截,是 AOP 思想的一种实现方式。

4.2 自定义拦截器

创建实现HandlerInterceptor接口的拦截器类,重写preHandle、postHandle和afterCompletion方法。

public class MyInterceptor2 implements HandlerInterceptor{
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("拦截器preHandle方法执行了...");
        return true;
    }
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("postHandle方法执行了...");
    }
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("afterCompletion方法执行了...");
    }
}

在springmvc.xml中配置拦截器,指定拦截路径。

<mvc:interceptors>
    <mvc:interceptor>
        <mvc:mapping path="/dept/**"/>
        <bean class="cn.tx.demo4.MyInterceptor2" />
    </mvc:interceptor>
</mvc:interceptors>

4.3 多个拦截器配置

配置多个拦截器时,可通过mvc:interceptor标签依次定义,拦截器的执行顺序与配置顺序一致。

<mvc:interceptors>
    <mvc:interceptor>
        <mvc:mapping path="/dept/**"/>
        <bean class="cn.tx.demo4.MyInterceptor2" />
    </mvc:interceptor>
    <mvc:interceptor>
        <mvc:mapping path="/**"/>
        <bean class="cn.tx.demo4.MyInterceptor3" />
    </mvc:interceptor>
</mvc:interceptors>

多个拦截器执行顺序

  • preHandle 方法的执行:当一个请求进入 SpringMVC 框架并找到对应的处理器(Controller 方法)后,会先调用 Interceptor1 的 preHandle 方法,然后再调用 Interceptor2 的 preHandle 方法,即按照拦截器在配置文件中配置的顺序依次执行它们的 preHandle 方法。如果其中某个拦截器的 preHandle 方法返回 false,则后续拦截器的 preHandle 方法以及处理器都不会被执行。
  • postHandle 方法的执行:在处理器(Controller 方法)执行完成后,视图渲染之前,会先调用 Interceptor2 的 postHandle 方法,然后再调用 Interceptor1 的 postHandle 方法。也就是说,postHandle 方法的执行顺序与拦截器的配置顺序相反。这是因为 Interceptor2 是后配置的,它更接近处理器的执行,所以在处理器执行完后,先从它开始逆向执行 postHandle 方法。
  • afterCompletion 方法的执行:在视图渲染完成后,会先调用 Interceptor2 的 afterCompletion 方法,然后再调用 Interceptor1 的 afterCompletion 方法。同样,afterCompletion 方法也是按照与配置顺序相反的顺序执行的。这是为了保证在整个请求处理流程结束后,按照与拦截器介入时相反的顺序进行一些资源清理、状态恢复等操作。

在这里插入图片描述

4.4过滤器与拦截器的区别

对比项过滤器(Filter)拦截器(Interceptor)
所属规范Servlet 规范的一部分SpringMVC 框架特有
作用范围处理 Servlet 容器所有请求和响应,含静态和动态资源仅针对 SpringMVC 控制器方法
初始化Servlet 容器启动时初始化SpringMVC 容器初始化时加载
执行顺序按 web.xml 配置顺序依次执行,响应反向按配置顺序执行 preHandle,postHandle 和 afterCompletion 逆序
核心方法init()、doFilter()、destroy()preHandle()、postHandle()、afterCompletion()
应用场景通用 Web 请求处理,如编码、权限、日志等SpringMVC 业务流程处理,如数据加工、性能监控等
技术实现实现 javax.servlet.Filter 接口,web.xml 或注解配置实现 org.springframework.web.servlet.HandlerInterceptor 接口,SpringMVC 配置文件配置

总结

本文全面介绍了 SpringMVC 框架的核心功能,从响应数据和结果视图的处理,到文件上传、异常处理以及拦截器的使用,通过详细的代码示例展示了各功能的实现方式。这些知识点是构建高效、稳定的 SpringMVC Web 应用的基础,熟练掌握它们有助于开发者更好地应对实际项目中的各种需求。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值