菜品管理业务开发
文件上传和下载
文件上传介绍
文件上传,也称为upload,是指将本地图片、视频、音频等文件上传到服务器上,可以供其他用户浏览或下载的过程。文件上传在项目中应用非常广泛,我们经常发微博、发微信朋友圈都用到了文件上传功能。
文件上传时,对页面的form表单有一下要求:
- method=“post” 采用post方式提交数据
- enctype=“multipart/form-data” 采用multipart格式上传文件
- type=“file” 使用input的file控件上传
目前一些前端组件库也提供了相应的上传组件,但是底层原理还是基于form表单的文件上传。例如ElementUI中提供的upload上传组件:
服务端要接收客户端页面上传的文件,通常都会使用Apache的两个组件:
- commons-fileupload
- commons-io
Spring框架在spring-web包中对文件上传进行了封装,大大简化了服务端代码,我们只需要在Controller的方法中声明一个MultipartFile类型的参数即可接收上传的文件。
文件下载介绍
文件下载,也称为download,是指将文件从服务器传输到本地计算机的过程。
通过浏览器进行文件下载,通常有两种表现形式:
- 以附件形式下载,弹出保存对话框,将文件保存到指定磁盘目录
- 直接在浏览器中打开
通过浏览器进行文件下载,本质上就是服务端将文件以流的形式写回浏览器的过程。
文件上传代码实现
文件上传,页面端可以使用ElementuI提供的上传组件。
可以直接使用资料中提供的上传页面,位置:资料/文件上传下载页面/upload.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>文件上传</title>
<!-- 引入样式 -->
<link rel="stylesheet" href="../../plugins/element-ui/index.css" />
<link rel="stylesheet" href="../../styles/common.css" />
<link rel="stylesheet" href="../../styles/page.css" />
</head>
<body>
<div class="addBrand-container" id="food-add-app">
<div class="container">
<el-upload class="avatar-uploader"
action="/common/upload"
:show-file-list="false"
:on-success="handleAvatarSuccess"
:before-upload="beforeUpload"
ref="upload">
<img v-if="imageUrl" :src="imageUrl" class="avatar"></img>
<i v-else class="el-icon-plus avatar-uploader-icon"></i>
</el-upload>
</div>
</div>
<!-- 开发环境版本,包含了有帮助的命令行警告 -->
<script src="../../plugins/vue/vue.js"></script>
<!-- 引入组件库 -->
<script src="../../plugins/element-ui/index.js"></script>
<!-- 引入axios -->
<script src="../../plugins/axios/axios.min.js"></script>
<script src="../../js/index.js"></script>
<script>
new Vue({
el: '#food-add-app',
data() {
return {
imageUrl: ''
}
},
methods: {
handleAvatarSuccess (response, file, fileList) {
this.imageUrl = `/common/download?name=${response.data}`
},
beforeUpload (file) {
if(file){
const suffix = file.name.split('.')[1]
const size = file.size / 1024 / 1024 < 2
if(['png','jpeg','jpg'].indexOf(suffix) < 0){
this.$message.error('上传图片只支持 png、jpeg、jpg 格式!')
this.$refs.upload.clearFiles()
return false
}
if(!size){
this.$message.error('上传文件大小不能超过 2MB!')
return false
}
return file
}
}
}
})
</script>
</body>
</html>
添加CommonController,负责文件上传与下载
@Slf4j
@RestController
@RequestMapping("/common")
public class CommonController {
//文件上传
@PostMapping("/upload")
public R<String> upload(MultipartFile file){
//file 是一个临时文件,需要转存到指定位置,否则请求完成后临时文件会删除
log.info("file:{}",file.toString());
return null;
}
}
MultipartFile定义的file变量必须与name保持一致
完整代码
@Value("${reggie.path}")
private String basePath;
/**
* 文件上传
* @param file
* @return
*/
@PostMapping("/upload")
public R<String> upload(MultipartFile file){
// file是一个临时文件,需要转存到指定的位置,否则本次请求完成后会自动删除
log.info("file:{}", file.toString());
// 原始文件名
String originalFilename = file.getOriginalFilename();
String suffix = originalFilename.substring(originalFilename.lastIndexOf("."));
// 使用UUID作为文件名,防止文件名重复造成文件覆盖
String fileName = UUID.randomUUID().toString() + suffix;
// 创建一个目录对象
File file1 = new File(basePath);
// 判断当前目录是否存在
if (!file1.exists()){
// 不存在则创建
file1.mkdirs();
}
try {
file.transferTo(new File(basePath + fileName));
} catch (IOException e) {
e.printStackTrace();
}
return R.success(fileName);
}
文件下载代码实现
文件下载,页面端可以使用标签展示下载图片
代码实现
/**
* 文件下载
* @param name
* @param response
*/
@GetMapping("/download")
public void down(String name, HttpServletResponse response){
try {
// 输入流,通过输入流读取文件内容
FileInputStream inputStream = new FileInputStream(new File(basePath + name));
// 输出流,通过输出流将文件协会浏览器,在浏览器展示图片
ServletOutputStream outputStream = response.getOutputStream();
response.setContentType("image/jpeg");
int len = 0;
byte[] buffer = new byte[1024];
while ((len = inputStream.read(buffer)) != -1){
outputStream.write(buffer, 0, len);
outputStream.flush();
}
outputStream.close();
inputStream.close();
} catch (FileNotFoundException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
}
新增菜品
需求分析
后台系统中可以管理菜品信息,通过新增功能来添加一个新的菜品,在添加菜品时需要选择当前菜品所属的菜品分类,并且需要上传菜品图片,在移动端会按照菜品分类来展示对应的菜品信息。
数据模型
新增菜品,其实就是将新增页面录入的菜品信息插入到dish表,如果添加了口味做法,还需要向dish_flavor表插入数据。所以在新增菜品时,涉及到两个表:
dish(菜品表)
dish_flavor(菜品口味表)
准备工作
在开发业务功能前,先将需要用到的类和接口基本结构创建好:
- 实体类DishFlavor(直接从课程资料中获取)
/**
菜品口味
*/
@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;
}
- Mapper接口DishFlavorMapper
- 业务层接口DishFlavorService
- 业务层实现类 DishFlavorServicelmpl
- 控制层 DishController
开发流程
在开发代码之前,需要梳理一下新增菜品时前端页面和服务端的交互过程:
- 页面(backend/page/food/add.html)发送ajax请求,请求服务端获取菜品分类数据并展示到下拉框中
- 页面发送请求进行图片上传,请求服务端将图片保存到服务器
- 页面发送请求进行图片下载,将上传的图片进行回显
- 点击保存按钮,发送ajax请求,将菜品相关数据以json形式提交到服务端
开发新增菜品功能,其实就是在服务端编写代码去处理前端页面发送的这4次请求即可。
**菜品分类下拉框:**在CategoryController中添加
/**
* 根据条件查询分类数据
* @param category
* @return
*/
@GetMapping("/list")
public R<List<Category>> list(Category category){
// 构造条件查询
QueryWrapper<Category> queryWrapper = new QueryWrapper<Category>();
queryWrapper.eq(category.getType() != null, "type", category.getType());
queryWrapper.orderByAsc("sort").orderByDesc("update_time");
List<Category> list = categoryService.list(queryWrapper);
return R.success(list);
}
导入DishDto(在资料中的dto目录下),用于封装页面提交的数据
@Data
public class DishDto extends Dish {
private List<DishFlavor> flavors = new ArrayList<>();
private String categoryName;
private Integer copies;
}
**注意:**DTO,全称为Data Transfer object,即数据传输对象,一般用于展示层与服务层之间的数据传输。
新增菜品同时插入菜品对应的口味数据,需要操作两张表:dish、dish_flavor
在DishService接口中添加方法saveWithFlavor,在DishServiceImpl实现
/**
* 新增菜品,同时保存口味
* @param dishDto
*/
@Override
@Transactional
public void insertWithFlavor(DishDto dishDto) {
// 保存菜品的信息到dish表
this.save(dishDto);
Long dtoId = dishDto.getId(); // 菜品ID
List<DishFlavor> flavors = dishDto.getFlavors();
Iterator iterator = flavors.iterator();
while (iterator.hasNext()){
DishFlavor dishFlavor = (DishFlavor) iterator.next();
dishFlavor.setDishId(dtoId);
}
// 保存菜品口味到dish_flavor表
dishFlavorService.saveBatch(flavors);
}
由于以上代码涉及多表操作,在启动类上开启事务支持添加**@EnbleTransactionMaagement**注解。
新增菜品
菜品信息分页查询
需求分析
系统中的菜品数据很多的时候,如果在一个页面中全部展示出来会显得比较乱,不便于查看,所以一般的系统中都会以分页的方式来展示列表数据。
梳理交互过程
在开发代码之前,需要梳理一下菜品分页查询时前端页面和服务端的交互过程:
- 页面(backend/page/food/list.html)发送ajax请求,将分页查询参数(page、pageSize、name)提交到服务端,获取分页数据
- 页面发送请求,请求服务端进行图片下载,用于页面图片展示开发菜品信息分页查询功能,其实就是在服务端编写代码去处理前端页面发送的这2次请求即可。
/**
* 菜品信息的分页
* @param page
* @param pageSize
* @param name
* @return
*/
@GetMapping("/page")
public R<Page> page(int page, int pageSize, String name){
Page<Dish> pageInfo = new Page<Dish>(page, pageSize);
QueryWrapper<Dish> queryWrapper = new QueryWrapper<Dish>();
queryWrapper.like(StringUtils.isNotBlank(name), "name", name);
queryWrapper.orderByDesc("update_time");
dishService.page(pageInfo, queryWrapper);
return R.success(pageInfo);
}
此时页面会有一个问题:如果直接这样去写,程序中给页面返回的CategoryID就只是一个普通的值,还没有转化成为对应的在数据库中的数据:
代码开发
/**
* 菜品信息的分页
* @param page
* @param pageSize
* @param name
* @return
*/
@GetMapping("/page")
public R<Page> page(int page, int pageSize, String name){
Page<Dish> pageInfo = new Page<Dish>(page, pageSize);
Page<DishDto> dishDtoPage = new Page<>();
QueryWrapper<Dish> queryWrapper = new QueryWrapper<Dish>();
queryWrapper.like(StringUtils.isNotBlank(name), "name", name);
queryWrapper.orderByDesc("update_time");
dishService.page(pageInfo, queryWrapper);
// 这个地方将pageInfo中的属性除了recodes外全部拷贝到dishDtoPage中
// 因为除了recodes中的属性(就是Page(Dish)和Page(DishDto))不同其他的page等都是一样的
BeanUtils.copyProperties(pageInfo, dishDtoPage, "records");
List<Dish> records = pageInfo.getRecords();
List<DishDto> dishDtoList = new ArrayList<>();
Iterator<Dish> dishIterator = records.iterator();
while (dishIterator.hasNext()){
Dish next = dishIterator.next();
DishDto dishDto = new DishDto();
// 遍历List集合,将每一个Dish转化成DishDto
// 因为DishDto时继承Dish所以可以直接拷贝,但是DishDto中有一个categoryName
// 这个时候就要从Dish中获取
BeanUtils.copyProperties(next, dishDto);
Long categoryId = next.getCategoryId();
Category category = categoryService.getById(categoryId);
if (category != null){
String categoryName = category.getName();
dishDto.setCategoryName(categoryName);
dishDtoList.add(dishDto);
}
}
dishDtoPage.setRecords(dishDtoList);
return R.success(dishDtoPage);
}
这个时候要使用多表联查,将categoryID与category表中的名字对应起来然后再输出。
修改菜品
需求分析
在菜品管理列表页面点击修改按钮,跳转到修改菜品页面,在修改页面回显菜品相关信息并进行修改,最后点击确定按钮完成修改操作
代码开发
梳理流程
在开发代码之前,需要梳理一下修改菜品时前端页面( add.html)和服务端的交互过程:
- 页面发送ajax请求,请求服务端获取分类数据,用于菜品分类下拉框中数据展示
- 页面发送ajax请求,请求服务端,根据id查询当前菜品信息,用于菜品信息回显
- 页面发送请求,请求服务端进行图片下载,用于页图片回显
- 点击保存按钮,页面发送ajax请求,将修改后的菜品相关数据以json形式提交到服务端
/**
* 更新菜品信息,同时更新口味信息
* @param dishDto
*/
@Override
@Transactional
public void updateWithFlavor(DishDto dishDto) {
// 更新dish表
this.updateById(dishDto);
// 清理菜品中所对应的口味信息--delete
QueryWrapper<DishFlavor> queryWrapper = new QueryWrapper<DishFlavor>();
queryWrapper.eq("dish_id", dishDto.getId());
dishFlavorService.remove(queryWrapper);
// 添加当前提交过来的信息--insert
List<DishFlavor> flavorList = dishDto.getFlavors();
Iterator<DishFlavor> iterator = flavorList.iterator();
while (iterator.hasNext()){
DishFlavor dishFlavor = iterator.next();
dishFlavor.setDishId(dishDto.getId());
}
dishFlavorService.saveBatch(flavorList);
}
开发修改菜品功能,其实就是在服务端编写代码去处理前端页面发送的这4次请求即可。
停售/起售菜品,删除菜品
需求分析
在商品买卖过程中,商品停售,起售可以更加方便的让用户知道店家还有什么类型的商品在卖。删除方法也更方便的管理菜品
代码实现
停售/起售菜品
/**
* 批量停售和起售
* @param status
* @param ids
* @return
*/
@PostMapping("/status/{status}")
public R<String> saleList(@PathVariable("status") int status, String[] ids){
log.info("status:{}, ids:{}", status, ids);
for (String id : ids){
Dish dish = dishService.getById(id);
dish.setStatus(status);
dishService.updateById(dish);
}
return R.success("修改成功");
}
删除菜品
/**
* 批量删除
* @param ids
* @return
*/
@DeleteMapping
public R<String> deleteList(String[] ids){
log.info("ids:{}", ids);
for (String id : ids){
dishService.removeById(id);
}
return R.success("删除成功");
}