SpringBoot设置欢迎页的三种方式详解_Java

方式一：springboot对静态资源的自动映射（最基础）

springboot框架将欢迎页做了自动配置，不需要任何配置，只需在静态资源目录下添加index.jsp欢迎页即可。

1. 导入jquery‐webjar依赖

<!--引入jquery‐webjar 在访问的时候只需要写webjars下面资源的名称即可-->
<dependency>
    <groupid>org.webjars</groupid>
    <artifactid>jquery</artifactid>
    <version>3.3.1</version>
</dependency>

2. 在 src/main/resources/static/ 下新建一个 index.html

<!doctype html>
<html lang="en">
<head>
    <meta charset="utf-8">
    <title>title</title>
</head>
<body>
    <h2>springboot对静态资源的自动映射</h2>
    <p>springboot自动配置，在静态资源下查找index.html文件</p>
</body>
</html>

3. 访问当前项目的任何资源，都去（静态资源的文件夹）找映射

优先级：从高到低

# 任选其一
"classpath:/meta‐inf/resources/index.html",
"classpath:/resources/index.html",
"classpath:/static/index.html",
"classpath:/public/index.html"
"/"：当前项目的根路径

4. 适用场景：

纯静态的 html 页面，
不需要编写xml，
不需要后端传数据，
也不使用 thymeleaf 语法。

方式二：springboot-controller映射（最常用）

最常用的一种获取动态页面的方式，页面通常放在classpath:/templates/目录下（模板引擎默认目录）。

1. 在 src/main/resources/templates/ 下新建一个 index.html

<!doctype html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="utf-8">
    <title>title</title>
</head>
<body>
    <h2 th:text="${message}"></h2>
    <h2>且使用thymeleaf 模板引擎</h2>
</body>
</html>

2. 在controller层建一个java文件

package com.qcby.springbootwelcome.controller;

import org.springframework.stereotype.controller;
import org.springframework.ui.model;
import org.springframework.web.bind.annotation.requestmapping;

@controller
public class welcomecontroller {
    @requestmapping("/")
    public string welcomehello(model model){
        model.addattribute("message","springboot-controller映射");
        return "index";
    }
}

3. 访问路径：classpath:/templates/index.html

4. 适用场景：

使用 thymeleaf 模板引擎的动态页面
需要后端数据交互

方式三：webmvcconfigurer 配置类

1. 在 src/main/resources/templates/ 下新建一个 login.html

<!doctype html>
<html lang="en">
<head>
    <meta charset="utf-8">
    <title>title</title>
</head>
<body>
    <h2>登录页面</h2>
    <h3>适用 webmvcconfigurer 配置类</h3>
</body>
</html>

2. 创建webconfig配置类

package com.qcby.springbootwelcome.config;

import org.springframework.context.annotation.configuration;
import org.springframework.web.servlet.config.annotation.viewcontrollerregistry;
import org.springframework.web.servlet.config.annotation.webmvcconfigurer;

@configuration
public class webconfig implements webmvcconfigurer{
    @override
    public void addviewcontrollers(viewcontrollerregistry registry) {
        // 直接映射到静态页面
//        registry.addviewcontroller("/").setviewname("login.html");

        // 或者映射到模板引擎页面
         registry.addviewcontroller("/").setviewname("login");
    }
}

3. 访问路径：classpath:/templates/login.html

4. 适用场景：

使用 thymeleaf 模板引擎的动态页面
不需要后端传特定数据，仅仅是做路由跳

总结

这三种方式的优先级：springboot-controller映射 > webmvcconfigurer 配置类 > springboot对静态资源的自动映射

方法	适用场景	优点	缺点
静态资源默认	简单静态页面	无需配置	功能单一
webmvcconfigurer	需要url映射	灵活	需要代码配置
controller方式	动态内容	功能强大	代码量多
模板引擎	动态页面	前后端结合	需要学习模板语法