自学内容网 自学内容网

阶段三:项目开发---搭建项目前后端系统基础架构:任务10:SpringBoot框架的原理和使用

任务描述

1、熟悉SpringBoot框架的原理及使用

2、使用IDEA创建基于SpringBoot、MyBatis、MySQL的Java项目

3、当前任务请在client节点上进行

任务指导

1、SpringBoot框架的选择和原理

2、MyBatis-Plus的选择和原理

3、使用IDEA创建基于SpringBoot+MyBatis-Plus+MySQL的Java项目

4、测试SpringBoot项目的基本使用

任务实现

提示:

当前任务在 client节点上进行。

任务使用的IntelliJ IDEA Ultimate版本,只有30天免费使用期;需要自行申请教育ID(免费使用)。

1、SpringBoot框架的选择和原理

    本项目是民航大数据平台的缩影,本系统数据量大并涉及大数据的处理,需要进行后端的分离,并且后端选择分布式的成熟框架。

    Spring Boot是由Pivotal团队提供的全新框架,其设计目的是用来建行新Spring应用的初始搭建及开发过程。该框架使用了特定的方式来进行配置,从而使开发人员不需要定义样板化的配置。

    SpringBoot所具备的特征:

  • 可以创建独立的Spring应用程序,并且基于其Maven或Gradle插件,可以创建可执行的JARs和WARs;
  • 内嵌Tomcat或Jetty等Servle容器;
  • 提供自动配置的”starter”项目对象模型(POMS)以简化Maven配置;
  • 尽可能自动配置Spring容器;
  • 提供准备好的特性,如指标、健康检查和外部化配置;
  • 没有代码生成,不需要配置XML配置。

2、MyBatis-Plus

  • MyBatis-Plus 是一个 MyBatis增强版工具,在 MyBatis 上扩充了其他功能没有改变其基本功能,为了简化开发提交效率而存在。

官网地址:https://mp.baomidou.com/

MyBatis-Plus 特性:https://baomidou.com/pages/24112f/#%E7%89%B9%E6%80%A7

  • 在IDEA中创建SpringBoot程序,并使用MyBatis-Plus,首先需要在IDEA中安装MyBatis-Plus插件

3、使用IDEA创建SpringBoot项目

  • 双击桌面上的“ideaU”图标,打开IDEA工具
  • 点击“+ Create New Project”,开始创建一个新项目:

  • 在左侧菜单找到Spring Initializr,点击Next。注意,这里IDEA默认使用https://start.spring.io  提供的在线模板,所以需要保证网络畅通。当然也可以选择Custorm指定链接加载模版。例如,如果出现start.spring.io服务器连接异常或超时的情况,可以修改Server URL,将在线模板服务器设置为国内的服务器,如下所示:

  • 按照实际情况依次填写项目信息。Type是Maven或者Gradle,选择JDK版本,Packaging属性下可以选择jar或者war等,填写完毕点击Next:

  • 选择Web-->Spring Web Services,点击Next:

注意,这里Spring Boot选择任意版本即可,例如:在图中使用的是2.7.11,但是在实际环境中Spring Boot的版本是动态变化的,请根据自己当前的环境进行设置,一般来说选择一个2.7.x的任意版本都可以。

  • 点击Finish,完成创建。
  • 等待IDEA构建好项目后,项目结构如下图所示:

  • 在IDEA中创建SpringBoot程序,并使用MyBatis-Plus,首先需要在IDEA中安装MyBatis-Plus插件

依次点击 File --> Settings,在打开的面板中选择 Plugins,搜索 MyBatisX并安装即可:

  • 项目会下载所需的依赖包,需要待较长的时间,所以可以自行下载安装Maven,并配置国内仓库源

1)从官方网站下载最新版本即可,中文网下载地址: https://maven.org.cn/download.html ,注意,Maven 3.9+ requires JDK 8 or above to execute. It still allows you to build against 1.3 and other JDK versions by using toolchains。当前项目环境已经提供了安装文件,存放在Client节点的/opt/software目录下。

2)进入/opt/software目录,解压安装Maven到/opt/目录下

[root@client ~]# cd /opt/software
[root@client software]# tar -zxvf apache-maven-3.9.1-bin.tar.gz -C /opt/

3)配置Maven使用国内源,进入Maven配置目录 (例如:/opt/apache-maven-3.9.1/conf)

