springmvc简单使用案例（二）

最新推荐文章于 2025-12-05 17:02:52 发布

原创最新推荐文章于 2025-12-05 17:02:52 发布 · 543 阅读

21 ·

CC 4.0 BY-SA版权

文章标签：

#java #servlet #开发语言 #1024程序员节

java 专栏收录该内容

15 篇文章

订阅专栏

Spring MVC支持的常见视图

常用视图

1. JSP 视图（最常用）

说明：基于 JSP（JavaServer Pages）的视图，通过 JSP 页面中的 EL 表达式、JSTL 标签等渲染模型数据。
配置：需在 Spring 配置文件中配置 InternalResourceViewResolver 解析 JSP 视图，指定前缀（JSP 路径）和后缀（.jsp）。
示例：

<!-- 配置JSP视图解析器 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <property name="prefix" value="/WEB-INF/views/"/> <!-- JSP文件存放路径 -->
    <property name="suffix" value=".jsp"/> <!-- 视图名后缀 -->
</bean>

控制器返回逻辑视图名 success 时，会被解析为 /WEB-INF/views/success.jsp。

2. Thymeleaf 视图

说明：现代服务器端 Java 模板引擎，支持 HTML5 标准，无需依赖 Servlet 容器，可在前后端分离中使用（静态 HTML 也能渲染数据）。
特点：自然模板（模板即原型）、开箱即用的 Spring 集成、支持国际化和主题。
配置：需引入 Thymeleaf 依赖，并配置 ThymeleafViewResolver。
示例：

引入依赖

<!-- Thymeleaf 与 Spring MVC 集成 -->
<dependency>
    <groupId>org.thymeleaf</groupId>
    <artifactId>thymeleaf-spring6</artifactId> <!-- 注意版本对应：Spring 6 用 spring6，Spring 5 用 spring5 -->
    <version>3.1.2.RELEASE</version>
</dependency>

配置 Thymeleaf 模板解析器

<!-- 配置 Thymeleaf 模板解析器 -->
<bean id="templateResolver" class="org.thymeleaf.spring6.templateresolver.SpringResourceTemplateResolver">
    <property name="prefix" value="/WEB-INF/templates/" /> <!-- 模板文件存放路径 -->
    <property name="suffix" value=".html" /> <!-- 模板文件后缀（默认.html） -->
    <property name="templateMode" value="HTML5" /> <!-- 模板模式（HTML5/XML等） -->
    <property name="characterEncoding" value="UTF-8" /> <!-- 编码格式 -->
    <property name="cacheable" value="false" /> <!-- 开发环境关闭缓存（生产环境建议开启） -->
</bean>

示例：

<!-- Thymeleaf模板页面（success.html） -->
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<body>
    <h1 th:text="${msg}">默认消息</h1> <!-- 渲染模型中的msg数据 -->
</body>
</html>

3. JSON 视图

说明：直接返回 JSON 格式数据（无页面渲染），常用于 AJAX 请求或前后端分离架构。
实现方式：
- 使用 @ResponseBody 注解：直接将控制器方法返回的对象转换为 JSON（需依赖 Jackson 等 JSON 解析库）。
- 示例：

@GetMapping("/user")
@ResponseBody // 返回JSON
public User getUser() {
    return new User("张三", 20); // 自动转为{"username":"张三","age":20}
}

4.Redirect 重定向视图

说明：不是具体的视图文件，而是通过 HTTP 重定向跳转至其他 URL（客户端跳转，地址栏会变化）。
使用方式：控制器方法返回以 redirect: 为前缀的字符串。

@GetMapping("/redirect")
public String redirect() {
    return "redirect:/index.jsp"; // 重定向到index.jsp
    // 或重定向到其他控制器：return "redirect:/user/list";
}

5.Forward 转发视图

说明：通过服务器内部转发跳转至其他资源（服务器端跳转，地址栏不变）。
使用方式：控制器方法返回以 forward: 为前缀的字符串。

