当前位置:   article > 正文

4.8 JavaEE-SpringBoot_javaee的启动类

javaee的启动类

目录

4.8.1 SpringBoot

4.8.1.1 什么是Spring Boot

4.8.1.2 SpringBoot的特点

 4.8.2 快速入门

4.8.2.1 创建工程

4.8.2.2 引入依赖

4.8.2.3 启动类

4.8.2.4 controller

4.8.2.5 测试

4.8.3 注解与属性注入

4.8.3.1 注解

4.8.3.1.1 @EnableAutoConfiguration

4.8.3.1.2 @ComponentScan

4.8.3.1.3 @SpringBootConfiguration

4.8.3.1.4 @SpringBootApplication

4.8.3.1.4 @RestController 

4.8.3.2 SpringBoot的属性注入

4.8.3.2.1 传统方式注入

4.8.3.2.2 springboot方式注入

4.8.3.2.3 其他方式

4.8.4 SpringBoot整合

4.8.4.1 基础搭建

4.8.4.1.1 自动生成

4.8.4.1.2 手动搭建

4.8.4.1.3 引入依赖

4.8.4.2 整合SpringMVC

4.8.4.3 整合连接池

4.8.4.3.1 HikariCP连接池

4.8.4.3.2 Druid连接池

4.8.4.3.4 HikariCP与Druid的对比

4.8.4.4 整合mybatis

4.8.4.4.1 手写mapper

4.8.4.4.2 通用mapper

4.8.4.5 整合事务

4.8.5 SpringBoot Test

4.8.5.1 概述

4.8.5.2 单元测试

4.8.5.4 功能测试

4.8.6 Thymeleaf

4.8.6.1 试想一个场景

4.8.6.2 什么是Thymeleaf

4.8.6.3 Thymeleaf实现


4.8.1 SpringBoot

4.8.1.1 什么是Spring Boot

众所周知 Spring 应用需要进行大量的配置,各种 XML 配置和注解配置让人眼花缭乱,且极容易出错,因此 Spring 一度被称为“配置地狱”。
为了简化 Spring 应用的搭建和开发过程,出现了一套全新的开源的框架,它就是 Spring Boot。
Spring Boot 具有 Spring 一切优秀特性,Spring 能做的事,Spring Boot 都可以做,而且使用更加简单,功能更加丰富,性能更加稳定而健壮。
Spring Boot 提供了大量开箱即用(out-of-the-box)的依赖模块,例如 spring-boot-starter-redis、spring-boot-starter-data-mongodb 和 spring-boot-starter-data-elasticsearch 等。这些依赖模块为 Spring Boot 应用提供了大量的自动配置,使得 Spring Boot 应用只需要非常少量的配置甚至零配置,便可以运行起来,让开发人员从 Spring 的“配置地狱”中解放出来,有更多的精力专注于业务逻辑的开发。

因此,我们也称springboot为脚手架。

SpringBoot官方参考文献【Spring Boot Reference Guide

4.8.1.2 SpringBoot的特点

Spring Boot 主要特征是:

  • 创建独立的spring应用程序
  • 敏捷开发
  • 直接内嵌tomcat、jetty和undertow(不需要打包成war包部署)
  • 自动配置spring和第三方库
  • 绝对不会生成代码,并且不需要XML配置
  • 约定大于配置

 4.8.2 快速入门

4.8.2.1 创建工程

创建一个空项目

 

4.8.2.2 引入依赖

添加父工程坐标

  1. <parent>
  2. <groupId>org.springframework.boot</groupId>
  3. <artifactId>spring-boot-starter-parent</artifactId>
  4. <version>2.0.6.RELEASE</version>
  5. </parent>

添加web启动器

  1. <dependencies>
  2. <dependency>
  3. <groupId>org.springframework.boot</groupId>
  4. <artifactId>spring-boot-starter-web</artifactId>
  5. </dependency>
  6. </dependencies>

为了让SpringBoot帮我们完成各种自动配置,我们必须引入SpringBoot提供的自动配置依赖,我们称为启动器。因为我们是web项目,这里我们引入web启动器:

需要注意的是,我们并没有在这里指定版本信息。因为SpringBoot的父工程已经对版本进行了管理了。

4.8.2.3 启动类

SpringbootDemoApplication

  1. //@SpringBootApplication
  2. @EnableAutoConfiguration
  3. @ComponentScan
  4. public class SpringbootDemoApplication {
  5. public static void main(String[] args) {
  6. SpringApplication.run(SpringbootDemoApplication.class);
  7. }
  8. }

