【博客系统】博客系统第一弹：博客系统项目配置、MyBatis-Plus 实现 Mapper 接口、处理项目公共模块：统一返回结果、统一异常处理

---

案例综合练习 - 博客系统

---

本节目标

1. 从 0 到 1 完成博客系统后端项目的开发。

---

前言

通过前面课程的学习，我们掌握了 Spring 框架和 MyBatis 的基本使用，并完成了图书管理系统的常规功能开发。接下来我们系统地从 0 到 1 完成一个项目的开发。

---

项目介绍

---

使用 SSM 框架实现一个简单的博客系统，共 5 个页面：

1. 用户登录
2. 博客发表页
3. 博客编辑页
4. 博客列表页
5. 博客详情页

功能描述：用户登录成功后，可以查看所有人的博客。点击“查看全文”可以查看该博客的正文内容。如果该博客作者为当前登录用户，可以完成博客的修改和删除操作，以及发表新博客。（前端页面随课堂资料一起提供）

---

页面预览

---

• 用户登录

• 博客列表页

• 博客详情页

• 博客发表/修改页

---

数据准备

---

建表 SQL：

-- 建表 SQL
create database if not exists java_blog_spring charset utf8mb4;use java_blog_spring;-- 用户表
DROP TABLE IF EXISTS java_blog_spring.user_info;
CREATE TABLE java_blog_spring.user_info(
`id` INT NOT NULL AUTO_INCREMENT,
`user_name` VARCHAR (128) NOT NULL,
`password` VARCHAR (128) NOT NULL,
`github_url` VARCHAR (128) NULL,
`delete_flag` TINYINT (4) NULL DEFAULT 0,
`create_time` DATETIME DEFAULT now(),
`update_time` DATETIME DEFAULT now() ON UPDATE now(),
PRIMARY KEY (id),
UNIQUE INDEX user_name_UNIQUE (user_name ASC)) ENGINE = INNODB DEFAULT CHARACTER SET = utf8mb4 COMMENT = '用户表';-- 博客表
drop table if exists java_blog_spring.blog_info;
CREATE TABLE java_blog_spring.blog_info (
`id` INT NOT NULL AUTO_INCREMENT,
`title` VARCHAR(200) NULL,
`content` TEXT NULL,
`user_id` INT(11) NULL,
`delete_flag` TINYINT(4) NULL DEFAULT 0,
`create_time` DATETIME DEFAULT now(),
`update_time` DATETIME DEFAULT now() ON UPDATE now(),
PRIMARY KEY (id))
ENGINE = InnoDB DEFAULT CHARSET = utf8mb4 COMMENT = '博客表';-- 新增用户信息
insert into java_blog_spring.user_info (user_name, password, github_url) values("zhangsan", "123456", "https://gitee.com/bubblefish666/class-java45");
insert into java_blog_spring.user_info (user_name, password, github_url) values("lisi", "123456", "https://gitee.com/bubblefish666/class-java45");insert into java_blog_spring.blog_info (title, content, user_id) values("第一篇博客", "111我是博客正文我是博客正文我是博客正文", 1);
insert into java_blog_spring.blog_info (title, content, user_id) values("第二篇博客", "222我是博客正文我是博客正文我是博客正文", 2);

---

创建项目

---

创建 SpringBoot 项目，添加 Spring MVC 和 MyBatis 对应依赖。

---

添加MyBatis-Plus 依赖

---

<dependency><groupId>com.baomidou</groupId><artifactId>mybatis-plus-spring-boot3-starter</artifactId><version>3.5.5</version>
</dependency>

---

删除引入 lombok 依赖添加的多余插件：

---

创建对应目录

---

---

准备前端页面

---

把课程中提供的博客系统静态页面拷贝到 static 目录下。

---

配置配置文件

---

spring:datasource:url: jdbc:mysql://127.0.0.1:3306/java_blog_spring?characterEncoding=utf8&useSSL=falseusername: rootpassword: rootdriver-class-name: com.mysql.cj.jdbc.Drivermybatis-plus:configuration:map-underscore-to-camel-case: truelog-impl: org.apache.ibatis.logging.stdout.StdOutImpllogging:file:name: spring-blog.log

