SpringBoot实战——个人博客项目

目录

一、项目简介

 二、项目整体架构

数据库模块

后端模块

前端模块

 三、项目具体展示

 四、项目的具体实现

1、一些准备工作

数据库、数据表的创建

设置数据库和MyBatis的配置

将前端项目引入到当前项目中

2、登录注册模块

实体类的创建

前端后端交互

后端流程

登录功能的实现和注册大同小异

3、统一功能的处理

统一异常处理

统一数据格式返回

统一用户的登录验证(用户登录拦截器)

过程中遇到的bug

4、博客列表页面的实现(更新中...)

5、博客详情页面的实现

6、博客的修改和删除功能

7、博客列表分页功能的实现

8、随机加盐的实现


一、项目简介

项目名称:个人博客系统

主要操作的对象是:文章和用户,用户可在该系统上发表自己的博客,查看自己或别人已经发表的文章

需要用到两张表:userinfo(用户表)、articleinfo(文章表)

需要实现的功能:

登录+注册

博客的分页列表功能

新增发表博客

修改、删除自己的博客

项目技术栈

SSM(SpringBoot + SpringMVC + MyBatis)

MySQL

jQuery

 项目亮点

手动对用户密码实现随机加盐

统一异常处理、拦截器

用户登录持久化(session内存)

分页功能

 二、项目整体架构

数据库模块

两张表:用户表 + 文章表

SpringBoot实战——个人博客项目_第1张图片

后端模块

控制层(controller包)——》控制器

服务层(service包)——》服务类

持久层--数据访问层(java目录下mapper类 + resources目录下的mapper.xml)——》mapper

实体层(model包)——》实体类

工具层(config包+util包)——》统一异常处理、统一返回、随机加盐

SpringBoot实战——个人博客项目_第2张图片

 

前端模块

前端设计到7个页面

login.html登录页

reg.html注册页

blog_list.html总的博客列表页——》用到了blog_l

myblog_list.html个人博客列表页

blog_content.html博客详情页

blog_edit.html博客编辑页

blog_update.html博客修改页

 SpringBoot实战——个人博客项目_第3张图片

 三、项目具体展示

项目公网地址:登陆页面

 登录页面、注册页面

 

 总的博客列表页面

 博客详情页

个人博客主页

 

 博客修改页面

SpringBoot实战——个人博客项目_第4张图片

博客编辑页面

SpringBoot实战——个人博客项目_第5张图片 

 

 项目源码:java_spring: SpringMVC、SpringBoot、MyBatis学习 - Gitee.com

 

 四、项目的具体实现

1、一些准备工作

首先我们新建一个springboot项目,项目具体的创建流程我这里就不在赘述。

详见:SpringBoot项目的创建

 SpringBoot实战——个人博客项目_第6张图片

接下来我们就要数据库引入该项目。

数据库、数据表的创建

 用户表的创建SpringBoot实战——个人博客项目_第7张图片

 文章表的创建

SpringBoot实战——个人博客项目_第8张图片

设置数据库和MyBatis的配置

配置数据库的连接信息

SpringBoot实战——个人博客项目_第9张图片

 这里的很多内容是固定的

# 数据库连接配置
Spring:
  datasource:
    url: jdbc:mysql://localhost:3306/你要连接的数据库名?characterEncoding=utf8&useSSL=false
    username: 用户名
    password: 自己的密码
    driver-class-name: com.mysql.cj.jdbc.Driver #只要你数据库用的是mysql这个是固定的

 配置MyBatis XML存放位置和命名规则

SpringBoot实战——个人博客项目_第10张图片

 此时我们已经在通过maven将MySQL Driver和MyBatis Framework这两个包导入了进来,此时启动项目,项目依然能够正常运行,说明我们数据库连接是正常的。

SpringBoot实战——个人博客项目_第11张图片

将前端项目引入到当前项目中

下面的前端的静态资源复制到我们resource/static目录下面:

