SpringBoot入门到精通-SpringBoot集成WEB开发(四)-阿里云开发者社区

前言

上一篇文章我们讲的是SpringBoot的基本用法，本篇文章我们来学习一下SpringBoot如何整合web，以及Mybatis以及事务。

五.SpringBoot集成SSM

1.WEB集成

1.1.集成Thymeleaf

现在的项目基本上都采用前后端分离架构，也就是项目后台不需要处理页面，但是在一些小型的项目中还是把页面耦合在后台项目中，这就需要集成视图技术(模板技术)。常见的模板技术有 thymeleaf ；freemaker ；Velotity ; jsp 。

jsp相信大家都使用过，因为性能问题现在基本被淘汰，SpringBoot官方推荐使用thymeleaf 。

第一步：集成thymeleaf 需要导入依赖

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

第二步：创建thymeleaf模板文件 , 在resources/templates中创建 index.html 文件，内容如下

<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>成功！</h1>

    <!--使用语法th:text 将div里面的文本内容设置为 -->
    <div th:text="${msg}">这是显示欢迎信息</div>
</body>
</html>

文件中需要一个 msg 内容来填充，注意：它不是一个静态资源html,而是thymeleaf的模板文件

第三步：编写实controller

@Controller
public class HelloController {
   
   

    @RequestMapping("/index")
    public String index(Model model){
   
   
        model.addAttribute("msg","惊不惊喜，刺不刺激");
        //返回视图名
        return "index";
    }
}

第四步：访问http://localhost:9999/index,效果如下

如果你需要对thymeleaf有些个性化配置，可以在application.yml中配置如下

spring:
  thymeleaf:
    encoding: utf-8
    prefix: classpath:/templates/  #默认去哪个路径找页面
    cache: true #是否开启缓存
    enabled: true #是否使用 thymeleaf 的开关
    suffix: .html #页面的后缀，可以修改

到这里thymeleaf就集成成功了，剩下的就是thymeleaf的语法了，如果您公司有用到thymeleaf那你可以专门早点资料去学习一下，这里不是重点，不做过多描述。

1.2.webjars

WebJars能使Maven的依赖管理支持OSS的JavaScript库/CSS库，比如jQuery、Bootstrap等；WebJars是将Web前端Javascript和CSS等资源打包成Java的Jar包，这样在Java Web开发中我们可以借助Maven这些依赖库的管理，保证这些Web资源版本唯一性。可以在（ http://www.webjars.org/）网站查找你需要的依赖。

在这里插入图片描述

这里以jQuery为例，第一步：导入jquery的jar

<dependency>
    <groupId>org.webjars</groupId>
    <artifactId>jquery</artifactId>
    <version>3.4.1</version>
</dependency>

第二步：在页面导入jquery的js即可使用

<script src="/webjars/jquery/3.4.1/jquery.js"></script>

1.3.注册拦截器

我们可以回顾一下在SpringMVC XML中是如何注册拦截器的，首先需要定义拦截器类，实现HandlerInterceptor或者继承HandlerInterceptorAdapter也行。然后需要在xml中注册拦截器

<!-- 配置拦截器：-->
<mvc:interceptors>
    <mvc:interceptor>
        <!-- 拦截所有请求，排除拦截 /login 请求 -->
        <mvc:mapping path="/**"/>
        <mvc:exclude-mapping path="/login"/>
        <bean class="cn.xx.MyInterceptor"></bean>
    </mvc:interceptor>
</mvc:interceptors>

那么在SpringBoot中是如何注册拦截器的呢？第一个动作是一样的，都需要定义一个拦截器类，第二步注册拦截器在SpringBoot中提供了一个 WebMvcConfigurer 接口，专门用来对SpirngMVC做配置。步骤如下

第一步：创建拦截器类和以前的创建方式一样

@Component
public class MyHandlerInterceptor extends HandlerInterceptorAdapter {
   
   

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
   
   
        System.out.println("preHandle................:"+request.getRequestURI());
        return super.preHandle(request, response, handler);
    }
}

第二步：注册拦截器, 在配置类上实现WebMvcConfigurer，复写addInterceptors，该方法提供了一个InterceptorRegistry专门用来注册拦截器，如下：

@SpringBootApplication
public class ApplicationConfig implements WebMvcConfigurer {
   
   

    @Autowired
    private MyHandlerInterceptor myHandlerInterceptor;

    /**
     * 注册拦截器
     * @param registry ：拦截器的注册器
     */
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
   
   
        //指定要拦截器的请求/** 代表所有， excludePathPatterns代表要排除的请求
        registry.addInterceptor(myHandlerInterceptor).addPathPatterns("/**").excludePathPatterns("/login");
    }

1.4.添加视图控制器

