SpringBoot 返回视图

原创 已于 2024-07-13 08:00:28 修改 · 2.1k 阅读 · 3 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#spring boot #java #spring

于 2022-02-23 21:56:09 首次发布

SpringBoot下的Starter-web本身是没有支持模板引擎的，返回的页面也只能是静态资源，所以如果要将后台数据和页面一起返回需要增加模板引擎。

SpringBoot MVC静态资源设置

源码分析静态

通过对源代码WebMvcAutoConfiguration的解析，发现SpringBoot MVC默认的资源目录是这四个，如果不指定静态资源就需要创建这四个目录。因为默认编译会将工程resources下的文件和目录编译到target\classes，所以classpath相当于编译后的target\classes的目录。

"classpath:/META-INF/resources/",
"classpath:/resources/", 
"classpath:/static/", 
"classpath:/public/"

SpringBoot 返回视图，静态资源报404一般是未指定资源路径。可以是使用以下两种方式解决。

1.方式1-静态资源路径

spring:
  #  表示所有的访问都经过静态资源路径
  mvc:
    static-path-pattern: /**
  #  配置静态资源根路径
  resources:
    static-locations: classpath:/,classpath:/mystatic/

2.方式2-build生成资源

修改pom文件，编译时指定资源路径。

修改pom编译时指定资源的目标路径
    <build>
        <resources>
            <resource>
                <directory>src/main/resources</directory>
                <!--使用mvc默认的目录META-INF/resources-->
                <targetPath>META-INF/resources</targetPath>
                <includes>
                    <include>**/**</include>
                </includes>
                <filtering>false</filtering>
            </resource>
        </resources>
    </build>

3.方式3-自定义目录

自定义目录就是使用方式一和方式二组合

<build>
        <resources>
            <resource>
                <!--                设置将资源生成了class目录下-->
                <directory>src/main/webapp</directory>
                <targetPath>webapp</targetPath>
                <includes>
                    <include>**/**</include>
                </includes>
                <filtering>false</filtering>
            </resource>
            <!--            设置配置文件（application.yml）的生成，如果不设置就不会编译到class目录-->
            <resource>
                <directory>src/main/resources</directory>
                <targetPath>/</targetPath>
                <includes>
                    <include>**/**</include>
                </includes>
                <filtering>false</filtering>
            </resource>
        </resources>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

application.yml

spring:
  #  表示所有的访问都经过静态资源路径
  mvc:
    static-path-pattern: /**
  #  配置静态资源根路径
  resources:
    static-locations: classpath:/webapp,classpath:/webapp/mystatic/
  thymeleaf:
    prefix: classpath:/webapp/templates/

 编译生成后的目录结构：

模板引擎

除了REST Web服务之外，还可以使用Spring MVC来服务动态HTML内容。Spring MVC支持多种模板技术，包括Thymeleaf，FreeMarker，Groovy，Muslache和JSP。此外，许多其他模板引擎包括它们自己的Spring MVC集成。

1.JSP模板：

JSP限制：当运行使用嵌入的servlet容器的Spring Boot应用程序（并打包为可执行文件）时，JSP支持中存在一些限制。

  1. 有了Tomcat，如果你使用war包装，它应该可以工作。 也就是说，一个可执行的war工作，也可以部署到一个标准的容器（不限于，但包括Tomcat）。 由于Tomcat中的硬编码文件模式，可执行jar无法使用。
  2. 使用Jetty，如果您使用war包装，它应该可以工作。 也就是说，一个可执行的jar有效，并且也可以部署到任何标准容器。
  3. Undertow不支持JSP。
  4. 创建自定义error.jsp页面不会覆盖错误处理的默认视图。 应该使用自定义错误页面。

 1.添加JSP支持的依赖

   <dependencies>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <version>2.5.0</version>
        </dependency>

        <!--JSP模板引擎-->
        <dependency>
            <groupId>org.apache.tomcat.embed</groupId>
            <artifactId>tomcat-embed-jasper</artifactId>
            <version>9.0.46</version>
        </dependency>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>jstl</artifactId>
            <version>1.2</version>
        </dependency>
    </dependencies>

2.返回视图的控制器

@Controller
@Slf4j
public class ViewController {

    /**
     * 不能直接放回静态资源，返回视图报错500（ModelAndView）---返回报错
     * 通过转发返回
     *
     * @return
     */
    @GetMapping("/")
    public void index(HttpServletResponse servletResponse) throws IOException {
        servletResponse.sendRedirect("/static/test.html");
    }

    @GetMapping("/viewmodel")
    public ModelAndView viewModel() {
        log.info("viewModel Start");
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.setViewName("viewmodel");
        modelAndView.addObject("message", "back end;无js");
        return modelAndView;
    }

    @GetMapping("/viewmodeljs")
    public ModelAndView viewModelJS() {
        log.info("viewmodelJS Start");
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.setViewName("viewmodeljs");
        modelAndView.addObject("message", "back end;js测试");
        return modelAndView;
    }
}