springboot项目-个人博客系统静态页面https://download.csdn.net/download/weixin_61061381/87459276

SpringBoot实战——个人博客项目_第12张图片

2、登录注册模块

实体类的创建

登录和注册不就是对用户表进行操作吗?这个我们首先创建用户表对应的实体类

首先根据我们数据库的表,在我们的程序中创建想对应的实体类——我们的MyBatis是ORM框架,我们的程序对象与关系数据库数据之间有响应的映射关系

  • 一个数据库中的数据表对应我们程序中的一个实体类
  • 数据表中的一行数据对应该实体类的一个实例化对象
  • 该数据表中的各个属性对应该实体类的成员变量(属性)

 对了,还记我们springboot的扫描路径吗?

只有在启动类的同级目录下,springboot才会对该目录下的类进行扫描,配合类注解存到spring容器中。

SpringBoot实战——个人博客项目_第13张图片

接下来我们就尝试给我们的用户表插入一条数据。

SpringBoot实战——个人博客项目_第14张图片

 如上图所示:我们从前端的login.html中获取到数据后,经过控制层——》服务层——》数据持久层,最后才作用到我们的数据库上。

废话不多说,让我们跟着流程来走一遍吧!

 controller层

上图描述的是,我们通过url直接调用了我们控制层的sayHi()方法,并且把我们sayHi()方法返回的的结果展现在了浏览器上。

但是现在我们有前端了,我们前端提交数据(调用我们的后端controller层的登录方法),然后把结果返回给前端不就行了吗(用户是登录失败了,还是成功了,交由我们的前端来处理)

前端后端交互

首先用户在前端页面输入了用户信息

