# spring-boot-bbs-api **Repository Path**: uncleAndyChen/spring-boot-bbs-api ## Basic Information - **Project Name**: spring-boot-bbs-api - **Description**: 该项目只是后端 api，对应前端项目：https://gitee.com/uncleAndyChen/react-full-stack-learning - **Primary Language**: Java - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 3 - **Created**: 2018-12-19 - **Last Updated**: 2025-09-30 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 修改日志 - 2019-12-28 重构：将 MySQL 命名规范由驼峰式改为下划线。 - 2019-03-11：将默认端口由88改为89。 - MacOS 下，88端口默认被Kerberos占用。 - 2018-12-22：添加 Druid 数据库连接池。 - 2018-12-21：完成与前端项目对接剩下的工作。 - 解决帖子详情页面报错的问题，刷新和创建评论均正常。 - 完成：创建帖子功能、修改帖子功能。 - 完善项目说明。 - 2018-12-20： - 与前端项目对接，完成首页列表加载、帖子详情页面加载。 - 存在的问题： - 帖子详情页面加载之后创建评论后页面报错。 - 帖子详情页面，第一次加载正常，刷新后报错。 - 2018-12-19：项目基础架构搭建完成，可以正常查询数据，目前仅完成帖子列表的查询，暂未与前端项目对接。 # 注意 该项目的数据库表名、字段名，**曾经**遵循的是驼峰命名法，而非 MySQL 流程的下划线命名法。 推荐在真实项目中采用流行的下划线命名法，关于数据库表名和字段名的命名规则，不要被这个项目“误导”了。 有关 MySQL 命名规范，请参考：[MyBatis 项目中，有关 MySQL 命名规范，用驼峰命名法（不推荐）与下划线命名法（推荐）的取舍](http://blog.5k8.top/mybatis/mysqlNaming.html)，请关注这篇文章提到的 mapUnderscoreToCamelCase 配置项。 # 项目地址 * 托管在 gitee 上的项目链接 ：https://gitee.com/uncleAndyChen/spring-boot-bbs-api * 托管在 github 上的项目链接：https://github.com/uncleAndyChen/spring-boot-bbs-api # 说明 该项目是以下前端项目的后端 api，前端项目是拿《React进阶之路》第九章示例 [bbs-redux-reselect](https://github.com/xuchaobei/react-book/tree/master/chapter-09/bbs-redux-reselect) 来改的。 仅改了调用api部分和添加了一些备注，之前的api用的是[apicloud](https://d.apicloud.com/mcm/api)。 - 前端项目地址 - 托管在 gitee 上的项目链接 ：https://gitee.com/uncleAndyChen/react-full-stack-learning - 托管在 github 上的项目链接：https://github.com/uncleAndyChen/react-full-stack-learning # 技术栈 - [Spring Boot v2.1.1](https://github.com/spring-projects/spring-boot) - [MyBatis v3.4.6](https://github.com/mybatis/mybatis-3) - [MyBatis Generator (MBG) v1.3.7](https://github.com/mybatis/generator)，关于如何使用，请查看项目根目录下的 `generatorConfig.xml` 末尾说明。也可以参考我的另外一个项目：[mybatis-generator](https://github.com/uncleAndyChen/mybatis-generator)，该项目有针对 MBG 写扩展。 - [druid v1.1.10](https://github.com/alibaba/druid) - [druid-spring-boot-starter v1.1.10](https://github.com/alibaba/druid/tree/master/druid-spring-boot-starter) - [配置_StatFilter](https://github.com/alibaba/druid/wiki/配置_StatFilter) - [使用Druid的内置监控页面->配置_StatViewServlet配置](https://github.com/alibaba/druid/wiki/配置_StatViewServlet配置) druid 的监控功能，配置参照 `bbs-api-spring-boot/application.yml`。项目启动之后，访问：`http://localhost:89/druid`，会自动跳转至：`http://localhost:89/druid/login.html`，要求输入配置的用户名和密码。 # MySQL 表结构 建表脚本 createTable.sql，位于根目录下。 ![](./bbs-database.png) # 运行步骤 ## 运行后端 1. 创建数据库：导入项目根目录下的文件 createTable.sql。仅在 MySQL v5.7.x 和 v8.0.11 上测试过，未在别的版本和别的数据库测试。 1. 用 IDEA 或者 Eclipse 导入项目，修改数据库连接参数。需要修改的文件：`bbs-api-spring-boot/resources/application.yml`，修改好之后，运行起来。 1. 访问 `http://localhost:89`，可看到 api 测试页面，点击【获取帖子列表】、【获取帖子详情】、【获取评论列表】试试，正常情况下，可以读到数据。 ## 运行前端 在 cmd 窗口下，进入前端项目根目录，执行 `npm start`。 ## 用 WebStorm 调试前端 React 请参考：[像用 IDEA 调试 Java 代码一样，用 WebStorm 调试 react 代码](http://blog.5k8.top/react/JetBrainsIDESupport) ## 登录 登录之后，才可以发帖和评论。 - 初始化了四个用户 - tom - jack - steve - AndyChen - 密码都是：123456 # 计划 由于只是利用业余时间完成该项目，进度可能会比较慢甚至短期中断。 1. [x] 与前端项目对接 - [x] 基础框架搭建 - [x] 查询帖子列表 - [x] 查询单个帖子 - [x] 查询评价列表 - [x] 用户登录 - [x] 创建评价 - [x] 创建帖子 - [x] 修改帖子 - [x] 点赞功能（点赞之前需要先登录，每个用户对同一个帖子，点赞之后可取消点赞，类似微信朋友圈儿的点赞功能） - [x] 收藏功能（在操作上类似点赞） - 菜单【我的收藏】，决定不做了。之后如果有时间，会把精力投入到 [ant-design-pro](https://github.com/ant-design/ant-design-pro)。 - [x] 增加菜单【我的帖子】，只是简单的过滤，没有重新从服务器获取。目前页面显示的是所有帖子。 1. [x] 使用 Druid - [官方介绍](https://github.com/alibaba/druid/wiki/常见问题)：Druid是Java语言中最好的数据库连接池。Druid能够提供强大的监控和扩展功能。 - 本项目使用 Druid，仅供学习。 - 实际项目中，可根据情况决定是否采用 Druid，也可以选择业界其他优秀的数据库连接池。 - 或者，如果使用 spring boot，可直接用 spring boot 默认的数据库连接池。 > [Springboot 2.x 选择 HikariCP 作为默认数据库连接池](https://blog.csdn.net/zxl315/article/details/80420688) # 填坑记 数据库设计，主建一律采用自增主键（int 类型），而前端项目，会拿各表的 int 类型的主键当 key 来保存数据之间的关联关系，这样导致数据在 state 与各页面间传输的过程中大乱。 ## 表现 - 有的地方，用 state.get(key) 获取数据时，由于 key 是 int 类型，而 state 的类型为 Map，通过修改 js 代码，用 String(key) 的方式将 key 转化为字符类型，但是即使这样转了，有的变量的（Map类型）的 key 还是为 int 类型，应该是自动转了。这样，导致本来应该有数据的地方可能得不到。最后的现象就是：帖子详情页面首次加载正常，但是刷新的时候，又取不到数据了。 - 修改 spring-boot-bbs-api 的 API，把返回的数据，将所有自增 id 改为 String 类型，问题依旧。 - 获取数据时，以字符作为 key 和以 int 作为 key，取到的数据不一样，分别为 Map 和 Object。 ![](./bbs-api-spring-boot/src/main/resources/static/img/reactGet.png) ## 解决 将 React 的 state 中用作 key 的数据，用字符而非数字。 - 保留数据库设计，在返回数据之前，将主键 id 添加前缀。 - 帖子详情页面，需要用帖子“主键”查询时，将传过来的参数的前缀过滤掉。 - 创建评论，入库前，将传过来的“主键”信息的前缀过滤掉，同时转化为 int。 # 加群一起学习 react stack(react全家桶) （QQ 群号：683414457，进群密码：`react stack`） ![](http://blog.5k8.top/img/react/reactStackLearning.png)