3.jsp视图

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
	<head>
		<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
		<title>viewmodel</title>
	</head>
	<body>
		<h1>hello ${message}</h1>
	</body>
</html>


###############或者#####################
<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
	<head>
		<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
		<title>viewmodel-js</title>
		<script src="../static/viewmodeljs.js" type="text/javascript"></script>
	</head>
	<body>
		<h1>hello ${message}</h1>
		<input onclick="onclickbtn()" type="button" value="button"/>
	</body>
</html>

4.修改application.yml

 指定spring.mvc匹配的资源前缀和后缀，如果不指定就需要在controller指定绝地路径和视图的后缀。

#返回的前缀，通过编译时指定资源路径
spring:
  mvc:
    view:
      prefix: /pages/
      #返回的后缀
      suffix: .jsp

5.pom文件build节点

这一步指定build将jsp资源编译到resources目录，如果不指定将会404错误。

 <build>
        <resources>
            <resource>
                <directory>src/main/mywebapp</directory>
                <!--这里必须是META-INF/resources-->
                <targetPath>META-INF/resources</targetPath>
                <includes>
                    <include>**/**</include>
                </includes>
                <filtering>false</filtering>
            </resource>
        </resources>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

6.启动调试 

编译生成:

访问http://localhost:8080/viewmodeljs

2.thymeleaf模板

thymeleaf修饰的页面一般是thymeleaf默认在resources-》templates目录下作为前缀，表示被thymeleaf修饰的页面在这里作为根目录。（注意：templates 目录并不是静态资源目录，它是一个放页面模板的位置（你看到的 Thymeleaf 模板虽然后缀为 .html，其实并不是静态资源））

 1.修改pom增加依赖

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <version>2.5.0</version>
        </dependency>

        <!--        thymeleaf 模板引擎-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
            <version>2.5.0</version>
        </dependency>
    </dependencies>

2.创建页面

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>viewmodel</title>
    <script src="../mystatic/js/viewmodeljs.js"></script>
</head>
<body>
<div>
    <h1 th:text="${message}"></h1>
    <input value="button" type="button" onclick="onclickbtn()"/>
</div>
</body>
</html>

3.创建controller

@Controller
@Slf4j
public class ViewController {

    /**
     * 不能直接放回静态资源，返回视图报错500（ModelAndView）---返回报错
     * 通过转发返回
     *
     * @return
     */
    @GetMapping("/")
    public void index(HttpServletResponse servletResponse) throws IOException {
        servletResponse.sendRedirect("/test.html");
    }

    @GetMapping("/viewmodel")
    public ModelAndView viewModel() {
        log.info("viewModel Start");
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.setViewName("viewmodel");
        modelAndView.addObject("message", "back end;无js");
        return modelAndView;
    }

    @GetMapping("/viewmodeljs")
    public ModelAndView viewModelJS() {
        log.info("viewmodelJS Start");
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.setViewName("viewmodeljs");
        modelAndView.addObject("message", "back end;js测试");
        return modelAndView;
    }
}

4.修改自定义静态资源路径和自定义模板位置

resources：（Spring Boot 默认的）存放资源文件
static：（Spring Boot 默认的）存放静态文件，比如 css、js、image, （访问方式 http://localhost:8080/js/main.js）
public：（Spring Boot 默认的）存放公共文件