@GetMapping("/forward")
public String forward() {
    return "forward:/WEB-INF/views/detail.jsp"; // 转发到detail.jsp
    // 或转发到其他控制器：return "forward:/user/detail";
}

实现视图机制的核心

实现视图的核心类与接口包括：

DispatcherServlet类（前端控制器）：

职责：在整个Spring MVC执行流程中，负责中央调度。
核心方法：doDispatch

ViewResolver接口（视图解析器）：

职责：负责将逻辑视图名转换为物理视图名，最终创建View接口的实现类，即视图实现类对象。
核心方法：resolveViewName

View接口（视图）:

职责：负责将模型数据Model渲染为视图格式（HTML代码），并最终将生成的视图（HTML代码）输出到客户端。（它负责将模板语言转换成HTML代码）
核心方法：render

ViewResolverRegistry（视图解析器注册器）：
1. 负责在web容器（Tomcat）启动的时候，完成视图解析器的注册。如果有多个视图解析器，会将视图解析器对象按照order的配置放入List集合。

原理描述：

假设我们使用的是jsp视图：

第一步：浏览器发送请求给web服务器

第二步：Spring MVC中的DispatcherServlet接收到请求
第三步：DispatcherServlet根据请求路径分发到各自对应的Controller
第四步：DispatcherServlet调用相应Controller的方法
第五步：Controller的方法处理业务并返回一个逻辑视图名（底层返回的是ModelAndView mv对象）给DispatcherServlet
第六步：DispatcherServlet调用InternalResourceViewResolver的resolveViewName方法，将逻辑视图名转换为物理视图名，并创建InternalResourceView对象返回给DispatcherServlet
第七步：DispatcherServlet再调用InternalResourceView的render方法，render方法将模板语言转换为HTML代码，响应给浏览器，完成最终的渲染。

如果是别的视图也就是第六步和第七步不一样，就拿thymeleaf视图来说：

第六步：DispatcherServlet调用ThymeleafViewResolver的resolveViewName方法，将逻辑视图名转换为物理视图名，并创建ThymeleafView对象返回给DispatcherServlet
第七步：DispatcherServlet再调用ThymeleafView的render方法，render方法将模板语言（模板字符串）转换为HTML代码，响应给浏览器，完成最终的渲染。

总结：

实现视图的核心类和接口包括：ViewResolverRegistry、DispatcherServlet、ViewResolver、View
如果你想定制自己的视图组件：
- 编写类实现ViewResolver接口，实现resolveViewName方法，在该方法中完成逻辑视图名转换为物理视图名，并返回View对象。
- 编写类实现View接口，实现render方法，在该方法中将模板语言转换成HTML代码，并将HTML代码响应到浏览器。
如果Spring MVC框架中使用Thymeleaf作为视图技术。那么相关的类包括：
- ThymeleafView
- ThymeleafViewResolver

转发和重定向

回顾转发和重定向区别

转发 vs 重定向：

转发：1 次请求，地址栏不变。服务器内部跳转，不能跨域，可访问 WEB-INF 资源。代码：request.getRequestDispatcher ("/index").forward (request, response);
重定向：2 次请求，地址栏变化。浏览器重新请求，可跨域，不能访问 WEB-INF 资源。代码：response.sendRedirect ("/webapproot/index");

原理简化：

转发：浏览器发 1 次请求，服务器内部跳转资源，浏览器不知情。
重定向：浏览器发第 1 次请求后，服务器告诉浏览器新地址，浏览器再发第 2 次请求。

以上所描述的是使用原生Servlet API来完成转发和重定向。在Spring MVC中是如何转发和重定向的呢？

forward

在Spring MVC中默认就是转发的方式，我们之前所写的程序，都是转发的方式。只不过都是转发到Thymeleaf的模板文件xxx.html上。
那么，在Spring MVC中如何转发到另一个Controller上呢？可以使用Spring MVC的forward
代码实现如下：

