White Jotter

白卷是一款使用 Vue+Spring Boot 开发的前后端分离项目,附带全套开发教程。(A simple CMS developed by Spring Boot and Vue.js with development tutorials)

1875
740
Java

wjlogo.png


lisense
release

这是一个简单的项目,旨在让新入门 web 的开发者体验使用 Vue + Java(Spring Boot) + Mysql 以前后端分离模式完成开发的流程。由于开发过程中并未充分考虑安全防护问题,并不建议将该项目用于生产环境。

https://github.com/Antabot/White-Jotter)

感谢 JetBrains 提供全家桶开源许可,IDEA 确实是 Java 领域最好用的 IDE。

整体效果

首页

作为展示页面,包括开发这个项目的主要参考资料、近期更新和 Slogan

首页

图书馆

提供图书信息展示功能

图书馆

笔记本

提供笔记、博文展示功能

笔记本首页.png

文章内容.png

后台管理

包含 dashboard、内容管理、用户及权限管理等

后台

架构图

  • 应用架构

应用架构

  • 技术架构

技术架构

主要技术栈

前端

1.Vue.js
2.ElementUI
3.axios

后端

1.Spring Boot
2.Apache Shiro
3.Apache Log4j2
4.Spring Data JPA
5.Spring Data Redis

数据库

1.MySQL
2.Redis

部署方法

1.clone 项目到本地

git clone https://github.com/Antabot/White-Jotter

2.在 mysql 中创建数据库 wj,运行项目,将自动注入数据。如需关闭此功能,请将 application.properties 中的 spring.datasource.initialization-mode=always 代码删除。

数据库完整脚本 wj.sql 放在后端项目的 src\main\resources 目录下,也可根据需要自行在 MySQL 中执行数据库脚本。

运行项目前请启动 Redis 服务,端口为 6379(默认端口),密码为空。

3.数据库配置在后端项目的 src\main\resources 目录下的application.properties 文件中,mysql 版本为 8.0.15 。

4.在IntelliJ IDEA中运行后端项目,为了保证项目成功运行,可以右键点击 pom.xml 选择 maven -> reimport ,并重启项目

至此,服务端就启动成功了,同时,运行前端项目,访问 http://localhost:8080 ,即可进入登录页面,默认账号是 admin,密码是 123

如果要做二次开发,请继续看第五、六步。

5.进入前端项目根目录中,在命令行依次输入如下命令:

# 安装依赖
npm install

# 在 localhost:8080 启动项目
npm run dev

由于在 wj-vue 项目中已经配置了端口转发,将数据转发到SpringBoot上,因此项目启动之后,在浏览器中输入 http://localhost:8080 就可以访问我们的前端项目了,所有的请求通过端口转发将数据传到 SpringBoot 中(注意此时不要关闭 SpringBoot 项目)。

6.最后可以用 WebStorm 等工具打开 wj-vue项目,继续开发,开发完成后,当项目要上线时,依然进入到 wj-vue 目录,然后执行如下命令:

npm run build

该命令执行成功之后, wj-vue 目录下生成一个 dist 文件夹,可以将该文件夹中的两个文件 staticindex.html 拷贝到 wj 项目中 resources/static/ 目录下,然后直接运行 wj 项目,访问 http://localhost:8443 ,实际上是把前端打包后作为静态文件,但不推荐使用这种方式。

前后端分离部署的方式详见教程第十篇:「图片上传与项目的打包部署」

教程

我在 CSDN 上分享了开发这个项目的教程:

1.项目简介

2.使用 CLI 搭建 Vue.js 项目

3.前后端结合测试(登录页面开发)

4.数据库的引入

5.使用 Element 辅助前端开发

6.前端路由与登录拦截器

7.导航栏与图书页面设计

8.数据库设计与增删改查

9.核心功能的前端实现

10.图片上传与项目的打包部署

11.用户角色权限管理模块设计

12.访问控制及其实现思路

13.使用 Shiro 实现用户信息加密与登录认证

14.用户认证方案与完善的访问拦截

15.动态加载后台菜单

16.功能级访问控制的实现

17.后台角色、权限与菜单分配

18.博客功能开发

19.项目优化解决方案

(持续更新中)

重要更新

2020

01-20 利用开源 markdown 编辑器实现文章展示与管理模块


2019

12-01 实现功能级权限控制
11-30 利用 vue-elment-admin 项目完善后台界面设计
11-17 重构项目,完成搭建后台基础界面,实现按角色加载菜单,取消前台访问限制
04-27 使用前端拦截器,数据库迁移至 mysql 8.0.15,后台管理页面初始化
04-13 完成图片的上传功能
04-11 完成图书分类功能
04-08 完成图书分页功能
04-06 完成图书查询功能
04-05 完成图书修改功能
04-04 完成图书删除功能
04-03 完成图书新增功能