spring:
  #  表示所有的访问都经过静态资源路径
  mvc:
    static-path-pattern: /**
  #  配置静态资源根路径
  resources:
    static-locations: classpath:/,classpath:/mystatic/
  #  作为前缀，表示被thymeleaf修饰的页面在这里作为根目录(不是静态资源）
  #  默认配置只能设置一个thymeleaf模板位置，所以需要配置多个模板位置的时候就需要自行定义模板解析
  thymeleaf:
    prefix: classpath:/templates/
    #    这里表示以.html作为后缀
#    suffix: .html
#    #关闭缓存
#    cache: false

5.启动调试

访问http://localhost:8080/viewmodeljs

SpringBoot 整合视图View
qq_16183731的博客
03-17 2069
SpringBoot 整合JSP @Controller public class UserController { /* * 处理请求，产生数据 */ @RequestMapping(&amp;quot;/showUser&amp;quot;) public String showUser(Model model){ List&amp;amp;lt;Users&amp;amp;gt; list = new ArrayList&a
Springboot视图解析与模板引擎
Java硬件工程师的博客
07-21 714
1.视图解析 视图解析：SpringBoot默认不支持 JSP，需要引入第三方模板引擎技术实现页面渲染。 视图解析原理流程 1.目标方法处理的过程中，所有数据都会被放在 ModelAndViewContainer 里面。包括数据和视图地址 2.方法的参数是一个自定义类型对象（从请求参数中确定的），把把重新放在 ModelAndViewContainer 3.任何目标方法执行完成以后都会返回 ModelAndView（数据和视图地址） 4.processDispatchResult 处理派发结果（页面如何响
SpringBoot使用JSP作为视图模板的方法
10-18
主要介绍了SpringBoot使用JSP作为视图模板的方法，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
Spring boot返回视图的方式
c_universe的博客
08-23 2008
一、Spring boot返回视图的方式 1.使用ModelAndView 在controller中 @RequestMapping("toTest") public ModelAndView toTest(){ ModelAndView mv = new ModelAndView(); //视图名 mv.setViewName("login"); //想传的数据 mv.addObject("o1","数据1")
springboot返回视图
xiaozhuangyumaotao的博客
05-10 1233
上篇文章我新建了第一个springboot程序，并通过访问http://localhost:8080/getUsers返回一个字符串成功了，因为我在getUsers()方法上加了@ResponseBody注解，这里返回的字符串的MIME类型其实是application/json，如果我现在写一个如下方法，这个方法上并没有加@ResponseBody注解，如下： @RequestMapping("/toAdd") publicStringtoAdd(){ return"toAdd"; }...
SpringBoot 如何返回页面
张紫娃的博客
01-06 3832
/
SpringBoot返回html页面
weixin_30446613的博客
05-04 962
一般Controller返回数据或页面，今天谈一下返回页面的场景。 一.不使用template 1. controller中定义对应的访问路由及返回的页面(使用Controller，不要使用RestController)，如： @GetMapping("/hello") public String test2() { return "hello"; } 2.在Spri...
Springboot视图解析器ViewResolver使用实例
08-19
Springboot视图解析器ViewResolver使用实例详解 Springboot作为一个基于Java的Web框架，提供了强大的视图解析器ViewResolver机制，用于将逻辑视图名解析为物理视图。ViewResolver是SpringMVC提供的一个重要组件，...
springboot 返回给前端不必要的字段如何处理
12-14
2. `@JsonView`注解：如果你的API需要服务于不同类型的客户端，可以定义不同的视图（Views），并在序列化时指定要使用的视图，以控制哪些字段应被包含。 3. 自定义`JsonSerializer`和`JsonDeserializer`：当标准的...
Java进阶SpringBoot视图技术共12页.pdf
11-20
【Java进阶SpringBoot视图技术】是针对Java开发者深入学习SpringBoot框架中视图处理技术的教程。SpringBoot简化了传统Spring应用的初始化和配置，使得开发更加高效。本教程共12页，旨在帮助开发者掌握SpringBoot在...
springboot与返回视图
qq_23490959的博客
08-06 697
1.使用jsp返回 application.properties ############## OAuth ################ server.port=8082 #jsp path spring.view.prefix=/WEB-INF/page/ spring.view.suffix=.jsp 依赖包 &lt;dependency&gt; &lt;groupId&g...
springboot 插入返回id_springboot返回modelandview页面的实例
weixin_39958631的博客
12-21 516
1、添加依赖这个应该是web项目相关的jarorg.springframework.bootspring-boot-starter-webjavax.servletjstl1.2org.apache.tomcat.embedtomcat-embed-jasperprovided2、application.propertiesorg.springframework.bootspring-boot-s...
springboot返回modelandview页面
热门推荐
fuck487的博客
02-09 3万+
1、添加依赖 这个应该是web项目相关的jar org.springframework.boot spring-boot-starter-web javax.servlet jstl 1.2 org.apache.tomcat.embed tomcat-embed-jasper
SpringBoot之返回页面视图&JSON
VR_dancy的博客
12-26 786
https://blog.youkuaiyun.com/zt_fucker/article/details/59508380
springBoot返回视图与参数
qq_34357018的博客
10-16 1783
在web项目中，controller的返回值一般有两种，一种是返回对应的页面（例如html页面，jsp页面），一种是返回数据（例如json格式的数据）。 使用@Controller注解，返回视图与参数 @Controller public class UserController { @Resource private IUserService userService; @RequestMapping("/userLogin") public String use
springboot返回视图错误
hayaqi0504的博客
03-20 942
Circular view path [faults]: would dispatch back to the current handler URL [/pulsar/faults] again@RequestMapping(value = "/getimage", method = RequestMethod.GET,produces={"application/json;charset-8"...
访问spring boot 接口返回一个view，显示相关提示信息
花花鱼的专栏
05-27 488
访问spring boot 接口返回一个view，显示相关提示信息
springboot输出流到页面_SpringBoot如何返回页面
weixin_39791386的博客
12-22 2143
SpringBoot中使用Controller和页面的结合能够很好地实现用户的功能及页面数据的传递。但是在返回页面的时候竟然会出现404或者500的错误，我总结了一下如何实现页面的返回以及这里面所包含的坑。SpringBoot中对Thymeleaf的集成已经基本完善，但在特殊情况下，并不需要或者不能使用Thymeleaf，所以分成两种情况对页面的返回进行阐述。首先说一下这两种情况下都会发生的错误，...
springboot配置视图解析器
最新发布
09-13
<think> 首先，用户的问题是关于Spring Boot如何配置视图解析器的。我需要参考提供的站内引用来构建回答。 回顾引用内容： - **引用[1]**: 解释了手动配置和Spring Boot自动配置视图解析器的区别。提到了手动配置适用于非Spring Boot项目或深度定制，而Spring Boot自动配置简化了集成。 - **引用[2]**: 展示了在Spring Boot配置类中配置InternalResourceViewResolver的代码示例。 - **引用[3]**: 展示了使用WebMvcConfigurerAdapter来配置视图控制器，控制跳转页面。 - **引用[4]**: 展示了XmlViewResolver的配置示例，但这是在XML中配置的。 - **引用[5]**: 讨论了配置视图解析器时可能导致404错误的问题，并提供了解决方法，比如注册webapp目录作为资源目录。 用户的核心问题是："springboot如何配置视图解析器"。我需要提供一个清晰的、结构化的回答，引导用户逐步配置。 根据系统指令： - 使用中文回答。 - 回答结构清晰，帮助用户逐步解决问题。 - 引用内容时，在末尾添加引用标识，如[^1]。 - 生成相关问题（在"§§相关问题§§"部分）。 - 对于数学表达式，使用LaTeX格式，但这个问题似乎不涉及数学，所以可能不需要。 回答结构： 1. **介绍视图解析器**：简要解释视图解析器的作用。 2. **Spring Boot的自动配置**：基于引用[1]，说明Spring Boot如何自动配置常见的视图解析器（如Thymeleaf、Freemarker等）。 3. **手动配置视图解析器**：如果需要自定义，如何手动配置。参考引用[2]和引用[4]。 - 使用InternalResourceViewResolver（用于JSP）的示例（引用[2]）。 - 简要提到XmlViewResolver（引用[4]），但指出在Boot中可能不常用。 4. **配置视图控制器**：参考引用[3]，展示如何设置默认视图或重定向。 5. **常见问题和解决方案**：基于引用[5]，讨论配置错误如404问题，并提供修复建议。 6. **总结**：对比手动和自动配置，根据场景推荐。 最后，添加"§§相关问题§§"部分，生成相关问题。 确保引用： - 在相关段落末尾添加引用标识。 例如： - "Spring Boot会自动配置常见的视图解析器[^1]." - "可以手动配置InternalResourceViewResolver[^2]." 代码块：用户提供了代码示例，我应该引用它们。系统指令要求使用代码块展示代码。 在回答中： - 引用代码时，使用代码块格式。 - 确保LaTeX正确，但这里可能无数学。 相关问题建议： 1. 如何处理Spring Boot视图解析器配置错误？ 2. Spring Boot支持哪些视图技术？ 3. 如何自定义视图解析器行为？ 4. 视图解析器和视图控制器的区别是什么？ 基于引用内容生成。 </think> ### Spring Boot视图解析器配置方法 在Spring Boot应用中，视图解析器（ViewResolver）负责将控制器返回的逻辑视图名（如"home"）解析为具体的视图资源（如HTML、JSP文件）。Spring Boot通过自动配置简化了常见视图技术的集成，但也支持手动配置以满足定制需求。下面我将逐步解释配置方法，基于参考引用内容。 #### 1. **Spring Boot自动配置视图解析器** Spring Boot会根据项目依赖自动配置常见的视图解析器。例如，添加Thymeleaf或Freemarker starter依赖后，Boot会默认设置对应的视图解析器，无需手动配置。 - **步骤**: 1. 在`pom.xml`中添加视图技术的starter依赖（如Thymeleaf）： ```xml <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-thymeleaf</artifactId> </dependency> ``` 2. 视图文件默认放在`src/main/resources/templates`目录下（如`home.html`）。 3. 控制器中返回逻辑视图名： ```java @Controller public class HomeController { @GetMapping("/") public String home() { return "home"; // 自动解析为templates/home.html } } ``` - **优势**：Spring Boot自动处理前缀、后缀等约定，属性可通过`application.properties`定制（如`spring.thymeleaf.prefix=classpath:/custom/`）[^1]。 #### 2. **手动配置视图解析器** 如果需要深度定制（如使用JSP或其他非标准视图），可以手动配置视图解析器。以下是两种常见方式： - **方式一：配置InternalResourceViewResolver（用于JSP）** 参考引用[2]，在自定义配置类中使用`@Bean`定义： ```java package com.stu.config; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.web.servlet.ViewResolver; import org.springframework.web.servlet.view.InternalResourceViewResolver; @Configuration public class MvcConfig { @Bean public ViewResolver internalResourceViewResolver() { InternalResourceViewResolver resolver = new InternalResourceViewResolver(); resolver.setPrefix("/WEB-INF/views/"); // 视图文件前缀 resolver.setSuffix(".jsp"); // 视图文件后缀 return resolver; } } ``` - **注意事项**：确保视图文件路径正确（如将JSP文件放在`src/main/webapp/WEB-INF/views/`目录下）。如果出现404错误，需注册`webapp`目录为资源目录（见常见问题部分）[^2][^5]。 - **方式二：配置视图控制器（简化视图跳转）** 参考引用[3]，使用`WebMvcConfigurer`设置默认视图或重定向： ```java package com.boot.zhiyi.config; import org.springframework.context.annotation.Configuration; import org.springframework.core.Ordered; import org.springframework.web.servlet.config.annotation.ViewControllerRegistry; import org.springframework.web.servlet.config.annotation.WebMvcConfigurer; @Configuration public class ViewConfig implements WebMvcConfigurer { @Override public void addViewControllers(ViewControllerRegistry registry) { registry.addViewController("/").setViewName("forward:/html/login.html"); // 设置根路径跳转 registry.setOrder(Ordered.HIGHEST_PRECEDENCE); // 设置优先级 } } ``` - **适用场景**：适合单纯重定向或设置默认入口视图，无需控制器逻辑[^3]。 - **其他视图解析器（如XmlViewResolver）** 引用[4]展示了传统XML配置，但在Spring Boot中推荐使用Java配置。如果需要类似功能，可定义`BeanNameViewResolver`或自定义解析器，不建议直接使用XML[^4]。 #### 3. **常见问题与解决方案** - **404错误（视图文件未找到）**： - **原因**：视图文件路径未正确注册。 - **修复**：在`pom.xml`中添加资源目录配置（引用[5]）： ```xml <build> <resources> <resource> <directory>src/main/webapp</directory> <!-- 注册webapp目录 --> <targetPath>META-INF/resources</targetPath> <includes> <include>**/*.*</include> </includes> </resource> </resources> </build> ``` 确保视图文件路径与`setPrefix()`匹配[^5]。 #### 4. **总结与推荐** - **自动配置**：默认推荐，适用于常见视图技术（Thymeleaf、Freemarker）。添加starter依赖后，Boot自动处理解析器，通过属性文件定制简单参数[^1]。 - **手动配置**：适用于JSP、深度定制或非标准需求。使用`InternalResourceViewResolver`或视图控制器，确保资源路径正确[^2][^3]。 - **选择建议**：优先使用自动配置；如需定制视图路径或处理特殊场景，再引入手动配置。
评论 1
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值