4.8.2.4 controller

DemoController

  1. @RestController
  2. @EnableAutoConfiguration //开启自动配置
  3. public class DemoController {
  4. @RequestMapping("/first")
  5. public String first(){
  6. return "this is my first spring boot project!";
  7. }
  8. public static void main(String[] args) {
  9. SpringApplication.run(DemoController.class,args);
  10. }
  11. }

4.8.2.5 测试

输入网址 

4.8.3 注解与属性注入

4.8.3.1 注解

4.8.3.1.1 @EnableAutoConfiguration

开启spring应用程序的自动配置,SpringBoot基于所添加的依赖和自定义的bean,试图去猜测并配置想要的配置。比如引入spring-boot-starter-web,而这个启动器中帮我们添加了tomcatSpringMVC的依赖。此时自动配置就知道是要开发一个web应用,所以自动完成了web及SpringMVC的默认配置了!

4.8.3.1.2 @ComponentScan

配置组件扫描的指令。提供了类似与<context:component-scan>标签的作用

通过basePackageClasses或者basePackages属性来指定要扫描的包。如果没有指定这些属性,那么将从声明这个注解的类所在的包开始,扫描包及子包

而@ComponentScan注解声明的类就是main函数所在的启动类,因此扫描的包是该类所在包及其子包。一般启动类会放在一个比较浅的包目录中。

4.8.3.1.3 @SpringBootConfiguration

这个注解的作用就是声明当前类是一个配置类,然后Spring会自动扫描到添加了@Configuration的类,并且读取其中的配置信息。而@SpringBootConfiguration是来声明当前类是SpringBoot应用的配置类,项目中只能有一个。所以一般我们无需自己添加。

4.8.3.1.4 @SpringBootApplication

上面一堆太复杂,于是@SpringBootApplication整合了上面所有注解,以后只需要写一个@SpringBootApplication就可以

@SpringBootApplication其实是一个组合注解,这里重点的注解有3个:

  • @SpringBootConfiguration
  • @EnableAutoConfiguration:开启自动配置
  • @ComponentScan:开启注解扫描

4.8.3.1.4 @RestController 

@RestController 是@controller和@ResponseBody 的结合

@Controller 将当前修饰的类注入SpringBoot IOC容器,使得从该类所在的项目跑起来的过程中,这个类就被实例化。
@ResponseBody表示方法的返回值直接以指定的格式写入Http response body中,而不是解析为跳转路径

如果要求方法返回的是json格式数据,而不是跳转页面,可以直接在类上标注@RestController,而不用在每个方法中标注@ResponseBody,简化了开发过程。

  1. @RestController
  2. public class TestController {
  3. @RequestMapping("/first")
  4. public String test(){
  5. return "test";
  6. }
  7. }

4.8.3.2 SpringBoot的属性注入

