项目5-博客系统1（准备工作+博客列表+博客详情页）-编程知识

1.创建项目

导入以下依赖

2.项目介绍

使⽤SSM框架实现⼀个简单的博客系统
共5个页面

2.1 前端页面展示

2.1.1 用户登录

2.1.2 博客发表页

2.1.3 博客编辑页

2.1.4 博客列表页

2.1.5博客详情页

2.2 功能描述:

⽤⼾登录成功后, 可以查看所有⼈的博客.

点击 <<查看全⽂>> 可以查看该博客的正⽂内容.

如果该博客作者为当前登录⽤⼾, 可以完成博客的修改和删除操作, 以及发表新博客

3.准备工作

3.1 数据准备

3.1.1 建立SQL

-- 建表SQL
create database if not exists java_blog_spring charset utf8mb4;
USE java_blog_spring;
-- 用户表
DROP TABLE IF EXISTS java_blog_spring.user;
CREATE TABLE java_blog_spring.user(`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(),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;
CREATE TABLE java_blog_spring.blog (`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(),PRIMARY KEY (id))
ENGINE = InnoDB DEFAULT CHARSET = utf8mb4 COMMENT = '博客表';
-- 新增用户信息
insert into java_blog_spring.user (user_name, password,github_url)values
("lay","107","https://www.weibo.com/u/2706896955?c=spr_qdhz_bd_360ss_weibo_mr");
insert into java_blog_spring.user (user_name, password,github_url)
values("muyierf","123456","https://gitee.com/muyierf");
insert into java_blog_spring.blog (title,content,user_id) values("第1篇博
客","lay的筑梦之旅",1);
insert into java_blog_spring.blog (title,content,user_id) values("第1篇博
客","muyierf的第一篇博客",2);

创建成功！！！

3.2 前端代码引入项目中

3.3 配置配置文件

spring:datasource:url: jdbc:mysql://127.0.0.1:3306/java_blog_spring?characterEncoding=utf8&useSSL=falseusername: rootpassword: 123456driver-class-name: com.mysql.cj.jdbc.Driver
mybatis:configuration:map-underscore-to-camel-case: true #配置驼峰⾃动转换log-impl: org.apache.ibatis.logging.stdout.StdOutImpl #打印sql语句mapper-locations: classpath:mapper/**Mapper.xml
# 设置⽇志⽂件的⽂件名
logging:file:name: spring-book.log

3.4 测试项目能否启动成功

成功！！！

3.5 开发前的准备

3.5.1 项目流程

1.需求分析

2.技术方案设计
1)UML图,流程图,ER图

2)数据库设计

3)接口设计（我们需要完成的工作）

3.开发（我们需要完成的工作）

4.自测（我们需要完成的工作）

5.测试(QA)

6.联调

7. 验收

8.上线

3.5.2 数据库表的创建

数据库表通常分两类:
1.实体表->对象 (员工表,部门表,图书表,博客表..)

2.关系表->实体之间的关系

我们的项目较为简单，所以我们只需要两个实体表即可。

用户表:用户名,密码,照片,昵称,github地址

1.根据用户名,查询用户信息
2.根据用户ID,查询用户信息

博客表: 标题,日期,内容,作者, 分类..

1.查询博客列表
2.根据博客ID, 查询博客信息
3.根据博客ID, 修改博客信息

4.插入博客

3.5.3 接口设计

1.用户登录
根据用户名和密码, 判断是否正确->根据用户名,查询用户信息,对比密码是否正确

2.查询用户信息
根据用户ID,查询用户信息->根据用户ID,去查询用户信息

3.博客列表

查询所有博客->查询所有博客

4.查询作者信息

1)根据博客, 拿到作者ID
2)根据作者ID,获取作者信息

->根据用户ID,去查询用户信息

5.查询博客详情

->根据博客ID, 查询博客信息

6.修改博客->根据博客ID, 修改博客信息

7.添加博客->插入博客信息

8.删除博客
1)物理删除
2)逻辑删除->根据博客ID,修改博客信息

3.5.4 建包

controller
service
mapper
model
config
constants（里面写枚举类和常量类都可以）

4.代码部分

4.1. 实体类（model包）

//要与数据库一致

package com.example.demo.model;import lombok.Data;import java.util.Date;@Data
public class BlogInfo {private Integer id;private String title;private String content;private Integer userId;private Integer deleteFlag;private Date createTime;private Date updateTime;
}