[root@client software]# cd /opt/apache-maven-3.9.1/conf
[root@client conf]# vim settings.xml 

4)修改settings.xml文件,在<mirrors></mirrors>标签内将其他的<mirror>标签注释掉或删除掉,然后添加如下内容:

<mirror>
<id>huaweicloud</id>
<mirrorOf>*</mirrorOf>
<url>https://mirrors.huaweicloud.com/repository/maven/</url>
</mirror>

  • 在IDEA工具中配置使用上一步安装配置好的Maven插件

1)依次点击 “File”->"Settings",打开设置面板,然后找到“Build,Execution,Deployment”->“Build Tools”->“Maven”

2)设置如下内容,来配置Maven插件

  • 查看pom.xml文件,项目所需依赖都在这里,此时项目会下载所需的依赖包,需要待一段时间

为了支持MyBatis-Plus需要在<dependencies> </dependencies>标签内添加MyBatis-Plus的相关依赖:

<dependency>
     <groupId>com.baomidou</groupId>
     <artifactId>mybatis-plus-boot-starter</artifactId>
     <version>3.4.1</version>
</dependency>

还需添加MySQL相关依赖,为了简化代码,引入 lombok 依赖(减少 getter、setter 等方法):

<dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>8.0.18</version>
</dependency>
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.10</version>
</dependency>

点击如下图所示图标,更新Maven引用:

替换启动类(DemoApplication.java)头部声明

@SpringBootApplication(exclude= {DataSourceAutoConfiguration.class})

启动项目:

启动成功后显示访问端口8080。

停止项目:

4、实现REST请求

  • 创建项目结构

首先我们在com.example.demo包下,分别创建model包(用于存放model)、dao包(用于存放数据访问文件)、controller包(用于存放控制器)、service包(用于存放主要的程序逻辑代码)。

右键com.example.demo选择New-->Package创建包

创建com.example.demo.model包

按照上述方式继续创建dao包、controller包、service包,项目结构如下:

  • 实现model

在model包中创建一个Java Class文件,名为Test.java,并写入以下内容:

package com.example.demo.model;

public class Test {
private final long id;
private final String content;
public Test(long id,String content) {
this.id = id;
this.content = content;
}
public long getId() {
return id;
}
public String getContent() {
return content;
}
}
  • 实现Controller

在controller包中创建一个Java Class文件,名为TestController.java,并写入以下内容:

package com.example.demo.controller;

import java.util.concurrent.atomic.AtomicLong;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import com.example.demo.model.Test;

@RestController
public class TestController {
private static final String template = "Hello,%s!";
private final AtomicLong counter = new AtomicLong();
@RequestMapping("/test")
public Test dealTest(@RequestParam(value="name", defaultValue="World") String name) {
return new Test(counter.incrementAndGet(),String.format(template, name));
}
}
  • 打开DemoApplication.java文件,启动项目

控制台选项卡会打印运行日志,如下我们可以看到监听到本地8080端口。

  • 打开浏览器,访问页面

刷新页面,可以看到计数器加1后的效果:

5、创建定时器

使用SpringBoot基于注解来创建定时任务非常简单,代码如下。

  • 在com.example.demo包下,创建task包,并在task包中创建一个Java Class文件,名为StaticScheduleTask.java
package com.example.demo.task;

import org.springframework.context.annotation.Configuration;
import org.springframework.scheduling.annotation.EnableScheduling;
import org.springframework.scheduling.annotation.Scheduled;

@Configuration      //1.主要用于标记配置类,兼备Component的效果。
@EnableScheduling   // 2.开启定时任务
public class StaticScheduleTask {
//3.添加定时任务,每隔5秒打印一次“Schedule Task”
@Scheduled(cron = "0/5 * * * * ?")
private void testTask() {
System.out.println("Schedule Task");
}
}
  • 修改启动文件DemoApplication.java,开启定时任务
package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.scheduling.annotation.EnableScheduling;
import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration;

@EnableScheduling //开启定时任务
@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})
public class DemoApplication {
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
}
  • 运行项目,会在控制台显示定时任务,打印的结果,每隔5秒打印一次“Schedule Task”

6、测试MyBatis-Plus的使用

  • 在node3节点上,进入mysql客户端命令行模式
