上篇文章介绍了搭建SpringBoot项目的两种方式,这一篇,我们来学习怎么快速的搭建一个spring boot的web项目。还不会搭建spring boot项目的先看上篇文章。
传送门: 构建Spring Boot项目
SpringBoot项目结构
首先一个搭建好了的SpringBoot项目都有下图的结构
- 项目启动入口类
- 资源文件
- 静态资源
- 动态网页文件
- springboot配置文件
- 测试文件
- git忽略文件
- maven项目依赖管理文件
这些将是我们之后使用spring boot开发项目的主要使用的文件,至于生成的其他文件:mvnw
、mvnw.cmd
、.mvn
、HELP.md
等文件我们在IDE中开发并不会用到。
快速开始
现在让我们来开始一个简单的spring boot的web项目。
首先,我们先在templates
文件夹中创建一个index.html
的文件(**注意:**只能是.html
的文件哦,因为SpringBoot默认读取templates文件夹中的HTML文件)
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>index</title>
</head>
<body>
<h1>hello spring boot</h1>
</body>
</html>
然后,我们创建一个Controller。
先创建一个与入口类同级的web
文件夹(命名按照自己的习惯来就行),这里面就可以放一些项目的controller
package com.example.demo.web;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
/**
* 处理请求的controller
*
* @author 召
*/
@Controller
public class IndexController {
@RequestMapping("/")
public String index() {
return "index";
}
}
最后,运行入口类DemoApplication
即可(这个是我的入口类名字,运行你们自己的入口类)。
. ____ _ __ _ _
/\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
\\/ ___)| |_)| | | | | || (_| | ) ) ) )
' |____| .__|_| |_|_| |_\__, | / / / /
=========|_|==============|___/=/_/_/_/
:: Spring Boot :: (v2.1.6.RELEASE)
/* 出现了上面的spring boot的banner,以及最后的一行就代表项目启动完成了。*/
/* ......(省略的日志) */
2019-07-23 10:23:32.562 INFO 11412 --- [ restartedMain] com.example.demo.DemoApplication : Started DemoApplication in 3.401 seconds (JVM running for 5.125)
这个时候打开你的浏览器,输入http://localhost:8080
就可以访问了。
正常的显示的就如下图所示
使用Thymeleaf
有心的同学就会发现我们刚才显示的只是一个静态的网页,那么我们如果想像之前的web项目一样想要显示一些后台传过来的数据,怎么办呢?
这个时候就需要一个spring boot官方强烈推荐的模板引擎:Thymeleaf
。这个模板引擎和之前我们经常用的JSP
模板引擎作用相似,都可以用来显示一些后台传来的数据。不同的是thymeleaf模板引擎处理的网页文件是.html
后缀的HTML文件,它最大的优势就是我们在Java环境中显示的是我们添加的动态的网页内容,而直接本地打开的这个HTML文件的话显示的则是静态的内容。这样最大的好处就是前端给我们一个静态网页,我们可以直接在这个文件中添加一个thymeleaf的文件头就可以使用EL
表达式和thymeleaf提供的标签属性进行展示后台传递的数据。
添加依赖
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
在springboot项目中,版本一般不需要指定,使用springboot定好的版本即可。只有使用非spring boot支持的依赖(没有配置版本号的依赖)才需要指定版本。版本若非必要不建议指定,有可能引发依赖之间的版本的冲突。
添加命名空间
<!DOCTYPE html>
<!-- 添加th命名空间 -->
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>index</title>
</head>
<body>
<!-- 获取后台传来的message,并展示在h1中 -->
<h1 th:text="${message}">hello spring boot</h1>
</body>
</html>
添加传递数据
在刚才的请求处理的方法中添加一个key为message
的参数,如下所示
@RequestMapping("/")
public String index(Model model) {
model.addAttribute("message","哈喽,SpringBoot");
return "index";
}
现在再次启动入口类(刚才没关服务修改的同学也重启一下),然后刷新网页或者再请求一个http://localhost:8080
,正常运行了的同学应该能显示下面的内容
细心同学就会发现我们本篇文章使用spring boot时根本就没有配置任何东西就可以让我们的web项目跑起来,还能找到我们的网页文件,这是为什么呢?其实只是spring boot已经设置了一些默认值,而我们遵守了它的约定。正如那句话约定大于配置
,遵守了共有的约定,我们就可以少配置很多东西。而不遵守约定就需要在配置文件中设置上相应的属性
# 这个学习过spring mvc的应该相当的熟悉吧
spring.thymeleaf.prefix=classpath:/templates
spring.thymeleaf.suffix=.html
运行方式
- 直接在IDE中运行入口类
- 通过spring-boot-maven-plugin打成jar包,通过
java -jar
运行(项目发布上线时会用到的) - 通过
mvn:springboot run
运行
看了这篇文章相信你已经入门了spring boot项目,那么你还想继续学习spring mvc的内容嘛?请关注下一章