跳至主要內容

yange大约 18 分钟教学管理系统MysqlApifoxServletHTTPGETPOST

1. 软件开发和项目介绍 🍐

1.1 软件开发整体介绍 🍐

软件开发整体介绍

作为一名软件开发工程师,我们需要了解在软件开发过程中的开发流程， 以及软件开发过程中涉及到的岗位角色，角色的分工、职责， 并了解软件开发中涉及到的三种软件环境。那么这一小节，我们将从 三个方面，来整体上介绍一下软件开发。

软件开发流程

软件开发流程 🍐

image
image
岗位/角色职责/分工
项目经理对整个项目负责，任务分配、把控进度
产品经理进行需求调研，输出需求调研文档、产品原型等
UI 设计师根据产品原型输出界面效果图
架构师项目整体架构设计、技术选型等
开发工程师功能代码实现
测试工程师编写测试用例，输出测试报告
运维工程师软件环境搭建、项目上线

角色分工是在一个项目组中比较标准的角色分工, 但是在实际的项目中, 有一些项目组由于人员配置紧张,
可能并没有专门的架构师或测试人员, 这个时候可能需要有项目经理或者程序员兼任

总结

课堂作业

  1. 请回答软件的开发流程是什么？🎤
  2. 请回答软件开发过程中，有哪些角色，以及实际工作中这些角色都需要招聘吗？
  3. 测试环境和生产环境有什么区别？

1.2 整体业务流程 🍐

整体业务流程

背景和业务
资料文件
资料文件
  1. 可以通过查看原型图，了解项目背景和业务

原型可以直接通过浏览器打开

  1. 可以通过查看接口文档，了解项目接口，完成代码开发

接口文档通过下面的软件查看

image
image

软件官网：https://typoraio.cn/

2. 项目构建 ✏️ ❤️

2.1 项目环境搭建 ✏️ ❤️

项目环境搭建

后端代码初始化

参考笔记：后端代码初始化

项目名字：tms (teaching_manage_system)

依赖需要加上：可以查看之前的笔记，这里就不再赘述

  • spring-boot-starter-web
  • spring-boot-starter-test
  • lombok
  • mybatis-plus-boot-starter
  • mysql-connector-java
  • mybatis-spring
  • hutool-all
  • 还需要导入通用结果类AjaxResult到config包下

也就是之前的所有依赖和插件

项目结构图
项目结构图

总结

课堂作业

  1. 参考上述步骤完成项目环境搭建，不会多看几遍🎤

3. 部门模块

3.1 部门列表查询

部门列表查询

需求

需求：查询数据库表中的所有部门数据，展示在页面上。

image-20231130190642478
image-20231130190642478

代码操作

开始编码

1️⃣ 1. 准备数据库表 dept 及 实体类 Dept

image
image

实体类放到pojo包中

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.time.LocalDateTime;

@Data
@NoArgsConstructor
@AllArgsConstructor
public class Dept {
    private Integer id;
    private String name;
    private LocalDateTime createTime;
    private LocalDateTime updateTime;
}

2️⃣ 2. 定义mapper包，并且定义DeptMapper接口继承BaseMappper接口，并声明接口方法。

@Mapper
public interface DeptMapper extends BaseMapper<Dept> {
   
}

3️⃣ 3. 在controller包中创建DeptController，并编写接口方法

参考接口文档的接口定义，编写接口方法

image
image
@RestController
public class DeptController {

    @Autowired
    private DeptMapper deptMapper;

    @GetMapping("/depts")
    public AjaxResult findAll(){
        List<Dept> deptList = deptMapper.selectList(null);
        return AjaxResult.success(deptList);
    }
}

4️⃣ 4. 启动服务，打开apifox进行测试

image-20231130192402337
image-20231130192402337
image
image

​

总结

课堂作业

  1. 参考上述步骤完成部门列表查询，不会多看几遍🎤

3.2 删除部门

删除部门

需求分析

删除部门数据。在点击 "删除" 按钮，会根据ID删除部门数据。

image-20231130200858803

了解了需求之后，我们再看看接口文档中，关于删除部门的接口的描述，然后根据接口文档进行服务端接口的开发。

image-20231130201306202

思路分析

明确了删除部门的需求之后，再来梳理一下实现该功能时，三层架构每一层的职责：

  • 前端：发送请求，展示数据
  • 服务端控制层：接收请求，调用Mapper接口，操作数据库, 返回结果

代码操作

代码实现

1️⃣ 1. 在controller包中创建DeptController，参考接口文档，并编写接口方法
image

    /**
     * 删除部门
     */
    @DeleteMapping("/depts")
    public AjaxResult delete(Integer id){
        System.out.println("删除部门: " + id);
        deptMapper.deleteById(id);
        return AjaxResult.success();
    }

2️⃣ 代码编写完毕之后，我们就可以启动服务，进行测试了。

image
image

并且观察idea的控制台，mp的日志，可以看到数据库的删除操作。

image
image

总结

课堂作业

  1. 参考上述步骤完成部门删除，不会多看几遍🎤