4.8.3.2.1 传统方式注入

  1. @Configuration //配置类 bean.xml
  2. @PropertySource("classpath:jdbc.properties") //加载属性文件
  3. public class DataSourceAutoConfiguration {
  4. //使用value注解传递参数
  5. @Value("${jdbc.url}")
  6. String url;
  7. @Value("${jdbc.driverClassName}")
  8. String driverClassName;
  9. @Value("${jdbc.username}")
  10. String username;
  11. @Value("${jdbc.password}")
  12. String password;
  13. //方法返回的对象放到IOC中
  14. @Bean //<bean id="DataSource" class="......">
  15. public DataSource dataSource() {
  16. DruidDataSource dataSource = new DruidDataSource();
  17. dataSource.setUrl(url);
  18. dataSource.setDriverClassName(driverClassName);
  19. dataSource.setUsername(username);
  20. dataSource.setPassword(password);
  21. return dataSource;
  22. }
  • @Configuration:声明JdbcConfiguration是一个配置类。

  • @PropertySource:指定属性文件的路径是:classpath:jdbc.properties

  • 通过@Value为属性注入值。

  • 通过@Bean将 dataSource()方法声明为一个注册Bean的方法,Spring会自动调用该方法,将方法的返回值加入Spring容器中。相当于以前的bean标签  

可以在任意位置通过@Autowired注入DataSource

4.8.3.2.2 springboot方式注入

传统方式属性注入使用的是@Value注解。这种方式虽然可行,但是不够强大,因为它只能注入基本类型值。

在SpringBoot中,提供了一种新的属性注入方式,支持各种java基本数据类型及复杂类型的注入。

1、新建JdbcProperties,用来进行属性注入

  1. @ConfigurationProperties(prefix = "jdbc")
  2. public class JdbcProperties {
  3. private String url;
  4. private String driverClassName;
  5. private String username;
  6. private String password;
  7. // ... 略
  8. // getters 和 setters
  9. }
  • 在类上通过@ConfigurationProperties注解声明当前类为属性读取类

  • prefix="jdbc"读取属性文件中,前缀为jdbc的值。

  • 在类上定义各个属性,名称必须与属性文件中jdbc.后面部分一致,并且必须具有getter和setter方法

  • 需要注意的是,这里我们并没有指定属性文件的地址,SpringBoot默认会读取文件名为application.properties的资源文件

 application.properties

  1. # SpringBoot
  2. spring.datasource.driverClassName=com.mysql.jdbc.Driver
  3. spring.datasource.url=jdbc:mysql:///mydb
  4. spring.datasource.username=root
  5. spring.datasource.password=123456
  6. #HikariCP 连接池 springboot默认连接池
  7. spring.datasource.hikari.idle-timeout=60000
  8. spring.datasource.hikari.maximum-pool-size=30
  9. spring.datasource.hikari.minimum-idle=10
  10. #
  11. #logging.level.org.springframework=debug
  12. # mybatis
  13. # 别名
  14. mybatis.type-aliases-package=com.bl.model
  15. # mapper文件路径
  16. # mybatis.mapper-locations=classpath:mapper/*.xml
  17. # mybatis全局配置文件路径
  18. # mybatis.config-location=classpath:mybatis-config.xml

2、在JdbcConfiguration中使用这个属性,有三种方式

  1. @Autowired注入
  2. 构造函数注入
  3. @Bean方法的形参注入

@Autowired注入

  1. @Configuration
  2. @EnableConfigurationProperties(JdbcProperties.class)
  3. public class JdbcConfiguration {
  4. @Autowired
  5. private JdbcProperties jdbcProperties;
  6. @Bean
  7. public DataSource dataSource() {
  8. DruidDataSource dataSource = new DruidDataSource();
  9. dataSource.setUrl(jdbcProperties.getUrl());
  10. dataSource.setDriverClassName(jdbcProperties.getDriverClassName());
  11. dataSource.setUsername(jdbcProperties.getUsername());
  12. dataSource.setPassword(jdbcProperties.getPassword());
  13. return dataSource;
  14. }
  15. }

构造函数注入

  1. @Configuration
  2. @EnableConfigurationProperties(JdbcProperties.class)
  3. public class JdbcConfiguration {
  4. private JdbcProperties jdbcProperties;
  5. public JdbcConfiguration(JdbcProperties jdbcProperties){
  6. this.jdbcProperties = jdbcProperties;
  7. }
  8. @Bean
  9. public DataSource dataSource() {
  10. // 略
  11. }
  12. }

 @Bean方法的形参注入

  1. @Configuration
  2. @EnableConfigurationProperties(JdbcProperties.class)
  3. public class JdbcConfiguration {
  4. @Autowired
  5. DataSourceProperties dataSourceProperties;
  6. //方法返回的对象放到IOC中
  7. @Bean //<bean id="DataSource" class="......">
  8. public DataSource dataSource() {
  9. DruidDataSource dataSource = new DruidDataSource();
  10. dataSource.setUrl(dataSourceProperties.getUrl());
  11. dataSource.setDriverClassName(dataSourceProperties.getDriverClassName());
  12. dataSource.setUsername(dataSourceProperties.getUsername());
  13. dataSource.setPassword(dataSourceProperties.getPassword());
  14. return dataSource;
  15. }
  16. }

4.8.3.2.3 其他方式

当只有一个类使用属性。如果一段属性只有一个Bean需要使用,我们无需将其注入到一个类(JdbcProperties)中。而是直接在需要的地方声明即可:

  1. @Configuration
  2. public class JdbcConfiguration {
  3. @Bean
  4. // 声明要注入的属性前缀,SpringBoot会自动把相关属性通过set方法注入到DataSource中
  5. @ConfigurationProperties(prefix = "jdbc")
  6. public DataSource dataSource() {
  7. DruidDataSource dataSource = new DruidDataSource();
  8. return dataSource;
  9. }
  10. }

直接把@ConfigurationProperties(prefix = "jdbc")声明在需要使用的@Bean的方法上,然后SpringBoot就会自动调用这个Bean(此处是DataSource)的set方法,然后完成注入。使用的前提是:该类必须有对应属性的set方法!

4.8.4 SpringBoot整合

4.8.4.1 基础搭建

4.8.4.1.1 自动生成

4.8.4.1.2 手动搭建

如图所示手动搭建项目

4.8.4.1.3 引入依赖

父工程坐标

  1. <parent>
  2. <groupId>org.springframework.boot</groupId>
  3. <artifactId>spring-boot-starter-parent</artifactId>
  4. <version>2.0.6.RELEASE</version>
  5. </parent>

web启动器

  1. <dependencies>
  2. <dependency>
  3. <groupId>org.springframework.boot</groupId>
  4. <artifactId>spring-boot-starter-web</artifactId>
  5. </dependency>
  6. </dependencies>

 创建启动类Appstarter 

  1. @SpringBootApplication
  2. public class Appstarter {
  3. public static void main(String[] args) {
  4. SpringApplication.run(Appstarter.class,args);
  5. }
  6. }

注意启动类的位置,要和最后的包同层(要放在一个比较浅的包目录中)

TestController 

  1. @RestController
  2. public class TestController {
  3. @RequestMapping("/first")
  4. public String test1(){
  5. return "first";
  6. }
  7. }

4.8.4.2 整合SpringMVC

添加全局配置文件application.properties  

  1. # 此时可以创建空的文件,后续整合其他模块会在全局配置文件中逐步添加配置信息
  2. # 映射端口
  3. # server.port=8080

访问静态资源

项目是一个jar工程,没有webapp,我们的静态资源该放哪里呢?

只要静态资源放在这些目录中任何一个,SpringMVC都会帮我们处理。

习惯性将静态资源放在classpath:/static/目录下

添加拦截器

拦截器不是一个普通属性,而是一个类,所以就要用到java配置方式了

如果想要保持Spring Boot 的一些默认MVC特征,同时又想自定义一些MVC配置(包括:拦截器,格式化器, 视图控制器、消息转换器 等等),你应该让一个类实现WebMvcConfigurer,并且添加@Configuration注解,但是千万不要@EnableWebMvc注解。如果你想要自定义HandlerMappingHandlerAdapterExceptionResolver等组件,你可以创建一个WebMvcRegistrationsAdapter实例 来提供以上组件。

如果你想要完全自定义SpringMVC,不保留SpringBoot提供的一切特征,你可以自己定义类并且添加@Configuration注解和@EnableWebMvc注解

通过实现WebMvcConfigurer并添加@Configuration注解来实现自定义部分SpringMvc配置。

 定义一个拦截器MyInterceptor

  1. @Component //创建对象
  2. public class MyInterceptor implements HandlerInterceptor {
  3. @Override
  4. public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
  5. System.out.println("核心业务之前执行");
  6. return true; //true:表示放行 false:不放行,一直卡这
  7. }
  8. @Override
  9. public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
  10. System.out.println("核心业务之后执行");}
  11. @Override
  12. public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
  13. System.out.println("核心业务完成之后执行");
  14. }
  15. }