然后前端紧接着就把用户输入的信息传递给后端(提交到后端指定的接口上,比如登录提交的就是/user/reg 

SpringBoot实战——个人博客项目_第15张图片

SpringBoot实战——个人博客项目_第16张图片

后端接收到用户信息,存到数据库中,并返回注册的结果(成功了?还是失败了?) 

SpringBoot实战——个人博客项目_第17张图片

 前端接受到后端返回的结果后做进一步的处理

SpringBoot实战——个人博客项目_第18张图片

后端流程

还是先来看这张图

SpringBoot实战——个人博客项目_第19张图片

下面是根据上图流程构建的目录

SpringBoot实战——个人博客项目_第20张图片

 controller层代码

package com.example.demo.controller;

import com.example.demo.model.UserInfo;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.util.StringUtils;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.HashMap;
/**
 * 而Spring Boot框架项目接口返回 JSON格式的数据比较简单:
 * 在 Controller 类中使用@RestController注解即可返回 JSON格式的数据。
 */
@RestController
@RequestMapping("/user")
public class UserController {
    // 属性注入service服务层的userService类
    @Autowired
    public UserService userService;
    @RequestMapping("/reg")
    public HashMap reg(String username, String password1, String password2) {
        HashMap result = new HashMap<>();
        if (!StringUtils.hasLength(username) || !StringUtils.hasLength(password1) || !StringUtils.hasLength(password2)) {
            result.put("status", -1);
            result.put("msg", "参数输入错误");
            result.put("data", "");
            return result;
        }
        else {
            if (!password1.equals(password2)) {
                result.put("status", -1);
                result.put("msg", "前后密码不一致");
                result.put("data", "");
                return result;
            }
            else {
                UserInfo userInfo = new UserInfo();
                userInfo.setUsername(username);
                userInfo.setPassword(password1);
                int ret = userService.reg(userInfo);
                if (ret != 1) {
                    result.put("status", -1);
                    result.put("msg", "数据库添加出错");
                    result.put("data", "");
                    return result;
                }
                else {
                    result.put("status", 200);
                    result.put("msg", "注册成功");
                    result.put("data", ret);
                    return result;
                }
            }
        }
    }
}

在controller层中调用了service服务层的reg方法

SpringBoot实战——个人博客项目_第21张图片

 service服务层又调用了持久层中的mapper接口

SpringBoot实战——个人博客项目_第22张图片

 mapper接口的实现:UserMapper.xml文件




    
        insert into userinfo(username, password) values(#{userinfo.username}, #{userinfo.password});
    

 到此,关于注册整个前后端的流程就走完了,下面我们来验证一下

SpringBoot实战——个人博客项目_第23张图片

 SpringBoot实战——个人博客项目_第24张图片

但是当我们重复注册张三这个用户名

SpringBoot实战——个人博客项目_第25张图片

 这个异常我们前端是不知道的,我们不知道发生了什么,是注册成功了?还是失败了?

在后端我们应该统一对异常进行处理,并把具体的异常情况告诉前端

这就是我们下面要说的统一处理功能的实现

关于前后端参数的传递,详见:SpringMVC学习笔记(获取参数,传递参数——关于前后端传参交互的总结、from表单、Ajax数据提交)_是小鱼儿哈的博客-CSDN博客

 关于MyBatis实现数据库的增删改查,详见:第一个MyBatis程序_是小鱼儿哈的博客-CSDN博客

关于spring更简单的存取用户对象,详见:

 spring更简单的对象存取

登录功能的实现和注册大同小异

后端流程

SpringBoot实战——个人博客项目_第26张图片

 前后端交互的流程

SpringBoot实战——个人博客项目_第27张图片

下面我们通过浏览器验证一下我们的登录功能

SpringBoot实战——个人博客项目_第28张图片

一点补充 

通过controller层的代码,可以看到我们返回给前端的好像是hashmap,这样肯定是不行的。

这个时候就用到了我们的@RestController注解了

*@RestController是@Controller和@ResponseBody两者的结合,使用这个注解后该controller的所有方法都会返回json格式的数据

*  因为@ResponseBody的作用就是把返回的对象转换为json格式,并把json数据写入response的body中,前台收到response时就可以获取其body中的json数据了。
* 如果在整个controller类上方添加@RestController,其作用就相当于把该controller下的所有方法都加上@ResponseBody,使每个方法直接返回response对象

3、统一功能的处理

上面我们说了,当程序出现了异常获取其他情况,我们不统一处理(把结果告诉前端)我们其实是不知道发生了什么的。

统一异常处理

所以我们需要单独在工具层中(我们的common包下面,建一个统一异常处理的类)

SpringBoot实战——个人博客项目_第29张图片

统一数据格式返回

一般在web项目中,我们前后端都是通过json这种数据格式来交换数据格式——》我们后端需要给前端返回json格式的数据。

总之,我们前后端用户交互的数据个数一般是统一的,不会出现你一个接口用一种数据格式,而那个接口又换了,这样就会有很多问题,不利于开发。

统一数据的优点

  • 方便前端程序员更好的接受和解析后端数据接口返回的数据。
  • 降低前端程序员和后端程序员的沟通成本,按照某个格式实现就可以了,因为所有接口都是这样返回的。
  • 有利于项目统一数据的维护和修改。
  • 有利于后端技术部门的统一规范的标准制定,不会出现稀奇古怪的返回内容。

统一数据格式的返回有两种实现方式,返回一个公共对象或者重写。

这里我们采用第二种重写(不过他的灵活性有待提升) 

具体的我们可以使用@ControllerAdvice+ResponseBodyAdvice的方式实现,具体实现代码如下:

SpringBoot实战——个人博客项目_第30张图片

但是正如我们上面所说的,通过重写来进行统一数据格式的返回,他的灵活性的确有待提高。你看我们上面只是处理了成功的情况,但要是失败的情况呢?——》并且即使失败,也是分好几种情况呢!!!

 我们不如再创建一个工具类,用来自定义返回hashmap数据(再通过@ResponseBody转成json格式)

SpringBoot实战——个人博客项目_第31张图片

 那么对应的我们的统一数据格式返回类就发生了变化

package com.example.demo.common;

import com.fasterxml.jackson.databind.ObjectMapper;
import org.springframework.core.MethodParameter;
import org.springframework.http.MediaType;
import org.springframework.http.server.ServerHttpRequest;
import org.springframework.http.server.ServerHttpResponse;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.servlet.mvc.method.annotation.ResponseBodyAdvice;

import java.util.HashMap;

/**
 * 统一数据格式返回(灵活性有待提高)
 *  通过统一数据格式的返回,不管我们控制层的方法返回了什么类型的数据
 *  通过重写末尾都能把他转成hashmap格式的数据,然后又通过@ResponseBody注解,将java对象转成了json对象。
 */
@ControllerAdvice
@ResponseBody
public class ResponseAdvice implements ResponseBodyAdvice {
    @Override
    public boolean supports(MethodParameter returnType, Class converterType) {
        return true; // 这个值为true的时候,才会对返回的数据进行重写
    }
    @Override
    public Object beforeBodyWrite(Object body, MethodParameter returnType, MediaType selectedContentType, Class selectedConverterType, ServerHttpRequest request, ServerHttpResponse response) {
        // 在有了我们自定义数据返回后,我们的这个统一数据格式返回类就像是一个托地的。
        // 因为controller层可以直接调用AjaxResult,来返回hashmap(通过@ResponseBody转成json)
        // 但如果controller没有调用AjaxResult,直接返回了
        if (body instanceof HashMap) {
            return body;  // 此时已经是hashmap格式了
        }
        if (body instanceof Integer){ // 当controller层中的方法直接返回int类型时候
            int num = (int) body;
            if (num <= 0) {
                // 应对int类型错误返回(查询文章列表,新增和删除博客可能会用到)——》也可能用不到,如果新增或查询失败,我直接就在controller就返回了(通过调用AjaxResult)
                // 新增、删除或查询失败(非得在controller返回int值,再通过这里返回json对象的话,不灵活(出错信息显示的不具体
                // 所以说这里我们只是以防万一,我们还是选择再controller层直接返回json对象,这样更信息具体,更有怎针对性)
                return AjaxResult.fail("抱歉,本次操作失败,请稍后再试!"); // 这里无法区分是新增失败还是删除失败
                // 这里我们本来返回的是一个hashmap格式的对象,但加了@ResponseBody,把我们的java对象转成的了json格式
            }
        }

        if (body == null) { // (比如查询操作,直接返回查询到的UserInfo对象,然后直接返回该对象)
            // 这里我们本来返回的是一个hashmap格式的对象,但加了@ResponseBody,把我们的java对象转成的了json格式
            return AjaxResult.fail("抱歉,查询失败!"); // 这时对查询当前用户的特判
        }
        // 这里我们本来返回的是一个hashmap格式的对象,但加了@ResponseBody,把我们的java对象转成的了json格式
        return AjaxResult.success("操作成功", body);
        // 前端是通过result中的status值来判断操作是否成功的,这个类用来处理操作成功的情况(为操作成功的情况兜底)
        // 但这可能存在问题,如果操作失败,并且在controller层没有调用AjaxResult中的fail方法(而是直接返回,通过这个类来返回统一的数据格式,就会出现问题——》在这个类我们都是按成功的处理的)
        // 解决方案,在该类中提前判断body(判断操作失败的情况)--->我们约定如果操作失败就返回负数(在controller层调用AjaxResult的情况)
    }
}

那么与之对应的我们在controller层的类也就发生了改变

package com.example.demo.controller;

import com.example.demo.common.AjaxResult;
import com.example.demo.model.UserInfo;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.util.StringUtils;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.jws.soap.SOAPBinding;
import javax.servlet.http.HttpSession;
import java.util.HashMap;
/**
 * 而Spring Boot框架项目接口返回 JSON格式的数据比较简单:
 * 在 Controller 类中使用@RestController注解即可返回 JSON格式的数据。
 *  @RestController是@Controller和@ResponseBody两者的结合,使用这个注解后该controller的所有方法都会返回json格式的数据,
 *  因为@ResponseBody的作用就是把返回的对象转换为json格式,并把json数据写入response的body中,前台收到response时就可以获取其body中的json数据了。
 * 如果在整个controller类上方添加@RestController,其作用就相当于把该controller下的所有方法都加上@ResponseBody,使每个方法直接返回response对象。
 */
@RestController
@RequestMapping("/user")
public class UserController {
    @Autowired
    public UserService userService;
    @RequestMapping("/reg")
    public Object reg(String username, String password1, String password2) {
        HashMap result = new HashMap<>();
        if (!StringUtils.hasLength(username) || !StringUtils.hasLength(password1) || !StringUtils.hasLength(password2)) {

            return AjaxResult.fail("你输入的参数有误,请重新输入!");
        }
        else {
            if (!password1.equals(password2)) {
                return AjaxResult.fail("前后密码不一致,请重新输入!");
            }
            else {
                UserInfo userInfo = new UserInfo();
                userInfo.setUsername(username);
                userInfo.setPassword(password1);
                int ret = userService.reg(userInfo);
                if (ret != 1) {
                   return AjaxResult.fail("数据库添加用户失败,请稍后再试!");
                }
                else {
                    return AjaxResult.success("恭喜,注册成功!", ret);
                }
            }
        }
    }
    @RequestMapping("/login")
    public Object login(String username, String password) {
        HashMap result = new HashMap<>();
        if (!StringUtils.hasLength(username) || !StringUtils.hasLength(password)) {
            return AjaxResult.fail("你输入的参数有误,请重新输入!");
        }
        else {
            // 需要在数据库中查询当前登录的用户是否存在
            UserInfo userInfo = userService.selectByUsername(username);
            if (userInfo == null || !password.equals(userInfo.getPassword())) {
               return AjaxResult.fail("你当前的用户名或密码错误,请重新输入!");
            }
            else  {
                return AjaxResult.success("恭喜,登录成功!", "");
            }
        }
    }
}

统一用户的登录验证(用户登录拦截器)

spring拦截器

对于以上问题Spring中提供了具体的实现拦截器:HandlerInterceptor,拦截器的实现分为以下两个步骤:

1、创建自定义拦截器,实现 HandlerInterceptor 接口的perHandle(执行具体方法之前的预处理)方法。

2、将自定义拦截器加入 WebMvcConfiger的 addInterceptors方法中。
 

创建用户登录拦截器

SpringBoot实战——个人博客项目_第32张图片

 将该自定义拦截器放到系统的配置文件中

(将自定义拦截器加入 WebMvcConfiger的 addInterceptors方法中)

SpringBoot实战——个人博客项目_第33张图片

 用浏览器测试一下是否真的拦截了

SpringBoot实战——个人博客项目_第34张图片

可以看到因为我们没有放行login.html,登录页面直接显示不出来了。

我们改下拦截规则 

SpringBoot实战——个人博客项目_第35张图片

 SpringBoot实战——个人博客项目_第36张图片

然后你发现,咦,怎么还是不行。

当然不行呀,你虽然运行了login.html通行,但是login.html还用到了css/js/image图片呢!这些东西你还没放行呢!!!

 SpringBoot实战——个人博客项目_第37张图片

SpringBoot实战——个人博客项目_第38张图片

过程中遇到的bug

一开始,当我把自定义的用户登录拦截器放到了系统配置文件,我欢欢喜喜的启动项目,结果——

SpringBoot实战——个人博客项目_第39张图片

SpringBoot实战——个人博客项目_第40张图片

 加上类注解后问题就解决了。

关于统一功能的处理,详见:SpringBoot统一功能处理_是小鱼儿哈的博客-CSDN博客

4、博客列表页面的实现(更新中...)

5、博客详情页面的实现

6、博客的修改和删除功能

7、博客列表分页功能的实现

8、随机加盐的实现

你可能感兴趣的:(Java实战项目,spring,boot,mybatis,java)