SpringBootWeb综合项目案例学习笔记

在学习了前端的一些相关基础，前后端发送请求、三层架构、分层解耦、Springboot后端工程、基于jdbc的开发框架Mybatis框架等技术后，现在进行一个综合的项目案例，对前面知识进行总结，并完成了一个入门级别项目，对之前知识进行查缺补漏。

涉及技术：

涉及开发环境：IDEA，DataBase，postman

环境搭建

前端的代码我已看懂为目的，并且也是听的黑马程序员的2023年javaweb的课程，所以下面的资料都是黑马程序员的，涉及到版权问题，及时沟通，我会立刻删帖吗，前端部分我都是用的黑马程序员的资料中已经开发好的页面。

创建数据库表(dept,emp）

 

 创建Springboot工程，引入对应的起步依赖（web,mybatis,mysql驱动,lombok）

pom.xml依赖文件
<?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.7.5</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.itheima</groupId>
    <artifactId>tlias-web-management</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>tlias-web-management</name>
    <description>Demo project for Spring Boot</description>
    <properties>
        <java.version>11</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
<!--        mybatis起步依赖-->
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>2.2.2</version>
        </dependency>

        <!--        mysql的驱动包,刚刚发布的最新版本的驱动包-->
        <dependency>
            <groupId>com.mysql</groupId>
            <artifactId>mysql-connector-j</artifactId>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <!--        druid连接池-->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid-spring-boot-starter</artifactId>
            <version>1.2.8</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter-test</artifactId>
            <version>2.3.1</version>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <excludes>
                        <exclude>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                        </exclude>
                    </excludes>
                </configuration>
            </plugin>
        </plugins>
    </build>

</project>

 配置文件application.properties中引入mybatis的配置信息，准备对应的实体类

application.properties文件

两个实体类

Emp实体类

package com.itheima.pojo;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

import java.time.LocalDate;
import java.time.LocalDateTime;

@Data
@AllArgsConstructor
@NoArgsConstructor
public class Emp {
    private Integer id;//ID
    private String username;//用户名
    private String password;//密码
    private String name;//姓名
    private Short gender;//性别 1男 2女
    private String image;//图像
    private Short job;//职位 1班主任 2讲师 3学工主管 4教研主管 5咨询师
    private LocalDate entrydate;//入职日期
    private Integer deptId;//部门ID
    private LocalDateTime createTime;//创建时间
    private LocalDateTime updateTime;//修改时间
}
Dept实体类
package com.itheima.pojo;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

import java.time.LocalDateTime;

@Data
@AllArgsConstructor
@NoArgsConstructor
public class Dept {
    private Integer id;//ID
    private String name;//部门名称
    private LocalDateTime createTime;//创建时间
    private LocalDateTime updateTime;//修改时间
}

准备对应的Mapper、Service（接口、实体类）、Controller基础结构三层架构

在准备好的三层架构的对应位置添加好spring的注解，方便加载一个个bean

DeptController、EmpController加RestController

DeptMapper、EmpMapper加Mapper

DeptServiceImpl、EmpServiceImpl加Service

开发规范：

案例基于当前最为主流的前后端分离模式进行开发。查询接口文档查看开发规范

Restful   REST风格

Get：查询操作 Post：新增操作 Put：修改操作 Delete：删除id为1的用户

【注意】：Rest是风格，是约定方式，约定不是规定，可以打破。描述模块的功能通常使用负数，也就是加s的格式来描述，表示此类资源，而非单个资源。如：user、emps....

同时开发规范-使用统一响应结果Result

开发流程

1.查询页面原型明确需求  2.阅读接口文档  3.思路分析  4.接口开发  5.接口测试  6。前后端联调

部门管理

查询部门

DeptController：1.接收请求 2.调用service查询部门 3.响应

DeptService：1.调用mapper接口查询

DeptMapper：1.select * from dept;

业务开发顺序：Controller层负责接收前端发来的异步请求，并通过调用service层获取数据，service层调用mapper接口来获取全部部门数据，mapper接口向数据库发送sql语句查询全部部门，并把得到的数据封装到list集合当中，最终将集合数据返回给Service层，Service继续返回给controller，controller拿到数据最终返回给前端

 

前后端联调

启动nginx，访问测试:http://localhost:90

后端的服务器打开，并且访问部门管理能够看到数据成功加载出来即可

删除部门

DeptController：1.接收请求 2.调用service根据id删除信息 3.响应

DeptService：1.调用mapper接口根据id删除信息

DeptMapper：1.delete from dept where id = ?;

业务开发顺序：Controller层负责接收前端发来的异步请求，并通过调用service层获取数据，service层调用mapper接口来获取id部门数据，mapper接口向数据库发送sql语句根据id删除，并把得到的数据封装到list集合当中，最终将集合数据返回给Service层，Service继续返回给controller，controller拿到数据最终返回给前端

前后端联调

删除了最后两个部门的信息 

新增部门

DeptController：1.接收请求 2.调用service新增部门 3.响应 @PostMapping @RequestBody

DeptService：1.补充基本属性2.调用mapper接口执行新增操作

DeptMapper：1.insert into dept values(?,?,?);

业务开发顺序：Controller层负责接收前端发来的异步请求，并通过调用service层获取数据，service层将属性补充完全后调用mapper接口来获取完整数据，mapper接口向数据库发送sql语句插入一条数据，并把最终得到的数据封装到list集合当中，最终将集合数据返回给Service层，Service继续返回给controller，controller拿到数据最终返回给前端

 前后端联调

新增了后面两条数据

【发现】：在Controller中的所有Mapping 的路径中共同都有/depts可以将它进行优化

在Controller上面定义注解@RequestMapping("/depts")(并在后面抽取出共有路径)

【注意】：一个完整的请求路径，应该是类上的@RequestMapping的value属性+方法上的@RequestMapping的value属性

修改部门

根据ID查询信息，进行表单的回显数据

DeptController：1.接收请求 2.调用service查询部门 3.响应 @GetMapping @PathVariable

DeptService：1.调用mapper接口执行查询操作

DeptMapper：1.select name,create_time,update_time from dept where id = ?

业务开发顺序：Controller层负责接收前端发来的异步请求，并通过调用service层获取数据，service层调用mapper接口来获取完整数据，mapper接口向数据库发送sql语句查询数据，并把最终得到的数据封装到list集合当中，最终将集合数据返回给Service层，Service继续返回给controller，controller拿到数据最终返回给前端

【注意】：回显的时候所有的返回值用的是Dept 

修改部门

DeptController：1.接收请求 2.调用service修改部门 3.响应 @PutMapping @PathVariable

DeptService：1.调用mapper接口执行查询操作

DeptMapper：1.update dept set name = ? where id = ?

业务开发顺序：Controller层负责接收前端发来的异步请求，并通过调用service层获取数据，service层调用mapper接口来获取完整数据，mapper接口向数据库发送sql语句修改数据，并把最终得到的数据封装到list集合当中，最终将集合数据返回给Service层，Service继续返回给controller，controller拿到数据最终返回给前端

 【注意】：重新修改的名称不能与已有字段值的名称相同，因为部门名称添加了唯一约束

员工管理

分页查询

分页查询语法：参数1：起始索引 0为第一条   参数2：查询返回记录数   (页码-1)* 每页展示记录数

EmpController 1.接收分页参数page、pageSize 2.调用Service进行分页查询，获取PageBean

EmpService 1.调用mapper接口查询总记录数total  2.调用mapper接口获取数据列表 rows 3.组装PageBean对象返回

EmpMapper 1.select count(*) from emp; 2.select *from emp limit ?,?;

准备工作，编写分页需要的实体类，定义总记录数和当前页数据列表两个属性

注意用@RequestParam的属性defaultValue可以来设置参数的默认值

 上述分页查询的代码实现，步骤固定代码繁琐，使用分页插件PageHelper优化  

导入插件的依赖

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

Mapper层

Service层

分页查询（带条件）

EmpController 1.接收参数(分页参数) 2.调用service进行分页条件查询获取PageBean3.响应

EmpService 1.使用PageHelper完成分页条件查询 2.封装PageBean对象，返回

EmpMapper 1.select * from emp where name like concat('%',?,'%') and gender = ? and entrydate between ? and ? order by update_time desc;

使用注解@DateTimeFormat 才可以将后端的参数发送给前端   注解中的pattern可以设置日期的格式例如 yyyy-MM-dd

通过动态SQL进行编写SQL语句实现条件查询，使用XML映射文件的形式定义sql语句

删除员工

 新增员工

文件上传

简介

文件上传，是指将本地图片、视频、音频等文件上传到服务器，供其他用户浏览或下载的过程

文件上传在项目中应用非常广泛，我们经常发微博、发朋友圈都用到了文件上传功能

type指定file表单项，表单提交方式要使用post   enctype指定表单的编码格式（因为普通的表单编码格式是不适合上传大的二进制格式文件的）

【注意】：要想接收到前端的文件类型的数据，需要引入的参数的参数类型是MultipartFile

本地存储

在服务端，接收到上传上来的文件之后，将文件存储在本地服务器磁盘中

本地存储到D盘下的image文件夹下，并同时解决掉了不同用户一起上传相同名字的文件而产生的文件丢失的bug

本地的存储，在Springboot中，文件上传，默认单个文件允许最大大小为1M.如果需要上传大文件，可以进行下面的application.properties中配置：

本地存储存在的缺点：前端页面无法直接访问，服务端可能遇到磁盘满了或者磁盘坏了的情况

MultipartFile中的常用API

String getOriginalFilename();//获取原始文件名

void transferTo(File dest);//将接收的文件转存到磁盘文件中

long getSize();//获取文件的大小，单位：字节

byte[] getBytes();//获取文件内容的字节数组

InputStream getInputStream();//获取接收到的文件内容的输入流

阿里云OSS

阿里云是阿里巴巴集团旗下全球领先的云计算公司，也是国内最大的云服务提供商

阿里云对象存储OSS是一款海量、安全、低成本、高可靠的云存储服务。使用OSS，您可以通过网络随时存储和调用包括文本、图片、音频和视频等在内的各种文件

第三方服务-通用思路

准备工作   参照官方SDK编写入门程序     集成使用

SDK：软件开发工具包，包括辅助软件开发的依赖（jar包）、代码实例等，都可以叫做SDK

阿里云oss-使用步骤

1.注册阿里云（实名认证）2.充值3.开通对象存储服务OSS4.创建bucket 5.获取AccessKey  6.参照官方SDK编写入门程序  7. 案例集成OSS 

Bucket：存储空间是用户用于存储对象（Object 就是文件）的容器，所有的对象都必须隶属于某个存储空间

阿里云OSS-集成

1.接收上传的图片2.将图片储存起来（OSS）3.返回图片访问的url

引入阿里云OSS上传文件工具类（有官方的示例代码改造而来）

上传图片接口开发

修改员工

查询回显

修改员工

 

 

 

配置文件

将之前与oss相连的工具类的配置信息放大application.properties中这样便于维护和管理

在配置文件中定义四个需要的配置字段 

@Value注解通常用于外部配置的属性注入，具体用法为：@Value（"${配置文件中的key}"）

配置文件配置格式

xml臃肿

application.properties 层级结构不清晰

application.yml/application.yaml简介、数据为中心

yml基本语法：

1.大小写敏感

2.数值前面必须有空格，作为分隔符

3.使用缩进表示层级关系，缩进时，不允许使用Tab键，只能用空格（idea中会自动将Tab转换为空格）

4.缩进的空格数目不重要，只要相同层级的元素左侧对齐即可

5.#表示注解，从这个字符一直到行尾，都会被解析器忽略

yml数据格式

1.对象/Map集合：

user:

    name:zhangsan

    age:18

    password:123456

2.数组/List/Set集合：

hobby:

  -java

  -game

  -sport

将案例中的properites配置文件改成yml的配置文件模式

@ConfigurationProperties

 导入阿里云的相关依赖

 @ConfigurationProperties与@Value

相同点：都是用来注入外部配置的属性的

不同点：@Value注解只能一个一个的进行外部属性的注入  @ConfigurationProperties可以批量的将外部的属性配置注入到bean对象的属性中。