ViewControllers被叫做视图控制器，当项目中涉及大量的页面跳转，我们可以使用addViewControllers方法实现无业务逻辑跳转，从而减少控制器代码的编写。WebMvcConfigurer的addViewControllers方法可以实现将一个请求直接映射为视图，不需要编写控制器来实现，从而简化了页面跳转。

 @Override
    public void addViewControllers(ViewControllerRegistry registry) {
   
   
        //当访问 /xx 路径 ，自动跳转到 templates/xx.html 页面
        registry.addViewController("/xx").setViewName("xx.html");
    }

当访问/xx 定位到 templates/xx.html

2.Mybatis集成

SpringBoot集成Mybatis之前我们也回顾一下传统的Spring和Mybatis整合的步骤，重要是在Spring的xml配置中

<!--1 引入属性文件，在配置中占位使用 -->
<context:property-placeholder location="classpath*:db.properties" />

<!--2 配置数据源 -->
<bean id="datasource" class="org.apache.ibatis.datasource.pooled.PooledDataSource">
    <!--驱动类名 -->
    <property name="driver" value="${mysql.driver}" />
    <!-- url -->
    <property name="url" value="${mysql.url}" />
    <!-- 用户名 -->
    <property name="username" value="${mysql.username}" />
    <!-- 密码 -->
    <property name="password" value="${mysql.password}" />
</bean>

<!--3 会话工厂bean sqlSessionFactoryBean -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
    <!-- 数据源 -->
    <property name="dataSource" ref="datasource"></property>
    <!-- 别名 -->
    <property name="typeAliasesPackage" value="cn.whale.domian"></property>
    <!-- sql映射文件路径 -->
    <property name="mapperLocations" value="classpath*:mapper/*Mapper.xml"></property>
    <!--        <property name="configLocation" value="classpath*:mybatis-config.xml"></property>-->
    <!--        <property name="plugins"></property>-->
</bean>

<!--4 自动扫描对象关系映射 -->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
    <!-- 指定要自动扫描接口的基础包，实现接口 -->
    <property name="basePackage" value="cn.whale.mapper"></property>
</bean>

其实是非常麻烦的，那么在SpringBoot中又是如何配置的呢？

2.1.集成DataSource

集成Mybatis肯定是需要先集成DataSource,SpringBoot已经提供了自动装配DataSource功能。我们只需要在ymal中做简单配置即可。

第一步：导入依赖，我这里把连接池，驱动，mybatis全导入进来

<!-- 阿里巴巴的连接池-->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid</artifactId>
    <version>1.1.20</version>
</dependency>

<!-- mysql 数据库驱动. -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
</dependency>
<!-- mybatis的依赖 -->
<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>1.1.1</version>
</dependency>

第二步：配置DataSource

spring:
  datasource:
    username: root
    password: admin
    url: jdbc:mysql:///test?useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC
    driver-class-name: com.mysql.jdbc.Driver
    type: com.alibaba.druid.pool.DruidDataSource #指定使用druid的连接池

这里我指定了type指向了DruidDataSource连接池，如果不指定，默认会使用HikariDataSource作为连接池

2.2.集成MyBatis

集成mybatis就需要创建domain ， mapper等组件了，还要准备数据库.

第一步：User实体类如下

//lombok,自动生成get,set
@Data
public class User {
   
   
    private Long id;
    private String username;
}

第二步：mapper/UserMapper接口如下

public interface UserMapper {
   
   
    User selectAll();
}

第三步：resources/mapper/UserMapper.xml如下

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="cn.whale.mapper.UserMapper">

    <select id="selectAll" resultType="cn.whale.domain.User">
        SELECT  id,username FROM t_user
    </select>
</mapper>

第四步：数据库如下

在这里插入图片描述

第五步：配置mybatis , application.yml如下

mybatis:
  type-aliases-package: "cn.whale.domain" #别名
  mapper-locations: classpath:mapper/UserMapper.xml #扫描SQL映射文件
  #config-location: mybatis-config.xml #mybatis配置文件

第六步：配置Mapper接口扫描

@SpringBootApplication
//mapper映射器自动扫描
@MapperScan("cn.whale.mapper")
public class ApplicationConfig {
   
   
   ...
}

@MapperScan的作用等同于传统Spring配置Mybatis时配置的 MapperScannerConfigurer ，可以实现mapper映射器的自动扫描。

2.3.集成Service

第七步：编写service

public interface IUserService {
   
   
    List<User> selectAll();
}

@Service
public class UserServiceImpl implements IUserService {
   
   

    @Autowired
    private UserMapper userMapper ;

    @Override
    public List<User> selectAll() {
   
   
        return userMapper.selectAll();
    }
}

2.4.集成WEB