package com.example.demo.model;import lombok.Data;import java.util.Date;@Data
public class UserInfo {private Integer id;private String userName;private String password;private String githubUrl;private Byte deleteFlag;private Date createTime;private Date updateTime;
}

4.2 公共模块

包括实体类和同一功能处理<1.拦截器2.统一功能处理3.统一结果返回>

4.2.1. 统一返回结果实体类

a. code: 业务状态码
▪ 200: 业务处理成功
▪ -1 : 业务处理失败
▪ -2 : ⽤⼾未登录
▪ 后续有其他异常信息, 可以再补充.
b. msg: 业务处理失败时, 返回的错误信息
c. data: 业务返回数据

定义业务状态码//我们将这些确定的状态码存入Constants包中，防止修改

package com.example.demo.model;import com.example.demo.constants.Constant;
import lombok.Data;@Data
public class Result {private int code;private String msg;private Object data;//业务执行时返回的方法public static Result success(Object data){Result result=new Result();result.setData(Constant.RESULT_CODE_SUCCESS);result.setMsg("");result.setData(data);return result;}public static Result fail(int code,String msg){Result result=new Result();result.setData(Constant.RESULT_CODE_FAIL);result.setMsg(msg);result.setData("");return result;}public static Result unlogin(int code,String msg,Object data){Result result=new Result();result.setData(Constant.RESULT_CODE_UNLOGIN);result.setMsg("用户未登录");result.setData(data);return result;}
}

4.2.2 统一返回结果

4.2.2.1 统一功能处理

package com.example.demo.model.result;import com.fasterxml.jackson.core.JsonProcessingException;
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.servlet.mvc.method.annotation.ResponseBodyAdvice;public class ResponseAdvice implements ResponseBodyAdvice {@Overridepublic boolean supports(MethodParameter returnType, Class converterType) {return true;}@Overridepublic Object beforeBodyWrite(Object body, MethodParameter returnType, MediaType selectedContentType,Class selectedConverterType, ServerHttpRequest request,ServerHttpResponse response) {if(body instanceof Result){return body;}if(body instanceof String){ObjectMapper objectMapper=new ObjectMapper();try {return objectMapper.writeValueAsString(Result.success(body));} catch (JsonProcessingException e) {e.printStackTrace();}}return Result.success(body);}
}

记得加此注解！！！

统⼀的数据返回格式使⽤ @ControllerAdvice 和 ResponseBodyAdvice 的⽅式实现
@ControllerAdvice 表⽰控制器通知类
添加类 ResponseAdvice , 实现 ResponseBodyAdvice 接⼝, 并在类上添加@ControllerAdvice 注解

4.2.2.2 统一异常处理

@ExceptionHandler 是异常处理器，两个结合表⽰当出现异常的时候执⾏某个通知，也就是执⾏某个⽅法事件

package com.example.demo.model.result;import com.example.demo.constants.Constant;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;@ControllerAdvice
@ResponseBody
public class ExceptionAdvice {@ExceptionHandlerpublic Result exceptionAdvice(Exception e){return Result.fail(Constant.RESULT_CODE_FAIL,e.getMessage());}
}

4.2.2.3 拦截器

4.3 业务代码

4.3.1 持久层（mapper）

根据需求, 先⼤致计算有哪些DB相关操作, 完成持久层初步代码, 后续再根据业务需求进⾏完善

1. 用户登录页

根据用户名查询用户信息（select语句）

2. 博客列表⻚

根据id查询user信息（select语句->通过id查询用户表）
获取所有博客列表（select语句->通过id查询博客表）

3. 博客详情⻚

根据博客ID查询博客信息
根据博客ID删除博客(修改delete_flag=1,update)

4. 博客修改⻚

根据博客ID修改博客信息(update)

5. 发表博客

插⼊新的博客数据(insert)

1.BlogInfoMapper

