项目概述、开发环境搭建（day01）

软件开发整体介绍

软件开发流程

第1阶段: 需求分析

• 需求规格说明书， 一般来说就是使用 Word 文档来描述当前项目的各个组成部分，如：系统定义、应用环境、功能规格、性能需求等，都会在文档中描述。
• 产品原型，一般是通过网页(html)的形式展示当前的页面展示什么样的数据, 页面的布局是什么样子的，点击某个菜单，打开什么页面，点击某个按钮，出现什么效果，都可以通过产品原型看到。

第2阶段: 设计

• UI设计：用户界面的设计，主要设计项目的页面效果，小到一个按钮，大到一个页面布局，还有人机交互逻辑的体现。
• 数据库设计：需要设计当前项目中涉及到哪些数据库，每一个数据库里面包含哪些表，这些表结构之间的关系是什么样的，表结构中包含哪些字段。
• 接口设计：通过分析原型图，首先，粗粒度地分析每个页面有多少接口，然后，再细粒度地分析每个接口的传入参数，返回值参数，同时明确接口路径及请求方式。

角色分工

软件环境

• 开发环境(development)：开发人员在开发阶段使用的环境，一般外部用户无法访问
• 测试环境(testing)：专门给测试人员使用的环境，用于测试项目，一般外部用户无法访问
• 生产环境(production)：即线上环境，正式提供对外服务的环境

苍穹外卖项目介绍

项目介绍

定位：专门为餐饮企业（餐厅、饭店）定制的一款软件产品

功能架构：体现项目中的业务功能模块

产品原型

产品原型：用于展示项目的业务功能，一般由产品经理进行设计

技术选型

技术选型：展示项目中使用到的技术框架和中间件等

用户层

• 本项目中在构建系统管理后台的前端页面，我们会用到 H5、Vue.js、ElementUI、apache echarts (展示图表)等技术。而在构建移动端应用时，我们会使用到微信小程序。

网关层

• Nginx 是一个服务器，主要用来作为 Http 服务器，部署静态资源，访问性能高。在 Nginx 中还有两个比较重要的作用： 反向代理和负载均衡， 在进行项目部署时，要实现 Tomcat 的负载均衡，就可以通过 Nginx 来实现。

应用层

• SpringBoot： 快速构建 Spring 项目, 采用 “约定优于配置” 的思想, 简化 Spring 项目的配置开发。
• SpringMVC：SpringMVC 是 spring 框架的一个模块，springmvc 和 spring 无需通过中间整合层进行整合，可以无缝集成。
• Spring Task: 由 Spring 提供的定时任务框架。
• httpclient: 主要实现了对 http 请求的发送。
• Spring Cache: 由 Spring 提供的数据缓存框架
• JWT: 用于对应用程序上的用户进行身份验证的标记。
• 阿里云OSS: 对象存储服务，在项目中主要存储文件，如图片等。
• Swagger： 可以自动的帮助开发人员生成接口文档，并对接口进行测试。
• POI: 封装了对 Excel 表格的常用操作。
• WebSocket: 一种通信网络协议，使客户端和服务器之间的数据交换更加简单，用于项目的来单、催单功能实现。

数据层

• MySQL： 关系型数据库, 本项目的核心业务数据都会采用MySQL进行存储。
• Redis： 基于 key-value 格式存储的内存数据库, 访问速度快, 经常使用它做缓存。
• Mybatis： 本项目持久层将会使用 Mybatis 开发。
• pagehelper: 分页插件。
• spring data redis: 简化 java 代码操作 Redis 的 API。

工具

• git: 版本控制工具, 在团队协作中, 使用该工具对项目中的代码进行管理。
• maven: 项目构建工具。
• junit：单元测试工具，开发人员功能实现完毕后，需要通过junit对功能进行单元测试。
• postman: 接口测工具，模拟用户发起的各类 HTTP 请求，获取对应的响应结果。

开发环境搭建

整体结构

前端环境搭建

前端工程基于 nginx 运行

 启动 nginx：双击 nginx.exe 即可启动 nginx 服务，访问端口号为 80

后端环境搭建

项目结构

后端工程基于 maven 进行项目构建，并且进行分模块开发。

用 IDEA 打开初始工程，了解项目的整体结构

sky-common 子模块中存放的是一些公共类，可以供其他模块使用

sky-pojo 子模块中存放的是一些 entity、DTO、VO

sky-server 子模块中存放的是 配置文件、配置类、拦截器、controller、service、mapper、启动类等

后端环境搭建 – 使用Git进行版本控制

使用 Git 进行项目代码的版本控制，具体操作：

1. 创建 Git 本地仓库
2. 创建 Git 远程仓库
3. 将本地文件推送到 Git 远程仓库

 

创建远程仓库

后端环境搭建 – 数据库环境搭建

通过数据库建表语句创建数据库表结构：

后端环境搭建 – 前后端联调

后端的初始工程中已经实现了登录功能，直接进行前后端联调测试即可

注：可以通过断点调试跟踪后端程序的执行过程

先编译一下：

启动程序 

nginx 反向代理和负载均衡

nginx_百度百科

nginx 反向代理，就是将前端发送的动态请求由 nginx 转发到后端服务器

nginx 反向代理的好处：

• 提高访问速度
• 进行负载均衡
• 保证后端服务安全

所谓负载均衡,就是把大量的请求按照我们指定的方式均衡的分配给集群中的每台服务器

nginx 反向代理的配置方式

nginx 负载均衡的配置方式：

nginx 负载均衡策略

完善登录功能

问题： 员工表中的密码是明文存储，安全性太低。

解决思路：

1. 将密码加密后存储，提高安全性
2. 使用MD5加密方式对明文密码加密

实现步骤：

1. 修改数据库中明文密码，改为MD5加密后的密文
2. 修改Java代码，前端提交的密码进行MD5加密后再跟数据库中密码比对

password = DigestUtils.md5DigestAsHex(password.getBytes());

导入接口文档

前后端分离开发流程：

操作步骤

这里使用Apifox

Swagger

介绍

使用 Swagger 你只需要按照它的规范去定义接口及接口相关的信息，就可以做到生成接口文档，以及在线接口调试页面。

官网：API Documentation & Design Tools for Teams | Swagger

Spring 已经将 Swagger 纳入自身的标准，建立了 Spring-swagger 项目，现在叫Springfox。通过在项目中引入 Springfox ，即可非常简单快捷的使用 Swagger。 

作用

1. 使得前后端分离开发更加方便，有利于团队协作
2. 接口的文档在线自动生成，降低后端开发人员编写接口文档的负担
3. 功能测试

Knife4j是为Java MVC框架集成Swagger生成Api文档的增强解决方案。

使用方式

1. 导入 knife4j 的 maven 坐标
2. 在配置类中加入 knife4j 相关配置
3. 设置静态资源映射，否则接口文档页面无法访问

接口文档访问路径为： http://localhost:8080/doc.html

通过 Swagger 就可以生成接口文档，那么我们就不需要 Yapi 了？

1. Yapi 是设计阶段使用的工具，管理和维护接口
2. Swagger 在开发阶段使用的框架，帮助后端开发人员做后端的接口测试

常用注解

通过注解可以控制生成的接口文档，使接口文档拥有更好的可读性，常用注解如下：

接下来，使用上述注解，生成可读性更好的接口文档

下一节：