第八步：编写Controller

@RestController
public class UserController {
   
   

    @Autowired
    private IUserService userService;

    @RequestMapping("/users")
    public List<User> userList(){
   
   
        return userService.selectAll();
    }
}

最后结构如下
在这里插入图片描述
第九步：启动测试，效果如下

3.集成事务

在Spring中我们有两种配置事务的方式，一是在XML中使用<aop>的方式统一配置，这种方式比较麻烦新项目一般不用，二是使用注解@Transcationl注解的方式，这种方式需要开启<tx:annotation-driven 注解支持，当然两种方式都需要配置DataSourceTransactionManager 的支持，而在SpringBoot中使用简单的两个注解就可以完成啦。

3.1.注解方式事务支持

第一步：开启事务，在配置类贴上@EnableTransactionManagement ，该注解功能和<tx:annotation-driven一样是开启事务支持，只要导入了Mybatis的依赖默认情况下SpringBoot会帮我们自动创建DataSourceTransactionManager。

@SpringBootApplication
@MapperScan("cn.whale.mapper")
//开启事务支持
@EnableTransactionManagement
public class ApplicationConfig{
   
   
...}

PS:其实在SpringBoot环境中，不贴该注解也是可以的，默认就开启了的

第二步：给service添加事务，只需要在需要有事务的类上，或者方法上标记@Transactional即可

@Transactional
@Service
public class UserServiceImpl{
   
    ... }

3.2.使用xml方式配置(了解)

第一步：这种方式不推荐使用，做一个了解就可以了，首选需要导入一个依赖

 <dependency>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-starter-aop</artifactId>
 </dependency>

第二步：使用一个xml配置事务：applicationContext.xml

<!-- 配置事物管理器 -->
    <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource" />
    </bean>
<!-- 扫描哪些类需要事务支持 -->
    <aop:config>
        <aop:pointcut expression="execution(* cn.itsource.web.controller.service..*.*(..))" id="coreServicePointcut"/>
        <aop:advisor advice-ref="txAdvice" pointcut-ref="coreServicePointcut"/>
    </aop:config>

    <!-- aop应用事务管理 -->
    <tx:advice id="txAdvice" transaction-manager="transactionManager">
        <tx:attributes>
            <tx:method name="select*" read-only="true"/>
            <tx:method name="*" propagation="REQUIRED" />
        </tx:attributes>
    </tx:advice>

第三步：在配置类导入xml配置文件，让其生效

@SpringBootApplication
@MapperScan("cn.whale.mapper")
@ImportResource("classpath:applicationContext.xml")
public class ApplicationConfig{
   
   
    ...
}

4.PageHelper的集成

PageHelper是一个mybatis的分页插件，可以帮我们自动生成查询count的sql和分页limit。可以简化我们的代码，官网文档

4.1.集成pagehelper

导入pagehelper基础依赖

<dependency>
    <groupId>com.github.pagehelper</groupId>
    <artifactId>pagehelper-spring-boot-starter</artifactId>
    <version>1.2.3</version>
</dependency>

4.2.分页查询

<select id="selectPage" resultType="cn.whale.User">
    select id,username from t_user
</select>

注意:用了pagehelper之后，查询总条数的sql不用写， limit 不用写

分页查询，把查询的结果强转成Page对象，它是PageHelper提供的一个分页对象，其中包含总条数，列表，其本身继承了ArrayList.

@Override
 public Page<User> selectAll() {
   
   
     //设置分页条件，1是查询第几页，5是查询条数，通常通过参数对象传入这个2个值
     PageHelper.startPage(1,5 );
     return (Page<User>) userMapper.selectAll();
 }

PageHelper.startPage(1,5 )：设置当前页和每页条数
Page ：是pagehelper自己封装的页面对象，如同我们以前的PageList ,里面有总条数，列表，总页数等等

4.3.处理分页结果

把Page对象转成我们自己的结果对象 , 编写PageResult

@Data
@AllArgsConstructor
@NoArgsConstructor
public class PageResult {
   
   
    private Long total;
    private List<?> list;
}

编写controller逻辑

@RestController
public class UserController {
   
   

    @Autowired
    private IUserService userService;

    @RequestMapping("/users")
    public PageResult userList(){
   
   
        Page<User> page = userService.selectAll();
        return new PageResult(page.getTotal(),page.getResult());
    }
}

测试效果
在这里插入图片描述

4.4.PageHelper的配置

上面的步骤已经就可以完成PageHelper的使用了，当然也可以对PageHelper做一些个性化配置，具体见文档，比如：

pagehelper:
  helperDialect: mysql
  reasonable: true
  supportMethodsArguments: true
  params: count=countSql