package com.powernode.springmvc.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class IndexController {

    @RequestMapping("/a")
    public String toA(){
        return "forward:/b";
    }

    @RequestMapping("/b")
    public String toB(){
        // 返回的是一个逻辑视图名称
        return "b";
    }
}

视图页面：

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>b页面</title>
</head>
<body>
    <h1>我是b页面</h1>
</body>
</html>

redirect

redirect是专门完成重定向效果的。和forward语法类似，只需要将之前的 return "forward:/b"修改为 return "redirect:/b"即可。

package com.powernode.springmvc.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class IndexController {

    @RequestMapping("/a")
    public String toA(){
        // 这个使用较多。
        return "redirect:/b"; // 创建RedirectView
    }

    @RequestMapping("/b")
    public String toB(){
        return "b";
    }
}

视图页面：

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>b</title>
</head>
<body><h1>Page B!!!</h1></body>
</html>

<mvc:view-controller>

<mvc:view-controller> 是 Spring MVC 配置文件（如 spring-mvc.xml）中的一个标签，主要作用是简化 “无需业务逻辑处理，直接跳转页面” 的场景配置。

一般情况下，<mvc:view-controller> 配置可以替代一些没有业务逻辑的 Controller，例如首页、错误页面等。当用户访问配置的 URL 时，框架将直接匹配到对应的视图，而无需再经过其他控制器的处理。

<mvc:view-controller> 配置的格式如下：

<mvc:view-controller path="/如何访问该页面" view-name="对应的逻辑视图名称" />

其中：

path：被映射的 URL 路径。
view-name：对应的逻辑视图名称。

例如，配置首页的映射

<mvc:view-controller path="/" view-name="index" />

上述配置将会匹配上访问应用程序的根路径，如：http://localhost:8080/。当用户在浏览器中访问该根路径时，就会直接渲染名为 index 的视图。

<mvc:annotation-driven/>

<mvc:view-controller>是 Spring MVC 配置文件中用于启用注解驱动功能的核心标签，主要作用是自动注册一系列处理器适配器、处理器映射器等组件，让 Spring MVC 能够识别并处理基于注解的控制器（如 @Controller、@RequestMapping 等）。

在SpringMVC中，如果在springmvc.xml文件中配置了 <mvc:view-controller>，就需要同时在springmvc.xml文件中添加如下配置：

<mvc:annotation-driven/>

该配置的作用是：启用Spring MVC的注解。
如果没有以上的配置，Controller就无法访问到。访问之前的Controller会发生 404 问题。

访问静态资源

项目中通常会包含大量静态资源，如CSS、JS、图片等文件。由于DispatcherServlet的url-pattern配置为"/"，它将拦截除JSP请求外的所有请求，包括对静态资源的访问，这会导致404错误。要解决这个问题，有以下两种方案：

使用默认 Servlet 处理静态资源
使用 mvc:resources 标签配置静态资源处理

这两种方式都可以。自行选择。

使用默认Servlet处理静态资源

在springmvc.xml文件中添加以下配置，启用默认Servlet处理静态资源功能：

<!-- 开启注解驱动 -->
<mvc:annotation-driven />
<!--开启默认Servlet处理-->
<mvc:default-servlet-handler>

配置和静态资源目录如下：

成功访问静态资源

使用 mvc:resources 标签配置静态资源

要访问静态资源，可以在springmvc.xml配置文件中添加以下配置：

<!-- 开启注解驱动 -->
<mvc:annotation-driven />
<!-- 配置静态资源处理 -->
<mvc:resources mapping="/static/**" location="/static/" />

当请求路径以"/static/"开头时，系统会自动从"/static/"目录下查找对应资源。注意：使用<mvc:resources>配置前，需先启用注解驱动<mvc:annotation-driven />。

也是成功访问静态资源：