3.3 新增部门

新增部门

需求

点击 "新增部门" 的按钮之后，弹出新增部门表单，填写部门名称之后，点击确定之后，保存部门数据。

image-20231130204018116

了解了需求之后，我们再看看接口文档中，关于新增部门的接口的描述，然后根据接口文档进行服务端接口的开发 。

image-20231130204242647

思路说明

明确了新增部门的需求之后，再来梳理一下实现该功能时，三层架构每一层的职责：

image-20231130204542046

Mapper这里采用MybatisPlus自动生成sql语句，所以不需要我们手写sql语句。

代码操作

代码实现

1️⃣ 1. Controller层

我们看到，在controller中，需要接收前端传递的请求参数。 那接下来，我们就先来看看在服务器端的Controller程序中，如何获取json格式的参数。

  • JSON格式的参数，通常会使用一个实体对象进行接收 。

  • 规则：JSON数据的键名与方法形参对象的属性名相同，并需要使用@RequestBody注解标识。

image
image

2️⃣ 代码编写完毕之后，我们就可以启动服务，进行测试了。

image
image

并且观察idea的控制台，mp的日志，可以看到数据库的新增操作。

image
image

总结

课堂作业

此时发现，每个方法的路径都是/dept 那么我们可以将这个路径提取到Controller层，然后通过@RequestMapping注解，将路径提取到方法上。

image
image

接下来，参考上述步骤完成部门新增，不会多看几遍🎤

3.4 修改部门

前言

对于任何业务的修改功能来说，一般都会分为两步进行：查询回显、修改数据。

image-20231130205835988
查询回显

查询回显

需求分析

当我们点击 "编辑" 的时候，需要根据ID查询部门数据，然后用于页面回显展示。

image-20231130210023866
image-20231130210023866

明确了根据ID查询部门的需求之后，再来梳理一下实现该功能时，三层架构每一层的职责：

image-20231130210148744

了解了需求之后，我们再看看接口文档中，关于根据ID查询部门的接口的描述，然后根据接口文档进行服务端接口的开发 。

image-20231130210450314

路径参数接收

/depts/1，/depts/2 这种在url中传递的参数，我们称之为路径参数。 那么如何接收这样的路径参数呢 ？

路径参数：通过请求URL直接传递参数，使用{…}来标识该路径参数，需要使用 @PathVariable 获取路径参数。如下所示：

image
image

接下来，重启服务，进行测试。

image
image

4. 日志技术

日志技术

定义

什么时日志？

日志就好比生活中的日记，可以随时随地记录你生活中的点点滴滴。

程序中的日志，是用来记录应用程序的运行信息、状态信息、错误信息的。

  • 为什么要在程序中记录日志呢？

    • 便于追踪应用程序中的数据信息、程序的执行过程。
    • 便于对应用程序的性能进行优化。
    • 便于应用程序出现问题之后，排查问题，解决问题。
    • 便于监控系统的运行状态。
    • ... ...

  • 之前我们编写程序时，也可以通过 System.out.println(...) 来输出日志，为什么我们还要学习单独的日志技术呢？

    这是因为，如果通过 System.out.println(...) 来记录日志，会存在以下几点问题：

    • 硬编码。所有的记录日志的代码，都是硬编码，没有办法做到灵活控制，要想不输出这个日志了，只能删除掉记录日志的代码。
    • 只能输出日志到控制台。
    • 不便于程序的扩展、维护。

所以，在现在的项目开发中，我们一般都会使用专业的日志框架，来解决这些问题。

代码操作

Slf4j(酸辣粉使用教程)

入门案例

几个常用的 lombok 注解：

  1. @Data：注解在类上；提供类所有属性的 getting 和 setting 方法，此外还提供了equals、canEqual、hashCode、toString 方法
  2. @Setter：注解在属性上；为属性提供 setting 方法
  3. @Getter：注解在属性上；为属性提供 getting 方法
  4. @SneakyThrows：无需在签名处显式抛出异常
  5. @Log4j：注解在类上；为类提供一个 属性名为log 的 log4j 日志对像,用作日志输出的，一般会在项目每个类的开头加入该注解
  6. @Slf4j: 同上
  7. @NoArgsConstructor：注解在类上；为类提供一个无参的构造方法
  8. @AllArgsConstructor：注解在类上；为类提供一个全参的构造方法

为什么使用@Slf4j？

为了能够少写两行代码，不用每次都在类的最前边写上： private static final Logger logger = LoggerFactory.getLogger(this.XXX.class);

使用步骤：

1. 在springboot项目下的pom.xml 导入下列依赖 如果已经存在，就不需要重新导入

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.28</version>
</dependency>

2. 在类名上加上注解 @Slf4j

image
image

运行结果：

image
image

3. 占位符 {} 非常好用

//占位符：日志输出中{}很好用
@Test
public void test2(){
    log.info("测试日志info：{}","yangeit");
    log.warn("测试日志warn：{},{}",1,6);
}

运行结果：
image

知识最好的留存率(90%)是教授他人
Copyright © 2025 yange