helperDialect：分页插件会自动检测当前的数据库链接，自动选择合适的分页方式
reasonable：分页合理化参数，默认值为false。当该参数设置为 true 时，pageNum<=0 时会查询第一页， pageNum>pages（超过总数时），会查询最后一页。默认false 时，直接根据参数进行查询。
supportMethodsArguments ：支持通过 Mapper 接口参数来传递分页参数，默认值false，分页插件会从查询方法的参数值中，自动根据上面 params 配置的字段中取值，查找到合适的值时就会自动分页。
params ：为了支持startPage(Object params)方法，增加了该参数来配置参数映射，用于从对象中根据属性名取值，可以配置 pageNum,pageSize,count,pageSizeZero,reasonable，不配置映射的用默认值，默认值为pageNum=pageNum;pageSize=pageSize;count=countSql;reasonable=reasonable;pageSizeZero=pageSizeZero

5.使用外置Tomcat运行

在企业中，有些开发者认为SpringBoot内置的Tomcat并不是最优的选择，需要有一些自定义的配置，这个时候就需要把SpringBoot打成war包然后部署到外置的Tomcat中。

产生一个可部署war包的第一步是提供一个 SpringBootServletInitializer 子类，并覆盖它的 configure 方法，这充分利用了Spring框架对Servlet 3.0的支持，并允许你在应用通过servlet容器启动时配置它。

5.1.编写SpringBootServletInitializer实现

第一步：启动类实现SpringBootServletInitializer接口

//SpringBootServletInitializer 实现了 WebApplicationInitializer,用来使用传统的 WAR 部署运行SpringApplication 。
// 它将Servlet 、 Filter和ServletContextInitializer bean 从应用程序上下文绑定到服务器

@SpringBootApplication
@MapperScan("cn.whale.mapper")
public class ApplicationConfig extends SpringBootServletInitializer{
   
   

    public static void main(String[] args) {
   
   
        SpringApplication.run(ApplicationConfig.class,args);
    }
    //把当前配置类和
    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
   
   
        return application.sources(ApplicationConfig.class);
    }
}

5.2.修改依赖

第三步：修改依赖，排除掉SpringBoot内置的tomcat,额外提供一个tomcat，只不过scope需要指定为 provided ，因为我们有外置的Tomcat。

<dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <exclusions>
                <exclusion>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-starter-tomcat</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
            <scope>provided</scope>
        </dependency>

5.3.部署Tomcat

第四步：IDEA增加Tomcat, 点击 Edit Configurations
在这里插入图片描述
增加一个Tomcat Server

发布项目

配置Tomcat

注意：SpringBoot 2x以上请使用Tomcat 8 以上，否则回出错

5.4.启动Tomcat

点击启动按钮启动项目
在这里插入图片描述
浏览器访问：http://localhost:8080/users ，效果如下

文章就到这把，喜欢请给个好评，喜欢请给个好评，喜欢请给个好评

SpringBoot入门到精通-SpringBoot集成WEB开发(四)

前言

五.SpringBoot集成SSM

1.WEB集成

1.1.集成Thymeleaf

1.2.webjars

1.3.注册拦截器

1.4.添加视图控制器

2.Mybatis集成

2.1.集成DataSource

2.2.集成MyBatis

2.3.集成Service

2.4.集成WEB

3.集成事务

3.1.注解方式事务支持

3.2.使用xml方式配置(了解)

4.PageHelper的集成

4.1.集成pagehelper

4.2.分页查询

4.3.处理分页结果

4.4.PageHelper的配置

5.使用外置Tomcat运行

5.1.编写SpringBootServletInitializer实现

5.2.修改依赖

5.3.部署Tomcat

5.4.启动Tomcat

热门文章

最新文章

相关课程

相关电子书

相关实验场景

热门

活动广场

任务中心

开发者评测

高校计划

乘风者计划

训练营

阿里云MVP

话题

直播

下载

镜像站

技术资料

插件

SpringBoot入门到精通-SpringBoot集成WEB开发(四)

前言

五.SpringBoot集成SSM

1.WEB集成

1.1.集成Thymeleaf

1.2.webjars

1.3.注册拦截器

1.4.添加视图控制器

2.Mybatis集成

2.1.集成DataSource

2.2.集成MyBatis

2.3.集成Service

2.4.集成WEB

3.集成事务

3.1.注解方式事务支持

3.2.使用xml方式配置(了解)

4.PageHelper的集成

4.1.集成pagehelper

4.2.分页查询

4.3.处理分页结果

4.4.PageHelper的配置

5.使用外置Tomcat运行

5.1.编写SpringBootServletInitializer实现

5.2.修改依赖

5.3.部署Tomcat

5.4.启动Tomcat

热门文章

最新文章

相关课程

相关电子书

相关实验场景