---

测试

---

访问前端页面：http://127.0.0.1:8080/blog_login.html。前端页面可以正确显示，说明项目初始化成功。

---

项目公共模块

---

项目分为控制层（Controller）、服务层（Service）、持久层（Mapper）。各层之间的调用关系如下：

我们先根据需求完成公共层代码的编写。

---

统一返回结果实体类

---

• code：业务状态码
  • 200：业务处理成功
  • -1：业务处理失败
  • 后续有其他异常信息，可以再补充。
• errMsg：业务处理失败时，返回的错误信息。
• data：业务返回数据。

---

定义业务状态枚举：

基于会话管理 Session 、统一响应封装、枚举状态码、工厂方法模式实现状态码方法：全栈开发获取图书列表接口的强制登录功能（含会话管理、统一响应封装思维导图、核心部分代码）

后面需要把 Object data 修改为泛型：

@Data
public class Result<T> {private int code;private String errMsg;private T data;public static <T> Result success(T data) {Result result = new Result();result.setCode(ResultCodeEnum.SUCCESS.getCode());result.setData(data);return result;}public static <T> Result fail(String errMsg) {Result result = new Result();result.setCode(ResultCodeEnum.FAIL.getCode());result.setErrMsg(errMsg);return result;}
}

---

统一返回结果

---

统一返回结果封装：封装 String 类型造成参数类型不匹配异常、通过 Debug 锁定调用链出现异常的具体位置、解决异常的方法_springboot 报错返回类封装

---

定义项目异常

---

import com.bite.blog.common.pojo.response.Result;public class BlogException extends RuntimeException {private Result errorResult = new Result<>();public BlogException(String message) {this.errorResult.setCode(-1);this.errorResult.setErrMsg(message);}
}

---

统一异常处理

---

@ControllerAdvice(含底层源码分析) 、@ExceptionHandler、@ResponseBody 配合实现统一异常处理功能

@RestController 变成 @Controller ，方法的返回值会被当成 URL，使用 @ResponseBody 会告诉 Spring 返回结果是数据而非页面

---

import com.bite.blog.common.pojo.response.Result;
import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;@Slf4j
@RestControllerAdvice
public class ExceptionAdvice {@ExceptionHandlerpublic Result handler(Exception e) {log.error("发生异常, e: {}", e);return Result.fail(e.getMessage());}
}

---

业务代码

---

实体类

---

在数据库中，我们创建了两张表，接下来需要创建两个类，来与之对应；

对应机制：yml 驼峰自动转换/MP 依赖 ???

---

UserInfo

---

@Data
public class UserInfo {@TableId(type = IdType.AUTO)private Integer id;private String userName;private String password;private String githubUrl;private Integer deleteFlag;private LocalDate createTime;private LocalDate updateTime;
}

因为数据库的表名，列名都能和 MyBatis-Plus 中设置的实体类，属性对上，就不需要使用 @TableName，@TableField 来指定表和类、字段和属性；

但是需要使用 @TableId(type = IdType.AUTO) 设置主键，并且设置该主键类型为自增主键；

@TableName、@TableField、@TableId 的使用方法在这篇博客中有提及

---

BlogInfo

---

@Data
public class BlogInfo {@TableId(value = "id", type = IdType.AUTO)private Integer id;private String title;private String content;private Integer userId;private Integer deleteFlag;private LocalDateTime createTime;private LocalDateTime updateTime;
}

---

持久层

---

使用 MyBatisPlus 来完成持久层代码的开发，创建 mapper 实现 BaseMapper 即可。

---

Mapper

---

MP：依赖引入、继承 BaseMapper 接口实现单表增删改查、MP日志配置、表设计中设置主键自增值、MP 相关的 @Table系列常见注解说明_

---

@Mapper 用于标识该接口是 MyBatis 中的 Mapper接口

---