旧版本已经迁移到V4分支，如果你在找作业4，请前往https://github.com/AsakiRain/bookstore_be/tree/v4
因为前后端分离，后端只用servlet没有jsp。使用了fastjson和auth0-jwt
- Java 17.0.5 64-Bit
- Tomcat 10.1.2
- MySQL 5.7.35-log
- com.alibaba.fastjson2:fastjson2 2.0.19
- com.auth0:java-jwt3 4.2.1
- mysql:mysql-connector-java 8.0.30
controller中是响应请求的处理逻辑model中是用到的数据结构和对象相关的方法utils中是一些工具类，封装了一套返回数据结构database中封装了基础的数据库操作
接口文档地址：https://www.apifox.cn/web/project/2212722
建议下载apifox进行调试
- 所有的接口返回的都是
json格式的数据 - GET方法接收的数据采用
query参数，POST，PUT，DELETE方法接收的数据采用json格式 - 鉴权使用
jwt，需要鉴权的请求中被携带在头部Authorization字段中，具体可以打开devtools或者apifox查看 - 如果出现调用上的错误会返回400，如发送的数据不完整，或者数据格式错误等
- 如果
jwt token验证失败会返回401，此时需要重新登录获取新的token - 如果有500，我是没有遇到过，建议
debug完叫我一下 - 推荐前端使用
fetch函数进行ajax请求。
| 请求方式 | 接口 | 说明 | 状态 |
|---|---|---|---|
| POST | /register | 注册 | ✅ |
| POST | /login | 登录 | ✅ |
| GET | /book/show?isbn={isbn} | 获取书籍详细信息 | ✅ |
| DELETE | ❌被废弃👇 | ||
| PUT | ❌被废弃👇 | ||
| POST | ❌被废弃👇 | ||
| GET | ❌被废弃👇 | ||
| PUT | ❌被废弃：用户购物车现在是前端缓存 | ||
| DELETE | ❌被废弃：用户购物车现在是前端缓存 | ||
| GET | ❌被废弃👇 | ||
| GET | /goods/list?page={page} | 获取书籍列表 | ✅ |
| GET | /goods/search?keyword={keyword}&page={page} | 搜索书籍 | ✅ |
| GET | /user/info | 获取用户信息 | ✅ |
| PUT | /user/info | 修改用户信息 | ✅ |
| PUT | /user/password | 修改密码 | ✅ |
| GET | /order/list?page={page} | 获取订单列表 | ✅ |
| GET | /order/purchase?isbn={isbn} | 购买前信息展示 | ✅ |
| POST | /order/purchase?isbn={isbn} | 购买书籍 | ✅ |
| GET | /order/show?serial={serial} | 查看订单状态 | ✅ |
| POST | /order/finish?serial={serial} | 完成订单 | ✅ |
| DELETE | /manage/stock?isbn={isbn} | 删除书籍 | ✅ |
| PUT | /manage/stock | 修改书籍信息 | ✅ |
| POST | /manage/stock | 添加书籍 | ✅ |
| GET | /manage/order/list?page={page} | 店员获取订单列表 | ✅ |
| GET | /manage/order/show?serial={serial} | 店员获取订单状态 | ✅ |
| POST | /manage/order/process?serial={serial} | 店员审核和发货 | ✅ |
| GET | /admin/statistics | 店长获取统计信息 | 🤡未做 |
- 打开一个
MySQL Command Line客户端，输入用户名密码
- 运行
CREATE DATABASE `bookstore` CHARACTER SET 'utf8mb4' COLLATE 'utf8mb4_unicode_ci';创建数据库 - 运行
use bookstore;选择数据库 - 找到项目根目录下面的
bookstore.sql文件夹，运行source D:\code\bookstore4_be\bookstore.sql导入数据库注意，这里的路径要是你的项目实际路径
- （可跳过）运行
CREATE USER `crud`@`%` IDENTIFIED WITH mysql_native_password BY 'ssr129631';创建用户
（可跳过）运行GRANT Alter, Alter Routine, Create, Create Routine, Create Temporary Tables, Create View, Delete, Drop, Event, Execute, Grant Option, Index, Insert, Lock Tables, References, Select, Show View, Trigger, Update ON `bookstore`.* TO `crud`@`%`;
为他授予数据库权限
- 去
src/Config.java修改一下你的数据库配置，比如多数人的端口是3306，和我的默认配置不一样。如果你跳过了上面两步，可以把账号密码设置成root用户直接连接。
- 已经结束了，大的还在后头
git clone下来一个干净的文件夹
- 删除
.idea文件夹，日他仙人
- 打开项目，观察到
maven已经正确下载了依赖
- 在
web/WEB-INF下创建文件夹classes和lib - 在工具栏打开文件→项目结构→模块→路径
- 选择使用模块编译输出路径，并且设置目录为刚刚创建的
classes
- 切换到依赖选项卡，把所有
maven依赖打勾，并且把范围都设置成编译
- 点击左上角加号，选择添加
JAR或目录
- 选择本机
tomcat目录下的lib文件夹，不是刚刚创建的那个lib
- 切换到
Facet选项卡，点击加号，选择web，点击确认
- 右下角出现警告，点击创建工件，跳转到工件选项卡
- 选中右侧所有的可选依赖，右键选择置于
/WEB-INF/lib
- 大功告成，点击应用并退出
- 添加一个运行配置，大概像我这样
- 运行，如果弹出浏览器访问显示404是正常的，因为/并没有对应的
servlet
- 相关请求
api都在apifox里面，请求路径以http://127.0.0.1:8080/bookstore4_be/api/ 开头,如http://127.0.0.1:8080/bookstore4/api/login ，http://127.0.0.1:8080/bookstore4/api/booklist/page?page=1
- 访问https://www.apifox.cn/，注册一个账号，下载客户端
- 访问项目地址https://www.apifox.cn/web/project/1958328，点击项目设置并登录
- 登陆后来到项目操作，选择克隆项目
- 选择你自己的团队（比如示例团队），然后确认
- 打开的桌面客户端，你应该能找到克隆过来的项目，如果没有，点一下软件右上角的刷新
- 你可以随时点击左上角的项目名称来切换团队和项目
- 左侧接口列表显示了所有的接口，可以点击三角形展开接口分组和数据模型
- 先配置一个测试环境，点击右上角的云端
MOCK下拉菜单，展开环境配置，选择测试环境
如果你的
tomcat不在8080端口，或者你在idea中配置的请求上下文路径和教程不一样，就需要进入管理环境按照实际情况填写 - 现在打开后端服务器，点击登录接口左侧的三角并选择成功用例
可以看到成功用例自动填入了body请求体，请求链接等 - 点击发送，查看返回值是否符合预期
- 此外，你可以切换到各个接口来查看接口文档，或者修改文档
