本项目旨在总结前后端分离常用技术点，形成集前端+后端+小程序+移动端一整套的个人技术博客解决方案。技术采用主流前后端分离微服务架构，并涵盖持续集成及自动化部署的相关解决方案。既然是以学习为目的，可能并不是以做成一个博客系统为最终目标，可能会基于此基础之上进行技术的扩充。
技术方面，后端采用Java技术栈，前端使用工程化的SPA单体应用实现。项目计划分为两个版本分别为vue+Spring Cloud、react+Dubbo。除了还该常用的增删改查业务之外，也会涉及高并发、限流、支付、爬虫等主流流行技术点。
业务方面分为后台+前台场景，后台管理系统负责对整个网站进行管理，前台为展示个人博客内容。除了实现博客的常用功能外，也希望加入秒杀、分布式搜索、区块链等功能。
本人才疏学浅，可能有些观点不是很成熟，考虑的没有很全面，望大家积极指正。也希望可以结识更多热爱技术的朋友，一起加油，一起进步。
所用到的主要技术点：
数据库：MySql
数据访问层：Mybatis、Spring Data Jpa
NoSql：Redis、MongoDB
持续集成：docker、k8s
分布式搜索：ElasticSearch
消息队列：RabbitMQ、ActiveMQ
版本控制：git
依赖管理：maven
分布式：Spring Boot、Spring Cloud、Dubbo、Spring Cloud Alibaba
其他：Quartz、FFmpeg、Spring、maven、SSO、WebMagic、Netty等
前端框架：Vue、React、Ant Design、Element UI
网络请求：axios、Fetch
表格图表：ECharts
数据状态管理：redux、vuex
路由管理：react-router、vue-router
小程序：mpvue
代码检查工具：ESLint
代码打包工具：webpack
1.登录注册：实现对用户名、手机号及扫码的登录实现，实现单点登陆功能。
2.文章模块:对文章进行管理
3.分类目录：对分类目录进行管理
4.文章标签模块
5.作品管理：可添加自己的作品
6.友情链接管理
7.页面管理
8.评论管理
9.菜单管理
10.用户管理
11.网站seo设置
12.媒体资源管理：fastdfs
13.网站爬虫设计：可以抓取指定的数据到个人博客中
14.课程管理：可以发布自己的视频等课程资源，实现收费及免费功能。包括支付
15.统计模块：统计网站访问量、评论量、等信息记录网站的历程
16.搜索：分布式搜索实现对文章的搜索功能。
17.活动与招聘信息
18.吐槽与问答
19.网站数据备份与导入导出
20.数据字典管理
...
目前主流的技术架构采用前后端分离技术实现，在项目工程上来讲，也应是分离的项目。每个项目进行单独开发。下面是本项目中所有的工程目录。
Java采用Spring Boot + Spring Cloud + Spring Data JPA 技术栈
后端项目地址：https://github.com/iquanzhan/vblog-spring-cloud
前端采用react技术栈
前端项目地址：https://github.com/iquanzhan/vblog-web-react
Java采用Spring Boot + Dubbo + MyBatis 技术栈
后端项目地址：https://github.com/iquanzhan/vblog-dubbo
前端采用vue技术栈
前端项目地址：https://github.com/iquanzhan/vblog-web-vue
使用nginx+docker+k8s进行持续集成与发布管理。
java采用jdk1.8
Java端采用IDEA进行开发：下载地址：https://www.jetbrains.com/
使用IDEA时有不少优质的插件，推荐安装：
- Grep console： 支持自定义控制台不同级别的日志颜色
- Free Mybatis plugin ：根据Mapper类中方法名可直接跳转到mapper.xml
- MyBatis Log Plugin : 默认情况下MyBatis显示的脚本不是可执行的，这个插件就可以直接将Mybatis执行的sql脚本
- Alibaba Java Coding Guidelines ：阿里巴巴代码规范检查插件
- Lombok ：利用注解的形式，省去get/set等方法
- Gsonformat ：可以根据json快速生成java实体
- Restfultookit ：主要用于调试接口，可以生成默认的数据，可根据Url快速找到对应的controller
- JRebel ：热部署插件
- GenerateAllSetter :new POJO类的时候快速生成set方法
如果其他小伙伴有更好的插件推荐，欢迎提出哦~
前端采用VS Code进行开发：下载地址：https://code.visualstudio.com/
为了便于开发VS Code也有不少优质的插件推荐：
- Auto Close Tag：自动添加html的关闭标签
- Auto Rename Tag：修改标签时，自动修改结束标签的名字
- Beautify ：代码美化格式化工具
- Color Info ：css中设置颜色时显示色彩信息
- ESLint ：前端规范插件，可以检查语法错误
- JavaScript (ES6) code snippets：ES6语法提示
- Path Intellisense：输入路径后自动补全
- vscode-element-helper：element UI库的代码提示
- npm Intellisense：在导包时对依赖包进行提示
- Reactjs code snippets：react代码提示插件
- React Redux ES6 Snippets ：Redux代码片段工具
- React-Native/React/Redux snippets for es6/es7 ：react代码片段工具
- Vetur ： Vue多功能集成插件，包括：语法高亮，智能提示，emmet，错误提示，格式化，自动补全，debugger。vscode官方钦定Vue插件，Vue开发者必备
- Bracket Pair Colorizer ： 给括号加上不同的颜色，便于区分不同的区块，使用者可以定义不同括号类型和不同颜色
本项目中所有接口，采用restful风格进行开发。
何为restful？请见：https://blog.csdn.net/x541211190/article/details/81141459
对于restful风格api的设计，推荐阮一峰大神的RESTFul设计指南
接口是后端程序员开发的，如果等待后端程序员开发完毕，再去开发前端的内容，效率是很低的。
对于前端程序员而言，其实也只是关注请求路径、参数及响应体而已，这就意味着，我们可以根据定义使用工具生成接口文档，前后端程序员按照接口文档进行开发。哪怕以后会有接口的变动也不会很大。
对于前后端联调我们采用如下模式：
后端：后端通过集成swagger进行接口的定义，生成接口文档，导入easy-mock中。供前端使用。后端可以根据swagger或postman配合进行测试。
前端：使用接口时，利用easy-mock进行数据请求模拟。前端程序员按照mock模拟的请求数据进行开发。
总体而言前后端一定是独立开发。
1.请求路径尽量采用名词形式（如user、order、article等），尽量少采用动词如（createUser、createOrder等）。
2.路径中有多个单词时使用中划线'-'来连接
3.不允许在路径中出现大写字母（参数名除外）
4.返回的数据可视尽量使用json，不得使用xml等其他形式
GET /users # 获取用户列表
GET /users/{userId} # 查看单个的用户信息
POST /users # 新建一个用户
PUT /users/{userId} # 全量更新某一个用户信息
PATCH /users/{userId} # 选择性更新某一个用户信息
DELETE /users/{userId} # 删除某一个用户
?limit=10：指定返回记录的数量
?offset=10：指定返回记录的开始位置。
?page=2&per_page=100：指定第几页，以及每页的记录数。
?sortby=name&order=asc：指定返回结果按照哪个属性排序，以及排序顺序。
?animal_type_id=1：指定筛选条件
状态码及其含义：
- 200 OK - [GET]：服务器成功返回用户请求的数据，该操作是幂等的（Idempotent）。
- 201 CREATED - [POST/PUT/PATCH]：用户新建或修改数据成功。
- 202 Accepted - [*]：表示一个请求已经进入后台排队（异步任务）
- 204 NO CONTENT - [DELETE]：用户删除数据成功。
- 400 INVALID REQUEST - [POST/PUT/PATCH]：用户发出的请求有错误，服务器没有进行新建或修改数据的操作，该操作是幂等的。
- 401 Unauthorized - [*]：表示用户没有权限（令牌、用户名、密码错误）。
- 403 Forbidden - [*] 表示用户得到授权（与401错误相对），但是访问是被禁止的。
- 404 NOT FOUND - [*]：用户发出的请求针对的是不存在的记录，服务器没有进行操作，该操作是幂等的。
- 406 Not Acceptable - [GET]：用户请求的格式不可得（比如用户请求JSON格式，但是只有XML格式）。
- 410 Gone -[GET]：用户请求的资源被永久删除，且不会再得到的。
- 422 Unprocesable entity - [POST/PUT/PATCH] 当创建一个对象时，发生一个验证错误。
- 500 INTERNAL SERVER ERROR - [*]：服务器发生错误，用户将无法判断发出的请求是否成功。结合阮一峰的文章，响应的数据格式如下：
1.正常的响应应该直接返回需要的数据，而无需嵌套或添加任何额外信息。此时HTTP的返回码可以为：
200 OK - [GET]：服务器成功返回用户请求的数据，该操作是幂等的（Idempotent）。
201 CREATED - [POST/PUT/PATCH]：用户新建或修改数据成功。
202 Accepted - [*]：表示一个请求已经进入后台排队（异步任务）
204 NO CONTENT - [DELETE]：用户删除数据成功。2.如果状态码是4xx，就应该向用户返回出错信息。一般来说，返回的信息中将error作为键名，出错信息作为键值即可：
{
msg: "error message"
}但很多时候HTTP状态码并不足以表达服务端的所有异常，此时，我们就需要额外定义错误码，而HTTP状态码仅表示错误的大类型。例如，若查找的指定用户信息不存在，HTTP状态码依旧为404，响应可以返回：
{
"code": 40401,
"msg": "user 11 not found!"
}其中，code为自定义错误码40401，error为其对应的错误内容。40401的前缀404表示资源不存在，01可以表示具体表示user这种资源不存在。
总体而言4xx表示客户端错误，5xx表示服务端错误，业务中更细粒度的可以采用自定义响应码实现。响应体必须采用json格式传送
对于提供给APP（android、ios、pc） 的接口我们可能需要关注一些调用信息，例如 用户登录信息、调用来源、app版本号、api的版本号、安全验证信息 等等，我们将这些信息放入头信息（HTTP HEADER中），下面给出在参数命名的例子：
X-Token 用户的登录token
Api-Version api的版本号
App-Version app版本号
Call-Source 调用来源(IOS、ANDROID、PC、WECHAT、WEB)
本项目暂定数据库设计规范如下：
1.表名及字段名必须使用小写字母或者数字（MySql在Windows下不区分大小写，但在MySql中式默认区分大小写的，避免节外生枝，不要出现任何大写字母），禁止出现数字开头，更禁止两个下划线之间仅有数字。
2.表名不使用复数名词（仅用来表示实体的内容，不应表示实体的数量）。表的命名遵循“业务名称_表的作用”进行命名，如trade_config。数据库名与应用名称尽量一致。
3.表达是否概念时，使用is_xxx的方式命名，数据类型为unsigned tinyint，并且1表示是，0表示否。小数类型为decimal，禁止使用float和double（在存储float和double时存在精度损失问题，可能会导致比较值时，得不到正确的结果）。如果存储的数据范围超过decimal，将数据拆分为整数和小数部分分开存储。
4.varchar 是可变长字符串，不预先分配存储空间，长度不要超过 5000，如果存储长度大于此值，定义字段类型为 text ，独立出来一张表，用主键来对应，避免影响其它字段索引效率。
5.表必备三字段：id, create_time, update_time。
6.数据库表之间外键，采用逻辑外键而非物理外键。（采用逻辑外键，以免级联更新造成的低并发问题，级联更新是强阻塞，不适合分布式高并发系统。同时物理外键存在数据库更新风暴的风险，外键也会大大影响数据库的插入速度）
7.禁止使用存储过程，存储过程难以调试和扩展，没有移植性。
1.代码中写分页查询逻辑时，若 count 为 0 应直接返回，避免执行后面的分页语句。
2.数据订正（特别是删除、修改记录操作）时，要先 select ，避免出现误删除，确认无 误才能执行更新语句。
3.在表查询中，一律不要使用 * 作为查询的字段列表，需要哪些字段必须明确写明
4.POJO 类的布尔属性不能加 is，而数据库字段必须加 is_，要求在 resultMap 中进行字段与属性之间的映射。
5.不要用 resultClass 当返回参数，即使所有类属性名与数据库字段一一对应，也需要定义；反过来，每一个表也必然有一个 POJO 类与之对应。
7.不允许直接拿 HashMap 与 Hashtable 作为查询结果集的输出。
8.不要写一个大而全的数据更新接口。传入为 POJO 类，不管是不是自己的目标更新字段，都进行 update table set c1=value1,c2=value2,c3=value3; 这是不对的。执行 SQL时，不要更新无改动的字段，一是易出错；二是效率低；三是增加 binlog 存储。更新数据表记录时，必须同时更新记录对应的 gmt_modified 字段值为当前时间。
数据库设计工具采用EZDML 进行设计。