package com.example.demo.mapper;import com.example.demo.model.BlogInfo;
import org.apache.ibatis.annotations.Insert;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Select;import java.util.List;@Mapper
public interface BlogMapper {//a.获取所有博客列表@Select("select * from blog where delete_flag=0 order by create_time desc")List<BlogInfo> selectAllBlog();//b.根据博客id查询它的博客@Select("select * from blog where delete_flag=0 and id=#{id}")BlogInfo selectByIdBlog();//c.插⼊新的博客数据(insert)@Insert("insert into blog (title,content,user_id) values (#{title},#{content},#{userId})")Integer insertNewBlog(BlogInfo blogInfo);//d.博客修改页和博客删除页（update）-动态mybatis->xmlInteger updateBlog(BlogInfo blogInfo);}

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
<mapper namespace="com.example.demo.mapper.BlogInfoMapper"><update id="updateBlog">update blog<set><if test="title!=null">title=#{title},</if><if test="content!=null">content=#{content},</if><if test="deleteFlag !=null">delete_flag = #{deleteFlag}</if></set>where id=#{id}</update>
</mapper>

2.UserInfoMapper

package com.example.demo.mapper;import com.example.demo.model.UserInfo;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Select;@Mapper
public interface UserInfoMapper {//1.根据id查询用户的信息@Select("select * from user where id = #{id}")UserInfo selectById(Integer id);//2.根据用户名查询用户的信息，登陆操作时用@Select("select * from user where user_name = #{userName}")UserInfo selectByName(String name);
}

4.3.1.1 测试持久层

package com.example.demo.mapper;import com.example.demo.model.BlogInfo;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;import static org.junit.jupiter.api.Assertions.*;@SpringBootTest
class BlogInfoMapperTest {@Autowiredprivate BlogInfoMapper blogInfoMapper;@Testvoid selectAllBlog() {System.out.println(blogInfoMapper.selectAllBlog());}@Testvoid selectByIdBlog() {System.out.println( blogInfoMapper.selectByIdBlog(1));}@Testvoid insertNewBlog() {BlogInfo blogInfo=new BlogInfo();blogInfo.setTitle("测试接口");blogInfo.setContent("单元测试测试接⼝测试接⼝");blogInfo.setUserId(5);blogInfoMapper.insertNewBlog(blogInfo);}@Testvoid updateBlog() {BlogInfo blogInfo=new BlogInfo();blogInfo.setId(3);blogInfo.setTitle("测试接口ing");blogInfo.setDeleteFlag(1);blogInfoMapper.updateBlog(blogInfo);}
}

测试成功！！！

测试结果

数据库也成功录入信息！！！

4.3.2 实现博客列表

4.3.2.1 约定前后端交互接口

[请求]
/blog/getlist
[响应]
{"code": 200,"msg": "","data": [{"id": 1,"title": "第⼀篇博客","content": "111我是博客正⽂我是博客正⽂我是博客正⽂","userId": 1,"deleteFlag": 0,"createTime": "2023-10-21 16:56:57","updateTime": "2023-10-21T08:56:57.000+00:00"},.....]
}

客户端给服务器发送⼀个 /blog/getlist 这样的 HTTP 请求, 服务器给客⼾端返回了⼀个 JSON 格
式的数据.

4.3.2.2 实现服务器代码

1.service包

2.controller包

3.后端测试

失败！！！

与预想结果不符，我想要的code为200.经过检查,set错误，导致其为默认值。

修改之后重新测试

成功！！！

4.3.2.3 前后端交互->实现客户端代码

4.3.2.3.1 前端测试

成功！！！

4.3.2.3.2 相关部署（时间的返回格式确定）

此时⻚⾯的⽇期显⽰为时间戳, 我们从后端也⽇期进⾏处理
SimpleDateFormat 格式参考官⽅⽂档

我们建立一个utils包，进行相关的部署

重写获取博客创建时间

重新测试

成功！！！

4.3.3 实现博客详情

⽬前点击博客列表⻚的 "查看全⽂" , 能进⼊博客详情⻚, 但是这个博客详情⻚是写死的内容. 我们期望能够根据当前的博客 id 从服务器动态获取博客内容.

4.3.3.1 约定前后端交互接⼝

[请求]

/blog/getBlogDetail?blogId=1

[ 响应 ]

{

        "code" : 200,

        "msg" : "" ,

        "data" : {

        "id" : 1,

        "title" : " 第⼀篇博客 " ,

        "content" : "111 我是博客正⽂我是博客正⽂我是博客正⽂ " ,

        "userId" : 1,

        "deleteFlag" : 0,

        "createTime" : "2023-10-21 16:56:57" ,

        "updateTime" : "2023-10-21T08:56:57.000+00:00"

}

}