novel 是一套基于时下最新 Java 技术栈 Spring Boot 3 + Vue 3 开发的前后端分离的学习型小说项目，配备详细的项目教程手把手教你从零开始开发上线一个生产级别的 Java 系统，由小说门户系统、作家后台管理系统、平台后台管理系统、爬虫管理系统等多个子系统构成。包括小说推荐、作品检索、小说排行榜、小说阅读、小说评论、充值订阅、新闻发布等功能。
- MySQL 8.0
- Redis 7.0
- Elasticsearch 8.2.0（可选）
- RabbitMQ 3.10.2（可选）
- JDK 17
- Maven 3.8
- IntelliJ IDEA 2021.3（可选）
- Node 16.14
| 技术 | 版本 | 说明 | 官网 | 学习 |
|---|---|---|---|---|
| Spring Boot | 3.0.0-SNAPSHOT | 容器 + MVC 框架 | https://spring.io/projects/spring-boot | 进入 |
| MyBatis | 3.5.9 | ORM 框架 | http://www.mybatis.org | 进入 |
| MyBatis-Plus | 3.5.1 | MyBatis 增强工具 | https://baomidou.com/ | 进入 |
| JJWT | 0.11.5 | JWT 登录支持 | https://github.com/jwtk/jjwt | - |
| Lombok | 1.18.24 | 简化对象封装工具 | https://github.com/projectlombok/lombok | 进入 |
| Caffeine | 3.1.0 | 本地缓存支持 | https://github.com/ben-manes/caffeine | 进入 |
| Redis | 7.0 | 分布式缓存支持 | https://redis.io | 进入 |
| MySQL | 8.0 | 数据库服务 | https://www.mysql.com | 进入 |
| Elasticsearch | 8.2.0 | 搜索引擎服务 | https://www.elastic.co | 进入 |
| RabbitMQ | 3.10.2 | 开源消息中间件 | https://www.rabbitmq.com | 进入 |
| Undertow | 2.2.17.Final | Java 开发的高性能 Web 服务器 | https://undertow.io | 进入 |
| Docker | - | 应用容器引擎 | https://www.docker.com/ | - |
| Jenkins | - | 自动化部署工具 | https://github.com/jenkinsci/jenkins | - |
| Sonarqube | - | 代码质量控制 | https://www.sonarqube.org/ | - |
注：更多热门新技术待集成。
| 技术 | 版本 | 说明 | 官网 | 学习 |
|---|---|---|---|---|
| Vue.js | 3.2.13 | 渐进式 JavaScript 框架 | https://v3.cn.vuejs.org | 进入 |
| Vue Router | 4.0.15 | Vue.js 的官方路由 | https://router.vuejs.org/zh/index.html | 进入 |
| axios | 0.27.2 | 基于 promise 的网络请求库 | https://axios-http.com/zh | 进入 |
| element-plus | 2.2.0 | 基于 Vue 3，面向设计师和开发者的组件库 | https://element-plus.org/zh-CN/ | 进入 |
- 规范方式：严格遵守阿里编码规约。
- 命名统一：简介最大程度上达到了见名知意。
- 分包明确：层级分明可快速定位到代码位置。
- 注释完整：描述性高大量减少了开发人员的代码阅读工作量。
- 工具规范：使用统一jar包避免出现内容冲突。
- 代码整洁：可读性、维护性高。
- 依赖版本：所有依赖均使用当前最新可用版本以便新技术学习。
io
+- github
+- xxyopen
+- novel
+- NovelApplication.java -- 项目启动类
|
+- core -- 项目核心模块，包括各种工具、配置和常量等
| +- common -- 业务无关的通用模块
| | +- exception -- 通用异常处理
| | +- constant -- 通用常量
| | +- req -- 通用请求数据格式封装，例如分页请求数据
| | +- resp -- 接口响应工具及响应数据格式封装
| | +- util -- 通用工具
| |
| +- auth -- 用户认证授权相关
| +- config -- 业务相关配置
| +- constant -- 业务相关常量
| +- filter -- 过滤器
| +- interceptor -- 拦截器
| +- json -- JSON 相关的包，包括序列化器和反序列化器
| +- task -- 定时任务
| +- util -- 业务相关工具
| +- wrapper -- 装饰器
|
+- dto -- 数据传输对象，包括对各种 Http 请求和响应数据的封装
| +- req -- Http 请求数据封装
| +- resp -- Http 响应数据封装
|
+- dao -- 数据访问层，与底层 MySQL 进行数据交互
+- manager -- 通用业务处理层，对第三方平台封装、对 Service 层通用能力的下沉以及对多个 DAO 的组合复用
+- service -- 相对具体的业务逻辑服务层
+- controller -- 主要是处理各种 Http 请求，各类基本参数校验，或者不复用的业务简单处理，返回 JSON 数据等
| +- front -- 小说门户相关接口
| +- author -- 作家管理后台相关接口
| +- admin -- 平台管理后台相关接口
| +- app -- app 接口
| +- applet -- 小程序接口
| +- open -- 开放接口，供第三方调用
- 首页
- 分类索引页
- 搜索页
- 排行榜
- 详情页
- 阅读页
- 用户中心
- 充值
- 作家专区
- 购买
此安装步骤的前提是需要保证上一节的开发环境可用。
- 下载后端源码
git clone https://gitee.com/novel_dev_team/novel.git
-
数据库文件导入
-
新建数据库（建议 novel）
-
解压后端源码
doc/sql/novel.sql.zip压缩包，得到数据库结构文件novel_struc.sql和数据库小说数据文件novel_data.sql -
导入
novel_struct.sql数据库结构文件 -
导入
novel_data.sql数据库小说数据文件
-
-
novel 后端服务安装
- 修改
src/resources/application.yml配置文件中的数据源配置
spring: datasource: url: jdbc:mysql://localhost:3306/novel_test?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai username: root password: test123456- 修改
src/resources/application.yml配置文件中的redis连接配置
spring: redis: host: 127.0.0.1 port: 6379 password: 123456- 项目根目录下运行如下命令来启动后端服务（有安装 IDE 的可以导入源码到 IDE 中运行）
mvn spring-boot:run- 根据前后端的实际部署情况，修改
application.yml中的跨域配置（默认情况可忽略此步骤）
- 修改
-
下载前端前台门户系统源码
git clone https://gitee.com/novel_dev_team/novel-front-web.git
-
novel-front-web 前端前台门户系统安装
-
根据前后端的实际部署情况，修改
.env.development中的VUE_APP_BASE_API_URL属性（默认情况可忽略此步骤） -
yarn安装
npm install -g yarn- 项目根目录下运行如下命令来安装项目依赖
yarn install- 项目根目录下运行如下命令启动
yarn serve- 浏览器通过
http://localhost:1024来访问
-
关注公众号接收项目最新动态，获取Spring Boot 3学习笔记！
加微信群学习交流，公众号后台回复「微信群」即可。
发送「资料」获取JAVA 面试参考、海量简历模板、技术电子书等学习面试资料。
开源项目不易，若此项目能得到你的青睐，那么你可以赞赏支持作者持续开发与维护。
- 更完善的文档教程
- 服务器的费用也是一笔开销
- 为用户提供更好的开发环境
- 一杯咖啡
