- 视频链接:黑马程序员【Java 项目实战《瑞吉外卖》,轻松掌握 SpringBoot + MybatisPlus 开发核心技术】
- 资料链接:2022 最新版 Java学习 路线图>第 5 阶段一 企业级项目实战>7.黑马程序员 瑞吉外卖平台实战开发(提取码:dor4)
- 本文章发布在CSDN上,一是方便博主自己线上阅览,二是巩固自己所学知识。
- 博客内容主要参考上述视频和资料,视频中出现的 PPT 内容大体也为本文所录。
- 参考博客【瑞吉外卖项目剩余功能补充】的链接:https://blog.csdn.net/weixin_53142722/article/details/124371940
- 若文章内容或图片失效,请留言反馈。部分素材来自网络,若不小心影响到您的利益,请联系博主删除。
文章目录
- 0.总目录
- 1.文件上传下载
- 1.1.文件上传介绍
- 1.2.文件下载介绍
- 1.3.准备工作
- 1.3.1.upload.html
- 1.3.2.基本架构
- 1.4.文件上传代码实现
- 1.5.文件下载代码实现
- 2.新增菜品
- 2.1.需求分析
- 2.2.数据模型
- 2.3.准备工作
- 2.4.代码开发
- 2.4.1.梳理交互过程
- 2.4.2.查询分类数据
- 2.4.3.接收页面提交的数据
- 3.菜品信息的分页查询
- 3.1.需求分析
- 3.2.代码开发
- 3.2.1.梳理交互过程
- 3.2.2.代码实现
- 4.修改菜品
- 4.1.需求分析
- 4.2.代码开发
- 4.2.1.梳理交互过程
- 4.2.2.代码实现
- 5.其他功能
- 5.1.需求分析
- 5.2.菜品管理业务前端初步分析
- 5.3.菜品启售/停售
- 5.3.1.需求分析
- 5.3.2.前端分析
- 5.3.3.后端代码编写
- 5.4.删除功能
- 5.4.1.需求分析
- 5.4.2.前端分析
- 5.4.3.后端代码编写
上一篇:学习【瑞吉外卖③】SpringBoot单体项目:https://blog.csdn.net/yanzhaohanwei/article/details/125110127
0.总目录
- 学习【瑞吉外卖①】SpringBoot单体项目
- 软件开发流程、瑞吉外卖项目介绍、环境搭建、后台登录功能、后台退出功能
- 学习【瑞吉外卖②】SpringBoot单体项目
- 完善登录功能、 新增员工功能、员工信息分页查询功能、启用 / 禁用员工账号(即更改员工账号状态)功能、编辑员工信息功能
- 学习【瑞吉外卖③】SpringBoot单体项目
- 公共字段自动填充功能、新增分类功能、分类信息分页查询功能、删除分类功能、修改分类功能
- 学习【瑞吉外卖④】SpringBoot单体项目
- 文件上传下载功能、新增菜品功能、菜品信息分页查询功能、修改菜品功能
- 其他功能:删除单个菜品功能、停售 / 启售单个菜品功能、批量删除菜品功能、批量停售 / 批量启用菜品功能。
- 学习【瑞吉外卖⑤】SpringBoot单体项目
- 学习【瑞吉外卖⑥】SpringBoot单体项目
1.文件上传下载
1.1.文件上传介绍
文件上传,也称为 upload ,是指将本地图片、视频、音频等文件上传到服务器上,可以供其他用户浏览或下载的过程。
文件上传在项目中应用非常广泛,我们经常发微博、发微信朋友圈都用到了文件上传功能。
- 文件上传时,对页面的 form 表单有如下的要求。
- method="post"
- 采用 post 方式提交数据
- enctype="multipart/form-data"
- 采用 multipart 格式上传文件
- type="file"
- 使用 input 的 file 控件上传
- method="post"
举例
目前一些前端组件库也提供了相应的上传组件,但是底层原理还是基于 form 表单的文件上传。
例如 ElementUI 中提供的 upload 上传组件。
- 服务端要接收客户端页面上传的文件,通常都会使用 Apache 两个组件。
- commons-fileupload
- commons-io
Spring 框架在 spring-web 包中对文件上传进行了封装,大大简化了服务端代码。
我们只需要在 Controller 的方法中声明一个 MultipartFile 类型的参数即可接收上传的文件。
@PostMapping(value = "/upload") public Rupload(MultipartFile file) { System.out.println(file); return null; }
1.2.文件下载介绍
文件下载,也称为 download,是指将文件从服务器传输到本地计算机的过程。
- 通过浏览器进行文件下载,通常有两种表现形式。
- 以附件形式下载,弹出保存对话框,将文件保存到指定磁盘目录。
- 直接在浏览器中打开。
通过浏览器进行文件下载,本质上就是服务端将文件以流的形式写回浏览器的过程。
1.3.准备工作
1.3.1.upload.html
可以直接使用资料中提供的上传页面:upload.html
其中 upload.html 所在位置:1.瑞吉外卖项目/资料/文件上传下载页面/upload.html
将 upload.html 复制到 resources 目录下的 backend/page/demo/ 中
以下是 backend/page/demo/upload.html 中的代码
文件上传
1.3.2.基本架构
为了方便测试,我们需要在告诉拦截器不需要拦截的路径:/common
@RestController
@RequestMapping("/common")
@Slf4j
public class CommonController {
@Value("${reggie.path}")
private String basePath;
@PostMapping("/upload")
public R !注意:MultipartFile 定义的 file 变量必须与 name 保持一致,否则传递值为空。 com/itheima/reggie/controller/CommonController.java 文件下载,页面端可以使用 标签展示下载的图片 com/itheima/reggie/controller/CommonController.java 可以通过 localhost:8080/backend/page/demo/upload.html 这个路径来测试以上代码。 后台系统中可以管理菜品信息,通过新增功能来添加一个新的菜品。 在添加菜品时需要选择当前菜品所属的菜品分类,并且需要上传菜品图片,在移动端会按照菜品分类来展示对应的菜品信息。 新增菜品,其实就是将新增页面录入的菜品信息插入到 dish 表。 如果添加了口味做法,还需要向 dish_flavor 表插入数据。 所以在新增菜品时,涉及到两个表:dish(菜品表)、dish_flavor(菜品口味表) com/itheima/reggie/entity/DishFlavor.java com/itheima/reggie/mapper/DishFlavorMapper.java com/itheima/reggie/service/DishFlavorService.java com/itheima/reggie/service/impl/DishFlavorServiceImpl.java com/itheima/reggie/controller/DishController.java 在开发代码之前,需要梳理一下新增菜品时前端页面和服务端的交互过程。 开发新增菜品功能,其实就是在服务端编写代码去处理前端页面发送的这 4 次请求即可。 图片的上传下载功能在本博客的【1.文件上传下载】中已经详细阐述过了,这里不再赘述。 页面(backend/page/food/add.htm)发送 ajax 请求,请求服务端获取菜品分类数据并展示到下拉框中。 通过 resources 目录下的 backend/page/food/add.html ,来理解菜单分类的列表展示的前端的逻辑。 然后查找 getDishList() 方法的具体实现代码。 通过 Idea 快捷键 CTRL+B 找到其调用的 getCategoryList()。 backend/api/food.js 通过 /category/list 得知,我们需要在 Controller 层编写代码来响应其的请求。 编写代码 com/itheima/reggie/controller/CategoryController.java 点击保存按钮,发送 ajax 请求,将菜品相关数据以 json 形式提交到服务端。 因为 Dish 实体类中没有对 flavors 中的数据做过声明,所以我们需要封装一个新类来处理所有参数。 DTO,全称为 Data Transfer object,即数据传输对象,一般用于展示层与服务层之间的数据传输。 com/itheima/reggie/dto/DishDto.java com/itheima/reggie/service/DishService.java com/itheima/reggie/service/impl/DishServiceImpl.java 事实上在博客【瑞吉外卖③】SpringBoot单体项目中我们已经创建 Service 和 ServiceImpl 的基本架构了,这里主要是添加相关方法。 !注意:因为涉及到多张表的具体操作,需要使用 @Transactional 来开启事务,在启动类上加入注解 @EnableTransactionManagement 使得上面的注解生效。但是 @SpringBootApplication 这个注解是默认自动开启 @EnableTransactionManagement,所以其实也可以对启动类做操作。 com/itheima/reggie/controller/DishController.java 系统中的菜品数据很多的时候,如果在一个页面中全部展示出来会显得比较乱,不便于查看。 所以一般的系统中都会以分页的方式来展示列表数据。 在开发代码之前,需要梳理一下菜品分页查询时前端页面和服务端的交互过程: 页面(backend/page/food/list.html)发送ajax请求,将分页查询参数(page、pageSize、name)提交到服务端,获取分页数据。 页面发送请求,请求服务端进行图片下载,用于页面图片展示。 开发菜品信息分页查询功能,其实就是在服务端编写代码去处理前端页面发送的这2次请求即可。 com/itheima/reggie/controller/DishController.java 这里需要注意的是,之前我们设置了浏览器图片上传下载的位置,但是没有在里面导入图片,所以部分图片是显示不出来的。 控制台会报空指针异常。 要想避免以上情况,需要在我们之前设置的位置里导入图片。 比如我之前在 application.yml 中设置了 reggie 属性: path: D:D_FileD_PicturesIdeaProjectsPicturesReggieTakeout。 那么我把相关图片导入进该目录下即可。(相关图片资源在 瑞吉外卖-资料瑞吉外卖项目资料图片资源 中) 在菜品管理列表页面点击修改按钮,跳转到修改菜品页面,在修改页面回显菜品相关信息并进行修改,最后点击确定按钮完成修改操作。 在开发代码之前,需要梳理一下修改菜品时前端页面(add.html)和服务端的交互过程: 开发修改菜品功能,其实就是在服务端编写代码去处理前端页面发送的这4次请求即可。 其中第1步、第3步的操作前面已经完成了。(新增、修改界面本质上用的是同一个界面) com/itheima/reggie/service/DishService.java 根据 id 查询菜品信息和对应的口味信息 更新菜品信息,同时更新对应的口味信息 com/itheima/reggie/service/impl/DishServiceImpl.java 根据 id 查询菜品信息和对应的口味信息 更新菜品信息,同时更新对应的口味信息 com/itheima/reggie/controller/DishController.java 根据 id 查询菜品信息和对应的口味信息 修改菜品 在此处补充一下 idea 控制台输出的 部分SQL 语句的展示 在商品买卖过程中,商品停售,起售可以更加方便的让用户知道店家还有什么类型的商品在卖。删除方法也更方便的管理菜品。 当我们使用浏览器对其调试时,显然发现 http:/localhost:8080/backend/page/food/list.html 可以作为切入点来了解前后端的交互关系。 因为该项目的命名较为规范,我们很容易在 resources 目录下找到对应的前端页面:backend/page/food/list.html。 这里是 backend/page/food/list.html 引用的 js 文件。 接下来的分析也基本上是根据以上的页面,以及相关引用 js 文件来分析编码的。 下面的代码是 backend/page/food/list.html 中的 data() 中封装的属性。 在菜品管理列表页面,可以单个菜品进行 启售 / 停售 操作。 也可以批量启售 / 停售菜品。 点击“停售”按钮时,浏览器发送的请求消息。 显然,前端发送的是 POST 请求方式:http://localhost:8080/dish/status/1?ids=... , ... backend/page/food/list.html 中的 “启售 / 停售“” 按钮对应的代码 backend/page/food/list.html 中的 “启售 / 停售“” 按钮对应的代码所调用的方法 。 状态更改方法:statusHandle() statusHandle() 中调用了 backend/api/food.js 的 dishStatusByStatus。 com/itheima/reggie/service/DishService.java com/itheima/reggie/service/impl/DishServiceImpl.java com/itheima/reggie/controller/DishController.java 在菜品管理列表页面,可以对单个菜品进行删除操作,也可以对菜品进行批量删除。 需要注意的是当菜品在售卖时,此菜品不允许删除。 当我们点击“批量删除”按钮时,浏览器发送的请求。 当我们点击“删除”按钮时,浏览器发送的请求。 基本上可以判断我们需要在后端使用 Restful 风格的代码编写响应功能,其中参数是 ids。 在 backend/page/food/list.html 中,我们发现“删除”按钮、“批量删除”按钮对应的前端代码。 "批量”操作中调用了 deleteHandle 方法。 “删除”操作中调用了 deleteHandle 方法。 接下来我们在 中找到该 deleteHandle 方法即可。 这里我们可以使用 Ctrl+B (idea快捷键)查看有关 checkList 的调用。 在 backend/page/food/list.html 中,我们发现 deleteHandle 方法调用了 deleteDish 方法。 使用 Ctrl+B (idea快捷键)可以快速定位到 deleteDish 方法的具体代码编写位置。 backend/api/food.js 在 private Integer isDeleted; 前添加 @TableLogic 注解,表示删除是逻辑删除。 该注解由 MyBatisPlus 提供。 com/itheima/reggie/entity/DishFlavor.java com/itheima/reggie/service/DishService.java com/itheima/reggie/service/impl/DishServiceImpl.java com/itheima/reggie/controller/DishController.java
1.4.文件上传代码实现
@PostMapping("/upload")
public R
1.5.文件下载代码实现
handleAvatarSuccess(response, file, fileList) {
this.imageUrl = '/common/download?name=${response.data}'
}
@GetMapping("/download")
public void download(String name, HttpServletResponse response) {
try {
//输入流,通过输入流读取文件内容
FileInputStream fileInputStream = new FileInputStream(new File(basePath + name));
//输出流,通过输出流将文件写回浏览器
ServletOutputStream outputStream = response.getOutputStream();
response.setContentType("image/jpeg");//设置回显的格式:图片文件
int len = 0;
byte[] bytes = new byte[1024];
while ((len = fileInputStream.read(bytes)) != -1) {
outputStream.write(bytes, 0, len);
outputStream.flush();
}
//关闭资源
outputStream.close();
fileInputStream.close();
} catch (Exception e) {
e.printStackTrace();
}
}
2.新增菜品
2.1.需求分析
2.2.数据模型
2.3.准备工作
package com.itheima.reggie.entity;
import com.baomidou.mybatisplus.annotation.FieldFill;
import com.baomidou.mybatisplus.annotation.TableField;
import lombok.Data;
import java.io.Serializable;
import java.time.LocalDateTime;
@Data
public class DishFlavor implements Serializable {
private static final long serialVersionUID = 1L;
private Long id;
//菜品 id
private Long dishId;
//口味名称
private String name;
//口味数据 list
private String value;
@TableField(fill = FieldFill.INSERT)
private LocalDateTime createTime;
@TableField(fill = FieldFill.INSERT_UPDATe)
private LocalDateTime updateTime;
@TableField(fill = FieldFill.INSERT)
private Long createUser;
@TableField(fill = FieldFill.INSERT_UPDATE)
private Long updateUser;
//是否删除
private Integer isDeleted;
}
package com.itheima.reggie.mapper;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.itheima.reggie.entity.DishFlavor;
import org.apache.ibatis.annotations.Mapper;
@Mapper
public interface DishFlavorMapper extends BaseMapper
package com.itheima.reggie.service;
import com.baomidou.mybatisplus.extension.service.IService;
import com.itheima.reggie.entity.DishFlavor;
public interface DishFlavorService extends IService
package com.itheima.reggie.service.impl;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.itheima.reggie.entity.DishFlavor;
import com.itheima.reggie.mapper.DishFlavorMapper;
import com.itheima.reggie.service.DishFlavorService;
import org.springframework.stereotype.Service;
@Service
public class DishFlavorServiceImpl extends ServiceImpl
package com.itheima.reggie.controller;
import com.itheima.reggie.service.CategoryService;
import com.itheima.reggie.service.DishFlavorService;
import com.itheima.reggie.service.DishService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
@RestController
@RequestMapping("/dish")
@Slf4j
public class DishController {
@Autowired
private DishService dishService;
@Autowired
private DishFlavorService dishFlavorService;
@Autowired
private CategoryService categoryService;
}
2.4.代码开发
2.4.1.梳理交互过程
2.4.2.查询分类数据
created() {
this.getDishList()
// 口味临时数据
this.getFlavorListHand()
this.id = requestUrlParam('id')
this.actionType = this.id ? 'edit' : 'add'
if (this.id) {
this.init()
}
},
// 获取菜品分类
getDishList () {
getCategoryList({ 'type': 1 }).then(res => {
if (res.code === 1) {
this.dishList = res.data
} else {
this.$message.error(res.msg || '操作失败')
}
})
},
// 获取菜品分类列表
const getCategoryList = (params) => {
return $axios({
url: '/category/list',
method: 'get',
params
})
}
@GetMapping("/list")
public R
> list(Category category) {
//条件构造器
LambdaQueryWrapper
2.4.3.接收页面提交的数据
package com.itheima.reggie.dto;
import com.itheima.reggie.entity.Dish;
import com.itheima.reggie.entity.DishFlavor;
import lombok.Data;
import java.util.ArrayList;
import java.util.List;
@Data
public class DishDto extends Dish {
private List
package com.itheima.reggie.service;
import com.baomidou.mybatisplus.extension.service.IService;
import com.itheima.reggie.dto.DishDto;
import com.itheima.reggie.entity.Dish;
public interface DishService extends IService
package com.itheima.reggie.service.impl;
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.itheima.reggie.dto.DishDto;
import com.itheima.reggie.entity.Dish;
import com.itheima.reggie.entity.DishFlavor;
import com.itheima.reggie.mapper.DishMapper;
import com.itheima.reggie.service.DishFlavorService;
import com.itheima.reggie.service.DishService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.BeanUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import java.util.List;
import java.util.stream.Collectors;
@Service
@Slf4j
public class DishServiceImpl extends ServiceImpl
@PostMapping
public R
3.菜品信息的分页查询
3.1.需求分析
3.2.代码开发
3.2.1.梳理交互过程
3.2.2.代码实现
@GetMapping("/page")
public R
4.修改菜品
4.1.需求分析
4.2.代码开发
4.2.1.梳理交互过程
4.2.2.代码实现
//根据 id 查询菜品信息和对应的口味信息
public DishDto getByIdWithFlavor(Long id);
//更新菜品信息,同时更新对应的口味信息
public void updateWithFlavor(DishDto dishDto);
public DishDto getByIdWithFlavor(Long id) {
//查询菜品基本信息,从 dish 表查询
Dish dish = this.getById(id);
DishDto dishDto = new DishDto();
BeanUtils.copyProperties(dish, dishDto);
//查询当前菜品对应的口味信息,从 dish_flavor 表查询
LambdaQueryWrapper
@Override
@Transactional//事务注解,保证事务的一致性
public void updateWithFlavor(DishDto dishDto) {
//更新 dish 表基本信息
this.updateById(dishDto);
//清理当前菜品对应口味数据---dish_flavor表的delete操作
LambdaQueryWrapper
@GetMapping("/{id}")
public R
@PutMapping
public R
SELECT id,type,name,sort,create_time,update_time,create_user,update_user FROM category WHERe (type = ?) ORDER BY sort ASC,update_time DESC;
SELECT id,name,category_id,price,code,image,description,status,sort,create_time,update_time,create_user,update_user FROM dish WHERe id=?
SELECt id,dish_id,name,value,create_time,update_time,create_user,update_user,is_deleted FROM dish_flavor WHERe (dish_id = ?)
UPDATe dish SET name=?, category_id=?, price=?, code=?, image=?, description=?, status=?, sort=?, create_time=?, update_time=?, create_user=?, update_user=? WHERe id=?
DELETE FROM dish_flavor WHERe (dish_id = ?)
INSERT INTO dish_flavor ( id, dish_id, name, value, create_time, update_time, create_user, update_user, is_deleted ) VALUES ( ?, ?, ?, ?, ?, ?, ?, ?, ? )
5.其他功能
5.1.需求分析
5.2.菜品管理业务前端初步分析
data() {
return {
input: '',
counts: 0,
page: 1,
pageSize: 10,
tableData : [],
dishState : '',
checkList: []
}
},
5.3.菜品启售/停售
5.3.1.需求分析
5.3.2.前端分析
点击“批量启售”按钮时,浏览器发送的请求消息。
//状态更改
statusHandle (row) {
let params = {}
if (typeof row === 'string' ) {
if (this.checkList.length === 0) {
this.$message.error('批量操作,请先勾选操作菜品!')
return false
}
params.id = this.checkList.join(',')
params.status = row
} else {
params.id = row.id
params.status = row.status ? '0' : '1'
}
this.dishState = params
this.$confirm('确认更改该菜品状态?', '提示', {
'confirmButtonText': '确定',
'cancelButtonText': '取消',
'type': 'warning'
}).then(() => {
// 起售停售---批量起售停售接口
dishStatusByStatus(this.dishState).then(res => {
if (res.code === 1) {
this.$message.success('菜品状态已经更改成功!')
this.handleQuery()
} else {
this.$message.error(res.msg || '操作失败')
}
}).catch(err => {
this.$message.error('请求出错了:' + err)
})
})
},
// 起售停售---批量起售停售接口
const dishStatusByStatus = (params) => {
return $axios({
url: `/dish/status/${params.status}`,
method: 'post',
params: { ids: params.id }
})
}
5.3.3.后端代码编写
//停售/启售单个菜品 或 批量停售/启售菜品
public void status(Integer status, List
@Transactional
public void status(Integer status, List
@PostMapping("/status/{status}")
public R
5.4.删除功能
5.4.1.需求分析
5.4.2.前端分析
// 删除
deleteHandle (type, id) {
if (type === '批量' && id === null) {
if (this.checkList.length === 0) {
return this.$message.error('请选择删除对象')
}
}
this.$confirm('确认删除该菜品, 是否继续?', '确定删除', {
'confirmButtonText': '确定',
'cancelButtonText': '取消',
}).then(() => {
deleteDish(type === '批量' ? this.checkList.join(',') : id).then(res => {
if (res.code === 1) {
this.$message.success('删除成功!')
this.handleQuery()
} else {
this.$message.error(res.msg || '操作失败')
}
}).catch(err => {
this.$message.error('请求出错了:' + err)
})
})
},
// 全部操作
handleSelectionChange (val){
let checkArr = []
val.forEach((n) => {
checkArr.push(n.id)
})
this.checkList = checkArr
},
// 删除接口
const deleteDish = (ids) => {
return $axios({
url: '/dish',
method: 'delete',
params: { ids }
})
}
5.4.3.后端代码编写
//是否删除
@TableLogic//逻辑删除
private Integer isDeleted;
//根据 id 删除单个菜品或批量删除菜品
public void deleteByIds(List
@Override
@Transactional
public void deleteByIds(List
@DeleteMapping
public R



