一、文件上传下载
1.1 文件上传介绍
文件上传,也称为upload,是指将本地图片、视频、音频等文件上传到服务器上,可以供其他用户浏览或下载的过程。文件上传在项目中应用非常广泛,我们经常发微博、发微信朋友圈都用到了文件上传功能。
文件上传时,对页面的form表单有如下要求:
表单属性 | 取值 | 说明 |
---|---|---|
method | post | 必须选择post方式提交 |
enctype | multipart/form-data | 采用multipart格式上传文件 |
type | file | 使用input的file控件上传 |
1. 前端介绍
1). 简单html页面表单
1 | <form method="post" action="/common/upload" enctype="multipart/form-data"> |
2). ElementUI中提供的upload上传组件
目前一些前端组件库也提供了相应的上传组件,但是底层原理还是基于form表单的文件上传。
2.服务端介绍
服务端要接收客户端页面上传的文件,通常都会使用Apache的两个组件:
commons-fileupload
commons-io
而Spring框架在spring-web包中对文件上传进行了封装,大大简化了服务端代码,我们只需要在Controller的方法中声明一个MultipartFile类型的参数即可接收上传的文件,例如:
1 | /** |
1.2 文件下载介绍
文件下载,也称为download,是指将文件从服务器传输到本地计算机的过程。通过浏览器进行文件下载,通常有两种表现形式:
1). 以附件形式下载,弹出保存对话框,将文件保存到指定磁盘目录
2). 直接在浏览器中打开
而今天所需要实现的菜品展示,表现形式为在浏览器中直接打开。
通过浏览器进行文件下载,本质上就是服务端将文件以流的形式写回浏览器的过程。
1.3 文件上传代码实现
1.导入文件上传页面
1 | <!DOCTYPE html> |
2.配置文件存储路径
需要在application.yml中定义文件存储路径
1 | reggie: |
2.添加Controller
编写文件上传的方法, 通过MultipartFile类型的参数即可接收上传的文件, 方法形参的名称需要与页面的file域的name属性一致。
所在包: com.itheima.reggie.controller
上传逻辑:
1). 获取文件的原始文件名, 通过原始文件名获取文件后缀
2). 通过UUID重新声明文件名, 文件名称重复造成文件覆盖
3). 创建文件存放目录
4). 将上传的临时文件转存到指定位置
1 | /** |
3.在过滤器中进行路径放行
4.测试
成功实现文件上传。
1.4 文件下载代码实现
1.前端代码
文件下载,前端页面可以使用标签展示下载的图片。
1 | <img v-if="imageUrl" :src="imageUrl" class="avatar"></img> |
那么,通过标签如何展示图片数据呢,接下来我们来解析一下具体的流程:
在文件上传成功后,在 handleAvatarSuccess 方法中获取文件上传成功之后返回的数据(文件名),然后调用 /common/download?name=xxx 进行文件的下载。在这里,我们想让上传的照片能够在页面展示出来,所以我们就需要在服务端将文件以流的形式写回浏览器。
2.后端代码
在 CommonController 中定义方法download,并接收页面传递的参数name,然后读取图片文件的数据,然后以流的形式写回浏览器。
具体逻辑如下:
1). 定义输入流,通过输入流读取文件内容
2). 通过response对象,获取到输出流
3). 通过response对象设置响应数据格式(image/jpeg)
4). 通过输入流读取文件数据,然后通过上述的输出流写回浏览器
5). 关闭资源
代码:
1 | //文件下载 |
3.测试
图片正常展示
二、新增菜品
2.1 需求分析
后台系统中可以管理菜品信息,通过 新增功能来添加一个新的菜品,在添加菜品时需要选择当前菜品所属的菜品分类,并且需要上传菜品图片,在移动端会按照菜品分类来展示对应的菜品信息 。
2.2 数据模型
新增菜品,其实就是将新增页面录入的菜品信息插入到dish表,如果添加了口味做法,还需要向dish_flavor表插入数据。所以在新增菜品时,涉及到两个表:
表结构 | 说明 |
---|---|
dish | 菜品表 |
dish_flavor | 菜品口味表 |
- 菜品表:dish
- 菜品口味表:dish_flavor
2.3 准备工作
在开发业务功能前,先将需要用到的类和接口基本结构创建好:
1、实体类 DishFlavor
1 | package com.itheima.reggie.entity; |
2、Mapper接口DishFlavorMapper
1 | /** |
3、业务层接口 DishFlavorService
1 | /** |
4、业务层实现类 DishFlavorServiceImpl
1 | /** |
5、 控制层 DishController
菜品及菜品口味的相关操作,统一使用这一个controller。
1 | /** |
2.4 前端页面分析
在开发代码之前,需要梳理一下新增菜品时前端页面和服务端的交互过程。
点击新建菜品按钮, 访问页面(backend/page/food/add.html), 页面加载时发送ajax请求,请求服务端获取菜品分类数据并展示到下拉框中
页面发送请求进行图片上传,请求服务端将图片保存到服务器(上传功能已实现)
页面发送请求进行图片下载,将上传的图片进行回显(下载功能已实现)
点击保存按钮,发送ajax请求,将菜品相关数据以json形式提交到服务端
开发新增菜品功能,其实就是在服务端编写代码去处理前端页面发送的这4次请求(上传、下载已实现)即可。经过上述的分析,我们还需要在服务端实现两块功能:
A. 菜品分类数据列表查询, 具体请求信息整理如下 :
请求 | 说明 |
---|---|
请求方式 | GET |
请求路径 | /category/list |
请求参数 | ?type=1 |
B. 保存菜品信息, 具体请求信息整理如下 :
请求 | 说明 |
---|---|
请求方式 | POST |
请求路径 | /dish |
请求参数 | json格式 |
2.5 代码实现
1.菜品分类查询
在CategoryController中增加方法实现菜品分类查询,根据分类进行查询,并对查询的结果按照sort排序字段进行升序排序,如果sort相同,再按照修改时间倒序排序。
1 | /** |
测试:
可以正常显示。
2.保存菜品信息
在上述的分析中,我们可以看到在保存菜品时,页面传递过来的是json格式数据,格式如下:
1 | { |
在服务端应该如何来封装前端传递的数据呢,我们发现,如果使用菜品类Dish来封装,只能封装菜品的基本属性,flavors属性是无法封装的。那么这个时候,我们应该如何处理呢?
这个时候,我们需要自定义一个实体类,然后继承自 Dish,并对Dish的属性进行拓展,增加 flavors 集合属性(内部封装DishFlavor)。
1). 导入 DishDto 实体类
封装页面传递的请求参数。
所属包: com.itheima.reggie.dto
1 | import com.itheima.reggie.entity.Dish; |
拓展: 我们在做项目时,经常会涉及到各种类型的实体模型。基本包含以下几种
实体模型 | 描述 |
---|---|
DTO | Data Transfer Object(数据传输对象),一般用于展示层与服务层之间的数据传输。 |
Entity | 最常用实体类,基本和数据表一一对应,一个实体类对应一张表。 |
VO | Value Object(值对象), 主要用于封装前端页面展示的数据对象,用一个VO对象来封装整个页面展示所需要的对象数据 |
PO | Persistant Object(持久层对象), 是ORM(Objevt Relational Mapping)框架中Entity,PO属性和数据库中表的字段形成一一对应关系 |
2). DishController定义方法新增菜品
在该Controller的方法中,不仅需要保存菜品的基本信息,还需要保存菜品的口味信息,需要操作两张表,所以我们需要在DishService接口中定义接口方法,在这个方法中需要保存上述的两部分数据。
1 | /** |
3). DishService中增加方法saveWithFlavor
1 | //新增菜品,同时插入菜品对应的口味数据,需要操作两张表:dish、dish_flavor |
4). DishServiceImpl中实现方法saveWithFlavor
页面传递的菜品口味信息,仅仅包含name 和 value属性,缺少一个非常重要的属性dishId, 所以在保存完菜品的基本信息后,我们需要获取到菜品ID,然后为菜品口味对象属性dishId赋值。
具体逻辑如下:
①. 保存菜品基本信息 ;
②. 获取保存的菜品ID ;
③. 获取菜品口味列表,遍历列表,为菜品口味对象属性dishId赋值;
④. 批量保存菜品口味列表;
代码实现如下:
1 |
|
说明:
由于在 saveWithFlavor 方法中,进行了两次数据库的保存操作,操作了两张表,那么为了保证数据的一致性,我们需要在方法上加上注解 @Transactional来控制事务。
5). 在引导类上加注解 @EnableTransactionManagement
Service层方法上加的注解@Transactional要想生效,需要在引导类上加上注解 @EnableTransactionManagement, 开启对事务的支持。
1 |
|
2.6 功能测试
菜品表添加成功
口味表添加成功
三、菜品分页查询
3.1 需求分析
系统中的菜品数据很多的时候,如果在一个页面中全部展示出来会显得比较乱,不便于查看,所以一般的系统中都会以分页的方式来展示列表数据。
在菜品列表展示时,除了菜品的基本信息(名称、售价、售卖状态、更新时间)外,还有两个字段略微特殊,第一个是图片字段 ,我们从数据库查询出来的仅仅是图片的名字,图片要想在表格中回显展示出来,就需要下载这个图片。第二个是菜品分类,这里展示的是分类名称,而不是分类ID,此时我们就需要根据菜品的分类ID,去分类表中查询分类信息,然后在页面展示。
3.2 前端页面分析
前端页面和服务端的交互过程:
访问页面(backend/page/food/list.html)时,发送ajax请求,将分页查询参数(page、pageSize、name)提交到服务端,获取分页数据
页面发送请求,请求服务端进行图片下载,用于页面图片展示
开发菜品信息分页查询功能,其实就是在服务端编写代码去处理前端页面发送的这2次请求即可,而前端发起的请求中, 图片文件下载回显的代码,我们已经实现了。所以,我们只需要开发分页查询的功能即可,分页查询具体的请求信息如下:
请求 | 说明 |
---|---|
请求方式 | GET |
请求路径 | /dish/page |
请求参数 | ?page=1&pageSize=10&name=xxx |
3.3 代码实现
1.分析
在分页查询时需要给页面返回分类的名称,而分类的名称前端在接收的时候是通过 categoryName 属性获取的,那么对应的服务端也应该封装到 categoryName 属性中。
1 | <el-table-column prop="categoryName" label="菜品分类"></el-table-column> |
而在我们的实体类 Dish 中,仅仅包含 categoryId, 不包含 categoryNam所以要返回DishDto对象,在该对象中可以拓展一个属性 categoryName,来封装菜品分类名称。
1 |
|
具体逻辑为:
构造分页条件对象
构建查询及排序条件
执行分页条件查询
遍历分页查询列表数据,根据分类ID查询分类信息,从而获取该菜品的分类名称
封装数据并返回
2.代码编写
1 |
|
3.3 功能测试
菜品信息分类正常且菜品分类正常显示
四、修改菜品基本信息
4.1 需求分析
在菜品管理列表页面点击修改按钮,跳转到修改菜品页面,在修改页面回显菜品相关信息并进行修改,最后点击确定按钮完成修改操作。
4.2 前端页面分析
前端页面(add.html)和服务端的交互过程:
点击菜品列表的中的修改按钮,携带菜品id跳转至add.html
进入add.html,页面发送ajax请求,请求服务端获取分类数据,用于菜品分类下拉框中数据展示(已实现)
add.html获取id, 发送ajax请求,请求服务端,根据id查询当前菜品信息,用于菜品信息回显
页面发送请求,请求服务端进行图片下载,用于页图片回显(已实现)
点击保存按钮,页面发送ajax请求,将修改后的菜品相关数据以json形式提交到服务端
经过上述的分析,我们发现,菜品分类下拉框的展示、图片的下载回显功能我们都已经实现了。我们只需要在这里实现两个功能即可,分别是:
1. 根据ID查询菜品及菜品口味信息
具体请求信息如下:
请求 | 说明 |
---|---|
请求方式 | GET |
请求路径 | /dish/{id} |
2. 修改菜品及菜品口味信息
具体请求信息如下:
请求 | 说明 |
---|---|
请求方式 | PUT |
请求路径 | /dish |
请求参数 | json格式数据 |
具体的json格式数据,我们可以通过浏览器抓取:
1 | { |
4.3 功能实现
1.根据ID查询菜品信息
代码实现
页面发送ajax请求,请求服务端,根据id查询当前菜品信息和对应的口味信息,用于修改页面中菜品信息回显。
- 在DishService接口中扩展getByIdWithFlavor方法
1 | //根据id查询菜品信息和对应的口味信息 |
- 在DishService实现类中实现此方法
- 根据ID查询菜品的基本信息
- 根据菜品的ID查询菜品口味列表数据
- 组装数据并返回
代码实现:
1 | /** |
3). 在DishController中创建get方法
1 | /** |
@PathVariable : 该注解可以用来提取url路径中传递的请求参数。
测试
数据成功回显
2.修改菜品信息
1.代码实现
点击保存按钮,页面发送ajax请求,将修改后的菜品相关数据以json形式提交到服务端。在修改菜品信息时需要注意,除了要更新dish菜品表,还需要更新dish_flavor菜品口味表。
- 在DishService接口中扩展方法updateWithFlavor
1 | //更新菜品信息,同时更新对应的口味信息 |
- 在DishServiceImpl中实现方法updateWithFlavor
在该方法中,既需要更新dish菜品基本信息表,还需要更新dish_flavor菜品口味表。
而页面再操作时,关于菜品的口味,有修改,有新增,也有可能删除,name应该如何更新菜品口味信息呢?
其实,无论菜品口味信息如何变化,我们只需要保持一个原则: 先删除,后添加。
1 |
|
3). 在DishController中创建update方法
1 | /** |
4.3.2.2 功能测试
这是原来的菜品信息
修改为
页面修改操作成功
菜品表更新成功
口味表更新成功