[root@node3 ~]# mysql -uroot -p123456
  • 创建一个MySQL表,并添加一些测试数据:
DROP DATABASE IF EXISTS testMyBatisPlus;

CREATE DATABASE testMyBatisPlus;

USE testMyBatisPlus;

DROP TABLE IF EXISTS user;

CREATE TABLE user
(
    id BIGINT(20) NOT NULL COMMENT '主键ID',
    name VARCHAR(30) NULL DEFAULT NULL COMMENT '姓名',
    age INT(11) NULL DEFAULT NULL COMMENT '年龄',
    email VARCHAR(50) NULL DEFAULT NULL COMMENT '邮箱',
    PRIMARY KEY (id)
);

INSERT INTO user (id, name, age, email) VALUES
(1, 'Jone', 18, 'test1@baomidou.com'),
(2, 'Jack', 20, 'test2@baomidou.com'),
(3, 'Tom', 28, 'test3@baomidou.com'),
(4, 'Sandy', 21, 'test4@baomidou.com'),
(5, 'Billie', 24, 'test5@baomidou.com');
  • 返回Client节点,在项目的resources目录添加 application.yml 文件,在文件中配置 mysql 数据源信息(注意:缩进
spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    username: root
    password: 123456
    url: jdbc:mysql://node3:3306/testMyBatisPlus?autoReconnect=true&autoReconnectForPools=true&failOverReadOnly=false&serverTimezone=UTC

如上url中的node3不建议修改为IP地址,在真实开发过程中测试环境与生产环境的IP地址不一样。

  • 在com.example.demo包下创建entity包,用于存放实体类,在entity包中创建数据库中user表对应的实体类User.java类:
package com.example.demo.entity;

import lombok.Data;

@Data
public class User {
    private Long id;
    private String name;
    private int age;
    private String email;
}
  • 在com.example.demo包下创建mapper包,用于存放数据操作类,在mapper包中创建操作数据表实体类的Mapper类UserMapper.java,该类直接继承BaseMapper,可以省去xml的编写,当然也支持通过xml自定义sql查询语句:
package com.example.demo.mapper;

import com.example.demo.entity.User;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;

public interface UserMapper extends BaseMapper<User> {
}

BaseMapper里封装了一些常用的CRUD方法:

  • 实体类、Mapper 类都写好了,就可以使用了,首先需要在启动类DemoApplication 里扫描 Mapper 类,即添加 @MapperScan 注解,修改后的DemoApplication文件内容如下:
package com.example.demo;

import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration;

@MapperScan("com.example.demo.mapper")
@SpringBootApplication
public class DemoApplication {

    public static void main(String[] args) {

        SpringApplication.run(DemoApplication.class, args);
    }
}
  • 在src/test/java/com/example/demo/包下,创建一个测试类TestMybatisPlusApplicationTests.java 测试一下
package com.example.demo;

import com.example.demo.entity.User;
import com.example.demo.mapper.UserMapper;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;

import java.util.List;

@SpringBootTest
class TestMybatisPlusApplicationTests {

    @Autowired
    private UserMapper userMapper;

    @Test
    public void testSelect() {
        System.out.println(("----- selectAll method test ------"));
        List<User> userList = userMapper.selectList(null);
        for(User user:userList) {
            System.out.println(user);
        }
    }
}
  • 注意:MyBatis-plus与Spring的版本有兼容性的要求,例如mybatis-plus-boot-starter 3.4.1对应的Spring的版本使用2.4.5,否则可能会出现与MybatisPlus不兼容的情况,当然也可以选择其他相兼容的版本。
  • 所以需要修改pom.xml,将spring-boot-starter-parent的版本改为2.4.5,mybatis-plus-boot-starter 版本为3.4.1
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.4.5</version>

    </parent>
    <groupId>com.example</groupId>
    <artifactId>demo</artifactId>
    <version>0.0.1-SNAPSHOT</version> 
    <name>demo</name>
    <description>Demo project for Spring Boot</description>
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web-services</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.4.1</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.10</version>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>
  • 更新Maven依赖

  • 运行测试类


原文地址:https://blog.csdn.net/qq_60872637/article/details/140244452

免责声明:本站文章内容转载自网络资源,如本站内容侵犯了原著者的合法权益,可联系本站删除。更多内容请关注自学内容网(zxcms.com)!