SpringBoot--Web开发
Posted dxj1016
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了SpringBoot--Web开发相关的知识,希望对你有一定的参考价值。
课程相关
- spring:开源框架,轻量级框架,为了解决企业级应用开发的复杂性而创建的。
1、web开发静态资源处理
使用SpringBoot的步骤:
-
创建一个SpringBoot应用,选择我们需要的模块,SpringBoot就会默认将我们的需要的模块自动配置好
-
手动在配置文件中配置部分配置项目就可以运行起来了
-
专注编写业务代码,不需要考虑以前那样一大堆的配置了。
创建一个SpringBoot项目 -
新建springboot项目,命名为springboot-web-study
-
选择需要的配置模块
-
写一个controller层测试一下
@RestController
public class HelloController {
@GetMapping("/hello")
public String hello() {
return "hello world";
}
}
- 启动项目,测试结果
1.1、第一种静态资源映射规则
我们猜测静态资源是放置在static文件中的
现在来看看源码:
- SpringBoot中,SpringMVC的web配置都在WebMvcAutoConfiguration 这个配置类里面;代码页面一直按Shift出现搜索页面,找到WebMvcAutoConfiguration,进去找到WebMvcAutoConfigurationAdapter
- 我们可以继续往下看看 WebMvcAutoConfigurationAdapter 中有很多配置方法;
- 有一个方法:addResourceHandlers 添加资源处理
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
//如果静态资源已经被自定义了,就直接return了
if (!this.resourceProperties.isAddMappings()) {
// 已禁用默认资源处理
logger.debug("Default resource handling disabled");
return;
}
// 缓存控制
Duration cachePeriod = this.resourceProperties.getCache().getPeriod();
CacheControl cacheControl = this.resourceProperties.getCache().getCachecontrol().toHttpCacheControl();
// webjars 配置:这是第一种获取静态资源的方式
if (!registry.hasMappingForPattern("/webjars/**")) {
customizeResourceHandlerRegistration(registry.addResourceHandler("/webjars/**")
.addResourceLocations("classpath:/META-INF/resources/webjars/")
.setCachePeriod(getSeconds(cachePeriod)).setCacheControl(cacheControl));
}
// 静态资源配置:第二种获取静态资源的方式
String staticPathPattern = this.mvcProperties.getStaticPathPattern();
if (!registry.hasMappingForPattern(staticPathPattern)) {
customizeResourceHandlerRegistration(registry.addResourceHandler(staticPathPattern)
.addResourceLocations(getResourceLocations(this.resourceProperties.getStaticLocations()))
.setCachePeriod(getSeconds(cachePeriod)).setCacheControl(cacheControl));
}
}
读一下源代码:比如所有的 /webjars/** , 都需要去 classpath:/META-INF/resources/webjars/ 找对应的资源;
webjars官网
<dependency>
<groupId>org.webjars</groupId>
<artifactId>jquery</artifactId>
<version>3.6.0</version>
</dependency>
导入完毕,查看webjars目录结构,并访问Jquery.js文件
重新启动项目,访问:只要是静态资源,SpringBoot就会去对应的路径寻找资源,我们这里访问:
http://localhost:8080/webjars/jquery/3.4.1/jquery.js
1.2、第二种静态资源映射规则
- 那我们项目中要是使用自己的静态资源该怎么导入呢?我们看下一行代码;
- 刚刚的WebMvcAutoConfigurationAdapter 类中的addResourceHandlers 方法源码中有一段代码,找到getStaticLocations方法,点击进去这个方法里面查看代码,发现里面的代码返回的就是下一行代码中的静态资源staticPathPattern
getStaticLocations方法进去之后的代码:
- 我们去找staticPathPattern发现第二种映射规则 :/** , 访问当前的项目任意资源,它会去找 ResourceProperties 这个类
- 回到WebMvcAutoConfiguration.java类中查找ResourceProperties类,点击进去查看代码:发现有四个位置都可以。ResourceProperties 可以设置和我们静态资源有关的参数;这里面指向了它会去寻找资源的文件夹,即下面数组的内容。
- 回到WebMvcAutoConfiguration.java类中查看getStaticLocation方法
- 继续点击staticLocations进去查看可以看到有一个数组
- 继续点击这个数组属性进去可以看到内容跟上面的一样有四个位置存放静态资源;这里可以设置和我们静态资源有关的参数;这里面指向了它会去寻找资源的文件夹,即下面数组的内容。
- 所以得出结论,以下四个目录存放的静态资源可以被我们识别:
"classpath:/META-INF/resources/"
"classpath:/resources/"
"classpath:/static/"
"classpath:/public/"
- 我们可以在resources根目录下新建对应的文件夹,都可以存放我们的静态文件;比如在public文件夹中新建文件1.js里面写了hello;
- 我们访问 http://localhost:8080/1.js , 他就会去这些文件夹中寻找对应的静态资源文件;
- 四个位置都可以放静态资源,那么他们是否有优先级?测试一下:public:hello1;resources:hello2;static:hell3;下都建一个1.js;内容分别为hello1,hello2,hell3,hello4;启动项目访问看看http://localhost:8080/1.js
说明优先级是resources文件夹下的resources文件夹下的优先级是最高的。 - 删除resources文件夹下的resources文件夹下的文件,然后测试看看结果是hello3,也就是static文件夹下的文件
- 然后删掉static文件夹下的文件启动测试看结果是hello1,也就是public文件夹下的文件。
- 如上的测试可以看出优先级是resources>static>public。
1.3、自定义静态资源路径
我们也可以自己通过配置文件来指定一下,哪些文件夹是需要我们放静态资源文件的,在application.properties中配置;
spring.resources.static-locations=classpath:/coding/,classpath:/kuang/
一旦自己定义了静态文件夹的路径,原来的自动配置就都会失效了!
静态资源总结
2、首页
- 到WebMvcAutoConfiguration.java类中搜索welcom可以看到WelcomePageHandlerMapping,getWelcomePage,getIndexhtml,源码如下:
- 看到上面代码,通过@Bean注解注入bean中,bean里面有个WelcomePageHandlerMapping欢迎页的处理映射,这个映射可以从自定义的this.mvcProperties.getStaticPathPattern()中获取;也可以从getWelcomePage获取,从哪里获得呢,从下面代码this.resourceProperties.getStaticLocations()中获得,也就是从静态资源的目录获取,获取什么呢?会从geIndexHtml中获取,geIndexHtml这个返回在静态资源下找到一个叫index.html的文件就会将这个文件的内容映射到首页。
- 在静态资源路径下添加一个文件,比如这里我在public下创建一个index.html文件,内容如下:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
</head>
<body>
<h1>首页</h1>
</body>
</html>
- 测试结果如下
3、thymeleaf模板引擎
3.1、thymeleaf概述
3.2、引入Thymeleaf
Spring官方文档:找到我们对应的版本
找到对应的pom依赖:可以适当点进源码看下本来的包!
<!--thymeleaf-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
3.3、Thymeleaf分析
我们去找一下Thymeleaf的自动配置类:ThymeleafProperties
idea代码页面双击shift然后搜索ThymeleafProperties
@ConfigurationProperties(
prefix = "spring.thymeleaf"
)
public class ThymeleafProperties {
private static final Charset DEFAULT_ENCODING;
public static final String DEFAULT_PREFIX = "classpath:/templates/";
public static final String DEFAULT_SUFFIX = ".html";
private boolean checkTemplate = true;
private boolean checkTemplateLocation = true;
private String prefix = "classpath:/templates/";
private String suffix = ".html";
private String mode = "HTML";
private Charset encoding;
}
- 我们可以在其中看到默认的前缀和后缀!
- 我们只需要把我们的html页面放在类路径下的templates下,thymeleaf就可以帮我们自动渲染了。
- 使用thymeleaf什么都不需要配置,只需要将他放在指定的文件夹下即可!
3.4、测试
1、编写一个TestController
@Controller
public class TestController {
@RequestMapping("/t1")
public String test1(){
//classpath:/templates/test.html
return "test";
}
}
2、编写一个测试页面 test.html 放在 templates 目录下
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
</head>
<body>
<h1>测试页面</h1>
</body>
</html>
3、启动项目请求测试
3.5、练习 :我们需要查出一些数据,在页面中展示
1、修改测试请求,增加数据传输;
@RequestMapping("/t1")
public String test1(Model model){
//存入数据
model.addAttribute("msg","Hello,Thymeleaf");
//classpath:/templates/test.html
return "test";
}
2、我们要使用thymeleaf,需要在html文件中导入命名空间的约束,方便提示。我们可以去官方文档的#3中看一下命名空间拿来过来:
xmlns:th="http://www.thymeleaf.org"
3、我们去编写下前端页面
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>dxj1016</title>
</head>
<body>
<h1>测试页面</h1>
<!-- 所有的html元素都可以被thymeleaf替换接管:th:元素名 -->
<!--th:text就是将div中的内容设置为它指定的值,和之前学习的Vue一样-->
<div th:text="${msg}"></div>
</body>
</html>
4、启动测试!
3.6、Thymeleaf的使用语法
1、我们可以使用任意的 th:attr 来替换Html中原生属性的值!
2、我们能写哪些表达式呢?
Simple expressions:(表达式语法)
Variable Expressions: ${...}:获取变量值;OGNL;
1)、获取对象的属性、调用方法
2)、使用内置的基本对象:#18
#ctx : the context object.
#vars: the context variables.
#locale : the context locale.
#request : (only in Web Contexts) the HttpServletRequest object.
#response : (only in Web Contexts) the HttpServletResponse object.
#session : (only in Web Contexts) the HttpSession object.
#servletContext : (only in Web Contexts) the ServletContext object.
3)、内置的一些工具对象:
#execInfo : information about the template being processed.
#uris : methods for escaping parts of URLs/URIs
#conversions : methods for executing the configured conversion service (if any).
#dates : methods for java.util.Date objects: formatting, component extraction, etc.
#calendars : analogous to #dates , but for java.util.Calendar objects.
#numbers : methods for formatting numeric objects.
#strings : methods for String objects: contains, startsWith, prepending/appending, etc.
#objects : methods for objects in general.
#bools : methods for boolean evaluation.
#arrays : methods for arrays.
#lists : methods for lists.
#sets : methods for sets.
#maps : methods for maps.
#aggregates : methods for creating aggregates on arrays or collections.
==================================================================================
Selection Variable Expressions: *{...}:选择表达式:和${}在功能上是一样;
Message Expressions: #{...}:获取国际化内容
Link URL Expressions: @{...}:定义URL;
Fragment Expressions: ~{...}:片段引用表达式
Literals(字面量)
Text literals: 'one text' , 'Another one!' ,…
Number literals: 0 , 34 , 3.0 , 12.3 ,…
Boolean literals: true , false
Null literal: null
Literal tokens: one , sometext , main ,…
Text operations:(文本操作)
String concatenation: +
Literal substitutions: |The name is ${name}|
Arithmetic operations:(数学运算)
Binary operators: + , - , * , / , %
Minus sign (unary operator): -
Boolean operations:(布尔运算)
Binary operators: and , or
Boolean negation (unary operator): ! , not
Comparisons and equality:(比较运算)
Comparators: > , < , >= , <= ( gt , lt , ge , le )
Equality operators: == , != ( eq , ne )
Conditional operators:条件运算(三元运算符)
If-then: (if) ? (then)
If-then-else: (if) ? (then) : (else)
Default: (value) ?: (defaultvalue)
Special tokens:
No-Operation: _
3.7、练习测试:
1、 我们编写一个Controller,放一些数据
@RequestMapping("/t2")
public String test2(Map<String,Object> map){
//存入数据
map.put("msg","<h1>Hello</h1>");
map.put("users", Arrays.asList("dxj1016","@GYun1016"));
//classpath:/templates/test.html
return "test";
}
2、测试页面取出数据
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>dxj1016</title>
</head>
<body>
<h1>测试页面</h1>
<!-- 所有的html元素都可以被thymeleaf替换接管:th:元素名 -->
<!--th:text就是将div中的内容设置为它指定的值,和之前学习的Vue一样-->
<div th:text="${msg}"></div>
<!--不转义-->
<div th:utext="${msg}"></div>
<!--遍历数据-->
<!--th:each每次遍历都会生成当前这个标签:官网#9-->
<h3 th:each="user :${users}" th:text="${user}"></h3>
<h3>
<!--行内写法:官网#12-->
<span th:each="user:${users}">[[${user}]]</span>
</h3>
</body>
</html>
3、启动项目测试!
4、MVC自动配置原理
官方文档解析:
Spring MVC Auto-configuration
// Spring Boot为Spring MVC提供了自动配置,它可以很好地与大多数应用程序一起工作。
Spring Boot provides auto-configuration for Spring MVC that works well with most applications.
// 自动配置在Spring默认设置的基础上添加了以下功能:
The auto-configuration adds the following features on top of Spring’s defaults:
// 包含视图解析器
Inclusion of ContentNegotiatingViewResolver and BeanNameViewResolver beans.
// 支持静态资源文件夹的路径,以及webjars
Support for serving static resources, including support for WebJars
// 自动注册了Converter:
// 转换器,这就是我们网页提交数据到后台自动封装成为对象的东西,比如把"1"字符串自动转换为int类型
// Formatter:【格式化器,比如页面给我们了一个2019-8-10,它会给我们自动格式化为Date对象】
Automatic registration of Converter, GenericConverter, and Formatter beans.
// HttpMessageConverters
// SpringMVC用来转换Http请求和响应的的,比如我们要把一个User对象转换为JSON字符串,可以去看官网文档解释;
Support for HttpMessageConverters (covered later in this document).
// 定义错误代码生成规则的
Automatic registration of MessageCodesResolver (covered later in this document).
// 首页定制
Static index.html support.
// 图标定制
Custom Favicon support (covered later in this document).
// 初始化数据绑定器:帮我们把请求数据绑定到JavaBean中!
Automatic use of a ConfigurableWebBindingInitializer bean (covered later in this document).
/*
如果您希望保留Spring Boot MVC功能,并且希望添加其他MVC配置(拦截器、格式化程序、视图控制器和其他功能),则可以添加自己
的@configuration类,类型为webmvcconfiguer,但不添加@EnableWebMvc。如果希望提供
RequestMappingHandlerMapping、RequestMappingHandlerAdapter或ExceptionHandlerExceptionResolve以上是关于SpringBoot--Web开发的主要内容,如果未能解决你的问题,请参考以下文章