# Spring Boot博客

**Repository Path**: littleturing/spring-blog

## Basic Information

- **Project Name**: Spring Boot博客
- **Description**: 一个基于Spring Boot的个人博客系统，技术框架选用(Spring, SpringMVC, SpringBoot, Mybatis, Thymeleaf)
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: main
- **Homepage**: https://gitee.com/link?target=https%3A%2F%2Fspringboot-nob0-1701609-1310100045.ap-shanghai.run.tcloudbase.com%2F
- **GVP Project**: No

## Statistics

- **Stars**: 15
- **Forks**: 1
- **Created**: 2022-03-13
- **Last Updated**: 2025-06-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 基于Spring Boot的个人博客系统

你好👋，这是一个基于Spring Boot 的个人博客系统，技术框架选用(Spring, SpringMVC, SpringBoot, Mybatis, Thymeleaf)。

目前已经使用[微信云托管](https://sunzhichao.net/2022/03/13/spring-boot-based-personal-blogging-system/)成功上线，项目托管于[GitHub](https://github.com)，但是因为密码等安全问题，**托管仓库为私有仓库**，同时因为网速原因，我在Gitee上重新开源了一个**隐去密码**的版本，你可以自由查看本仓库源代码，另外，你可以通过下面的链接访问**网站前台**的演示，查看其效果，**网站后台你可以自行编译源代码查看，这里因为安全原因未开放**：

**首次访问可能会比较慢，请耐心等待刷新，这是因为微信云托管会动态调整实例数量，我设置的最低实例数为0，长久不访问后再次访问需要重新启动服务！！！** 

[https://springboot-nob0-1701609-1310100045.ap-shanghai.run.tcloudbase.com/](https://springboot-nob0-1701609-1310100045.ap-shanghai.run.tcloudbase.com/)

Gitee链接：https://gitee.com/littleturing/spring-blog

如果想要运行本项目，只需要替换成自己数据库访问路径和密码即可！

下面是项目的具体介绍与分析 :)

***

## 1.项目展示

关于页面，从整体到局部，一点点调试更改，是个十分复杂的过程，需要很有耐心

![image-20220313101943788](https://tuchuang-01.oss-cn-beijing.aliyuncs.com/img/image-20220313101943788.png)

![image-20220313102001510](https://tuchuang-01.oss-cn-beijing.aliyuncs.com/img/image-20220313102001510.png)

![image-20220313102019810](https://tuchuang-01.oss-cn-beijing.aliyuncs.com/img/image-20220313102019810.png)

![image-20220313102032532](https://tuchuang-01.oss-cn-beijing.aliyuncs.com/img/image-20220313102032532.png)

## 2.后端设计（重点）

### 1.概要（三层架构）

![image-20210409161422152](https://tuchuang-01.oss-cn-beijing.aliyuncs.com/img/20210409161422.png)

### 2.错误处理（捕获异常）

当用户访问了不存在的资源或者服务器出现异常的时候，希望给用户友好的提示，而不是一大堆的错误信息

我们在这个项目中设计了三个错误页面：

templates文件夹

- 404（资源找不到）
- 500（服务器内部错误）
- error（其他错误）

然后，需要定义一个全局异常处理类`ControllerExceptionHandler` ，增加`ControllerAdvice`注解来增强`Controller`方法，从而实现所有异常的处理。

另外，我们还需要增加一个自定义异常类`NotFoundException`。举个例子，比如我们需要查找一篇博文，但是并没有在数据库中查询到，这种情况下一般就是返回`500`或者`error`，但是我们希望它返回`404`，这种情况下我们自定义的异常类就起到了作用。

### 3.日志错误（面向切面编程）

在项目开发的过程中，往往需要记录一些必要的日志，方便在系统出现问题的时候及时定位和解决。比如，对于一个典型的 B/S 架构的 Web 服务程序，我们最关注的其实是请求者的相关信息，也就是`controller层方法的调用`，这是整个系统与外界的联系。于是，我们**在每次`controller`方法被调用的时候考虑记录以下内容**：

- 请求url
- 访问者ip
- 调用方法 classMethod
- 参数 args
- 返回内容

显然，一个很简单常规的做法就是在每个`controller`方法里面都手动加上`log方法`🤣🤣，虽然不失为一种方法，但是显然这太麻烦了，不符合我们对简洁性的期望，另外，这样做的最严重的后果是**代码与代码之间的耦合十分严重！**即**牵一发而动全身**😑。

对于这种问题，我们采用**面向切面编程（AOP）**的方法解决，其实这是Spring的一个核心。

AOP技术利用一种称为“横切”的技术，剖解开封装对象的内部，将影响多个类的公共行为封装到一个可重用的模块中，并将其命名为`Aspect`切面。所谓的切面，简单来说就是与业务无关，却为业务模块所共同调用的逻辑，将其封装起来便于减少系统的重复代码，降低模块的耦合度，有利用未来的可操作性和可维护性。

利用AOP可以对业务逻辑各个部分进行隔离，从而使业务逻辑各部分之间的耦合度降低，提高程序的可重用性，同时提高开发效率。

AOP的使用场景主要包括日志记录、性能统计、安全控制、事务处理、异常处理等。

![image-20220312152005575](https://tuchuang-01.oss-cn-beijing.aliyuncs.com/img/image-20220312152005575.png)

![](https://tuchuang-01.oss-cn-beijing.aliyuncs.com/img/20220312150300.png)

我们的做法是定义一个切面`Aspect`，然后在里面定义以下方法

`LogAspect类`

- doBefore
- log
- doAfter
- doAfterReturning

最后，配置一下切面就 ok 了

```java
@Pointcut("execution(* cn.sunzhichao.controller.*.*(..))")
```

### 4.静态资源的引入与处理

前端项目是在WebStorm里面开发的，是静态页面，内容也是写死的，好在目录是对应的，所以直接把之前开发好的前端页面文件夹复制到IDEA项目目录里面再稍微改下就好了。主要任务是能够正常打开（指CSS和JS文件的路径没有乱）即可。

在接下来的开发过程中，就需要**逐步地把静态内容替换成动态内容**，这个过程是比较费时费力的，在此不做过多说明。

### 5.数据库实体与设计

根据业务需求，我们进行数据库的设计，这里采用的方式是实体驱动型，即先进行实体类的设计，再进行数据库表的设计。

- 博客 Blog
- 博客分类 Type
- 博客标签 Tag
- 博客评论 Comment
- 用户 User

#### 实体关系：

![](https://tuchuang-01.oss-cn-beijing.aliyuncs.com/img/image-20220312160119914.png)

#### 评论类自关联关系

![image-20210409161347846](https://tuchuang-01.oss-cn-beijing.aliyuncs.com/img/20210409161347.png)

#### Blog类

![image-20210409161353863](https://tuchuang-01.oss-cn-beijing.aliyuncs.com/img/20210409161353.png)

#### Type类

![image-20210409161400629](https://tuchuang-01.oss-cn-beijing.aliyuncs.com/img/20210409161400.png)

#### Tag类：

![image-20210409161406061](https://tuchuang-01.oss-cn-beijing.aliyuncs.com/img/20210409161406.png)

#### Comment类

![image-20210409161410991](https://tuchuang-01.oss-cn-beijing.aliyuncs.com/img/20210409161411.png)



#### User类

![](https://tuchuang-01.oss-cn-beijing.aliyuncs.com/img/20210409161416.png)

### 6.后台管理

对于后台管理，最重要的是三层架构的理解与使用。

首先来看一下文件夹的样子

![image-20220312201416640](https://tuchuang-01.oss-cn-beijing.aliyuncs.com/img/image-20220312201416640.png)

其中最重要的自然是

- `controller`
- `service`
- `mapper`

`controller`负责接收 HTTP 请求，然后调用`service`里面的方法，着重处理业务逻辑，在`service`层会调用`dao`（`mapper`）层的方法，用于数据库的增删改查

#### 1.后台登录

后台登录的逻辑其实很简单，无非是接收请求，然后查询数据库，验证用户名和密码是否正确，正确则把`User`放在 session 里，不正确则弹出提示信息。

重点在于拦截器的配置，**拒绝在未登录情况下根据 url 访问相应页面**

创建拦截器

```java
public class LoginInterceptor implements HandlerInterceptor {

    @Override
    public boolean preHandle(HttpServletRequest request,
                             HttpServletResponse response,
                             Object handler) throws Exception {
        if(request.getSession().getAttribute("user") == null){
            response.sendRedirect("/admin");
            return false;
        }
        return true;
    }
}
```

配置拦截器

```java
@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new LoginInterceptor())
                .addPathPatterns("/admin/**")
                .excludePathPatterns("/admin")
                .excludePathPatterns("/admin/login");
    }
}
```

#### 2.分类管理

对分类进行增删改查

#### 3.标签管理

对标签进行增删改查

#### 4.博客管理

对博客进行增删改查，注意关联表的操作

### 7.前台展示

#### 1.评论展示

二级评论展示，需要在后端将一篇文章对应的所有评论处理一遍，根据父评论的id，处理完之后再返回前端

#### 2.归档展示：

1. 查询所有年份
2. 根据特定年份查询所有Blog
3. 最后放在一个Map里面返回给前端

#### 3.全局搜索

1. 根据输入的内容作为一个String字符串传入，然后在数据库中模糊查询

#### 4.按照分类或者标签显示

1. 直接查询即可