定义配置类,注册拦截器

  1. @Configuration //配置类 替代以前的xml文件
  2. public class MyMVCConfig implements WebMvcConfigurer {
  3. //配置原来的xml里面的规则
  4. @Autowired
  5. MyInterceptor myInterceptor;
  6. @Override
  7. public void addInterceptors(InterceptorRegistry registry) {
  8. //添加自定义拦截器
  9. registry.addInterceptor(myInterceptor)
  10. .addPathPatterns("/**") //定义规则 /**:拦截所有资源 /*:只拦截一层 如/user/findall 只拦截user,不拦截findall
  11. .excludePathPatterns("/first"); //不拦截哪些资源
  12. }
  13. }

4.8.4.3 整合连接池

4.8.4.3.1 HikariCP连接池

 [hi·ka·'lē] (日语): 光

HikariCP应该是目前速度最快的连接池,同时也是springboot默认的连接池,所以不需要引入依赖,直接简单配置即可

application.properties

  1. # 连接四大参数
  2. spring.datasource.url=jdbc:mysql://localhost:3306/dms
  3. spring.datasource.username=root
  4. spring.datasource.password=root
  5. # 可省略,SpringBoot自动推断
  6. spring.datasource.driverClassName=com.mysql.jdbc.Driver
  7. spring.datasource.hikari.idle-timeout=60000
  8. spring.datasource.hikari.maximum-pool-size=30
  9. spring.datasource.hikari.minimum-idle=10

4.8.4.3.2 Druid连接池

引入Druid官方提供的启动器

  1. <!-- Druid连接池 -->
  2. <dependency>
  3. <groupId>com.alibaba</groupId>
  4. <artifactId>druid-spring-boot-starter</artifactId>
  5. <version>1.1.6</version>
  6. </dependency>

application.properties 

  1. #初始化连接数
  2. spring.datasource.druid.initial-size=1
  3. #最小空闲连接
  4. spring.datasource.druid.min-idle=1
  5. #最大活动连接
  6. spring.datasource.druid.max-active=20
  7. #获取连接时测试是否可用
  8. spring.datasource.druid.test-on-borrow=true
  9. #监控页面启动
  10. spring.datasource.druid.stat-view-servlet.allow=true

4.8.4.3.4 HikariCP与Druid的对比

类别    Druid   HikariCP
获取和关闭Connection速度 较慢较快
lru cache支持不支持
ps chace支持 不支持
Filter扩展 支持不支持
连接泄露诊断logAbandoned不支持
SQL注入检查支持不支持
配置加密 支持不支持
代码量较多较少

总的来说 

性能方面:HikariCP因为细节方面优化力度较大,性能方面强于Druid

功能丰富程度方面:Druid功能更全面除了具有连接池的基本功能以外,还支持sql级监控,支持扩展,防止SQL注入等功能。

使用热度:Druid在国内使用较多,国内有很多生产实践。HikariCP是spring boot 2.0以后默认连接池,在国外使用较多。

如果要求速度,建议使用HikariCP,如果对速度要求不是很严格,但对各个方面功能要求综合性,建议使用Druid。

4.8.4.4 整合mybatis

4.8.4.4.1 手写mapper

SpringBoot官方并没有提供Mybatis的启动器,不过Mybatis官方自己实现了:

  1. <!--mybatis -->
  2. <dependency>
  3. <groupId>org.mybatis.spring.boot</groupId>
  4. <artifactId>mybatis-spring-boot-starter</artifactId>
  5. <version>1.3.2</version>
  6. </dependency>

基本没什么可配置的 

application.properties 

  1. # mybatis
  2. # 别名
  3. mybatis.type-aliases-package=com.bl.model
  4. # mapper文件路径
  5. # mybatis.mapper-locations=classpath:mapper/*.xml
  6. # mybatis全局配置文件路径
  7. # mybatis.config-location=classpath:mybatis-config.xml

注意,这里没有配置mapper接口扫描包,因此我们需要给每一个Mapper接口添加@Mapper注解,才能被识别。

  1. @Mapper
  2. public interface UserMapper {
  3. }

4.8.4.4.2 通用mapper

由于mapper里很多代码都是重复的,因此把重复的代码提取出来,便有了通用mapper

通用 Mapper 是一个可以实现任意 MyBatis 通用方法的框架,项目提供了常规的增删改查操作

我们可以仅仅继承通用mapper,就可以使用父类的简单的增删改查方法。

相当于认个干爹,这样,干爹有什么,儿子就有什么,很方便

通用mapper启动器

  1. <!-- 通用mapper -->
  2. <dependency>
  3. <groupId>tk.mybatis</groupId>
  4. <artifactId>mapper-spring-boot-starter</artifactId>
  5. <version>2.0.2</version>
  6. </dependency>

创建UserMapper继承通用mapper 

  1. @org.apache.ibatis.annotations.Mapper //扫描持久层,认个爹,基础的增删改查都有了
  2. public interface UserMapper extends Mapper<User> {
  3. }
  4. @Mapper
  5. public interface UserMapper extends tk.mybatis.mapper.common.Mapper<User>{
  6. }

 UserServiceImpl 

  1. @Service
  2. // @Transactional全局事务
  3. public class UserServiceImpl implements UserService {
  4. @Autowired
  5. UserMapper userMapper;
  6. @Override
  7. // Transactional() 某个方法添加事务
  8. public User findById(Integer id) {
  9. //父亲给我的方法,不用自己写
  10. return userMapper.selectByPrimaryKey(id);
  11. }
  12. }

model层

  1. @Table(name="user") //指定哪张表
  2. @Data
  3. public class User implements Serializable {
  4. @Id //指定主键
  5. private Integer id;
  6. private String name;
  7. private String password;
  8. }

我们在这里会发现,自己明明没有定义mapper层的具体方法,为什么有个selectByPrimaryKey?

如果点击进入Mapper<User>里,就会发现里面定义了基础的增删改查方法,我们只需要直接用就行

 UserController 

  1. @RestController
  2. public class UserController {
  3. @Autowired
  4. UserService userService;
  5. @RequestMapping("findById/{id}")
  6. public User findById(Integer id){
  7. User user = userService.findById(id);
  8. System.out.println(user);
  9. return user;
  10. }
  11. }

注意

若出现id为0的问题 

可能是model层的id类型为int,将int修改为integer类型

model 类里面 id 必须用integer 类型,int 类型会出错。
Integer 改用 包装类的时候必须要用包装类

解决:自增主键类型int型改为Integer

4.8.4.5 整合事务

引入jdbc或者web的启动器,就已经引入事务相关的依赖及默认配置了,所以不需要再单独引入事务启动器

事务的注解@Transactional

在某个方法上添加@Transactional表示该方法添加事务

在类上添加@Transactional表示该类添加全局事务

  1. @Service
  2. // @Transactional全局事务
  3. public class UserServiceImpl implements UserService {
  4. @Autowired
  5. UserMapper userMapper;
  6. @Override
  7. // Transactional() 某个方法添加事务
  8. public User findById(Integer id) {
  9. //父亲给我的方法,不用自己写
  10. return userMapper.selectByPrimaryKey(id);
  11. }
  12. }

4.8.5 SpringBoot Test

4.8.5.1 概述

Spring Boot Test分为如下三类:

单元测试:一般面向方法,编写一般业务代码时。涉及到的注解有@Test。
切片测试:一般面向难于测试的边界功能,介于单元测试和功能测试之间。涉及到的注解有@RunWith @WebMvcTest等。
功能测试:一般面向某个完整的业务功能,同时也可以使用切面测试中的mock能力,推荐使用。涉及到的注解有@RunWith @SpringBootTest等。

4.8.5.2 单元测试

  1. public class JavaTest {
  2. @Test
  3. public void test() {
  4. }
  5. }

4.8.5.4 功能测试

  1. @RunWith(SpringRunner.class)
  2. @SpringBootTest
  3. public class springboottest {
  4. @Autowired
  5. myTest mytest;
  6. @Test
  7. public void test1() {
  8. mytest.test();
  9. }
  10. }

Springboot的@RunWith(SpringRunner.class)

注解的意义在于Test测试类要使用注入的类,比如@Autowired注入的类,

有了@RunWith(SpringRunner.class)这些类才能实例化到spring容器中,自动注入才能生效,

否则会抛出NullPointerExecption

4.8.6 Thymeleaf

4.8.6.1 试想一个场景

前后端分离,为什么后端还要做静态页面相关工作?

想象一个场景,优惠券,除了金额数据不一样,其他的页面布局都一样,如果每种优惠券都手动书写静态页面太麻烦

所以前端可以制作一个静态页面模板,后端将金额数据填充到模板中,之后模板引擎渲染页面,最后动态生成不同金额的优惠券,效率极大的提高。

因此虽然前后端分离,但是后端还会做一些静态页面相关工作

4.8.6.2 什么是Thymeleaf

SpringBoot并不推荐使用jsp,但是支持一些模板引擎技术

Thymeleaf 是一个和FreeMarker 类似的模板引擎,里面有标签,可以做页面渲染,生成页面;

Thymeleaf 是spring推荐的官方模板引擎

Thymeleaf 可以完全替代 JSP 。相较于其他的模板引擎,它有如下四个特点:

  • 动静结合:Thymeleaf 在有网络和无网络的环境下皆可运行,即它可以让美工在浏览器查看页面的静态效果,也可以让程序员在服务器查看带数据的动态页面效果。这是由于它支持 html 原型,然后在 html 标签里增加额外的属性来达到模板+数据的展示方式。浏览器解释 html 时会忽略未定义的标签属性,所以 thymeleaf 的模板可以静态地运行;当有数据返回到页面时,Thymeleaf 标签会动态地替换掉静态内容,使页面动态显示
  • 开箱即用:它提供标准和spring标准两种方言,可以直接套用模板实现JSTL、 OGNL表达式效果,避免每天套模板、改jstl、改标签的困扰。同时开发人员也可以扩展和创建自定义的方言。
  • 多方言支持:Thymeleaf 提供spring标准方言和一个与 SpringMVC 完美集成的可选模块,可以快速的实现表单绑定、属性编辑器、国际化等功能。
  • 与SpringBoot完美整合,SpringBoot提供了Thymeleaf的默认配置,并且为Thymeleaf设置了视图解析器,我们可以像以前操作jsp一样来操作Thymeleaf。代码几乎没有任何区别,就是在模板语法上有区别。

 简单看一下Thymeleaf 配置类

  1. ConfigurationProperties(prefix = "spring.thymeleaf")
  2. public class ThymeleafProperties{
  3. private static final charset DEFAULT_ENCODING = standardCharsets.UTF_8;
  4. //视图解析器里 添加前缀和后缀
  5. //和jsp中视图解析器处理类似
  6. public static final string DEFAULT_PREFIX = "classpath: /templates/";
  7. public static final string DEFAULT_SUFFIX = ".html":;

4.8.6.3 Thymeleaf实现

添加启动器

  1. <dependency>
  2. <groupId>org.springframework.boot</groupId>
  3. <artifactId>spring-boot-starter-thymeleaf</artifactId>
  4. </dependency>

SpringBoot会自动为Thymeleaf注册一个视图解析器

与解析JSP的InternalViewResolver类似,Thymeleaf也会根据前缀和后缀来确定模板文件的位置

 controller方法

  1. //@RestController//之前是因为页面不跳转,所以才添加的@RestController
  2. @Controller //用需要添加@ResponseBody
  3. public class UserController {
  4. @Autowired
  5. UserService userService;
  6. @ResponseBody //添加注释,不会页面跳转,而是静态显示
  7. @RequestMapping("findById/{id}")
  8. public String findById(Integer id, Model model){
  9. User user = userService.findById(id);
  10. return user;
  11. }
  12. @RequestMapping("findAll")
  13. public String findALL(Model model){
  14. List<User> user = userService.findAll();
  15. model.addAttribute("user",user);
  16. return "user"; //由于thymeleaf有视图解析 会访问/templates/user.html
  17. }
  18. }

 静态页面

模板默认放在classpath下的templates文件夹,我们新建一个html文件放入其中  

  1. <!DOCTYPE html>
  2. <!--thymeleaf名称空间必须引入-->
  3. <html xmlns:th="http://www.thymeleaf.org">
  4. <head>
  5. <meta charset="UTF-8">
  6. <title>首页</title>
  7. <style type="text/css">
  8. table {border-collapse: collapse; font-size: 14px; width: 80%; margin: auto}
  9. table, th, td {border: 1px solid darkslategray;padding: 10px}
  10. </style>
  11. </head>
  12. <body>
  13. <div style="text-align: center">
  14. <hr/>
  15. <table class="list">
  16. <tr>
  17. <th>id</th>
  18. <th>姓名</th>
  19. <th>性别</th>
  20. <th>年龄</th>
  21. <th>地址</th>
  22. <th>qq</th>
  23. <th>email</th>
  24. </tr>
  25. <tr th:each="user : ${user}">
  26. <td th:text="${user.id}">test</td>
  27. <td th:text="${user.name}">test</td>
  28. <td th:text="${user.gender}">test</td>
  29. <td th:text="${user.age}">test</td>
  30. <td th:text="${user.address}">test</td>
  31. <td th:text="${user.qq}">test</td>
  32. <td th:text="${user.email}">test</td>
  33. </tr>
  34. </table>
  35. </div>
  36. </body>
  37. </html>

语法:

  • ${} :这个类似与el表达式,但其实是ognl的语法,比el表达式更加强大

  • th-指令:th-是利用了Html5中的自定义属性来实现的。如果不支持H5,可以用data-th-来代替

    • th:each:类似于c:foreach 遍历集合,但是语法更加简洁

    • th:text:声明标签中的文本

      • 例如<td th-text='${user.id}'>test</td>,如果user.id有值,会覆盖默认的test

      • 如果没有值,则会显示td中默认的test。这正是thymeleaf能够动静结合的原

      • 因,模板解析失败不影响页面的显示效果,因为会显示默认值!

 运行结果

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/小小林熬夜学编程/article/detail/87874
推荐阅读
相关标签
  

闽ICP备14008679号