Java

发布日期: 2022-04-27

更新日期: 2022-05-17

文章字数: 4.9k

阅读时长: 19 分

新增分类

后台系统中可以管理分类信息，分类包括两种类型，分别是 菜品分类 和 套餐分类 。当我们在后台系统中添加菜品时需要选择一个菜品分类，当我们在后台系统中添加一个套餐时需要选择一个套餐分类，在移动端也会按照菜品分类和套餐分类来展示对应的菜品和套餐。

在分类管理中,我们新增分类时, 可以选择新增菜品分类(川菜、湘菜、粤菜…), 也可以选择新增套餐分类(营养早餐、超值午餐…)。在添加套餐的时候, 输入的排序字段, 控制的是移动端套餐列表的展示顺序。

数据模型

新增分类，其实就是将我们新增窗口录入的分类数据,插入到category表，具体表结构如下：

我们添加的套餐名称，是唯一的，不能够重复的，所以在设计表结构时，已经针对于name字段建立了唯一索引，如下：

前端页面分析

在开发代码之前，需要梳理一下整个程序的执行过程：

在页面(backend/page/category/list.html)的新增分类表单中填写数据，点击 “确定” 发送ajax请求，将新增分类窗口输入的数据以json形式提交到服务端
服务端Controller接收页面提交的数据并调用Service将数据进行保存
Service调用Mapper操作数据库，保存数据

具体请求样例信息整理如下:

请求	说明
请求方式	POST
请求路径	/category
请求参数	json格式 - {“name”:”川菜”,”type”:”1”,”sort”:2}

代码实现

代码实现的具体步骤如下:

实体类Category（直接从课程资料中导入即可）
Mapper接口CategoryMapper
业务层接口CategoryService
业务层实现类CategoryServiceImpl
控制层CategoryController

实体类Category

/**
 * 分类
 */
@Data
public class Category implements Serializable {

    private static final long serialVersionUID = 1L;

    private Long id;

    //类型 1 菜品分类 2 套餐分类
    private Integer type;

    //分类名称
    private String name;

    //顺序
    private Integer sort;

    //创建时间
    @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;
}

Mapper接口CategoryMapper

所属包: mapper

@Mapper
public interface CategoryMapper extends BaseMapper<Category> {
}

业务层接口CategoryService

所属包: service

public interface CategoryService extends IService<Category> {
}

业务层实现类CategoryServiceImpl

所属包: service.impl

@Service
public class CategoryServiceImpl extends ServiceImpl<CategoryMapper,Category> implements CategoryService{
}

控制层CategoryController

/**
 * 分类管理
 */
@RestController
@RequestMapping("/category")
@Slf4j
public class CategoryController {
    @Autowired
    private CategoryService categoryService;
	
    /**
     * 新增分类
     * @param category
     * @return
     */
    @PostMapping
    public Res<String> save(@RequestBody Category category){
        log.info("category:{}",category);
        categoryService.save(category);
        return Res.success("新增分类成功");
    }
}

分类信息分页查询

系统中的分类很多的时候，如果在一个页面中全部展示出来会显得比较乱，不便于查看，所以一般的系统中都会以分页的方式来展示列表数据。

前端页面分析

在开发代码之前，需要梳理一下整个程序的执行过程：

页面发送ajax请求，将分页查询参数(page、pageSize)提交到服务端
服务端Controller接收页面提交的数据并调用Service查询数据
Service调用Mapper操作数据库，查询分页数据
Controller将查询到的分页数据响应给页面
页面接收到分页数据并通过ElementUI的Table组件展示到页面上

页面加载时,就会触发Vue声明周期的钩子方法,然后执行分页查询,发送异步请求到服务端。页面中使用的是ElementUI提供的分页组件进行分页条的展示

具体的请求信息整理如下:

请求	说明
请求方式	GET
请求路径	/category/page
请求参数	?page=1&pageSize=10

代码实现

在CategoryController中增加分页查询的方法，在方法中传递分页条件进行查询，并且需要对查询到的结果，安排设置的套餐顺序字段sort进行排序。

  /**
     *分页查询
     */
@GetMapping("/page")
public Res<Page> page(int page,int pageSize){
    Page<Category> pageInfo = new Page<>(page,pageSize);
    //条件构造器
    LambdaQueryWrapper<Category> queryWrapper = new LambdaQueryWrapper<>();
    //添加排序条件，根据sort进行排序
    queryWrapper.orderByAsc(Category::getSor
    //分页查询
    categoryServiceimpl.page(pageInfo,queryWrapper);
    return Res.success(pageInfo);
}

删除分类

在分类管理列表页面，可以对某个分类进行删除操作。需要注意的是当分类关联了菜品或者套餐时，此分类不允许删除。

前端页面分析

在前端页面中，点击 “删除” 按钮，就会触发定义的方法，然后往服务端发送异步请求，并传递参数id，执行删除分类操作。

删除操作的具体执行流程如下：

点击删除，页面发送ajax请求，将参数(id)提交到服务端
服务端Controller接收页面提交的数据并调用Service删除数据
Service调用Mapper操作数据库

从上述的分析中，我们可以得到请求的信息如下：

请求	说明
请求方式	DELETE
请求路径	/category
请求参数	?id=1395291114922618881

代码实现

在CategoryController中增加根据ID删除的方法，在方法中接收页面传递参数id，然后执行删除操作。

  /**
     * 根据id删除分类
     * @param id
     * @return
     */
@DeleteMapping
public Res<String> delete(Long id){
    log.info("删除分类，id为：{}",i
    //categoryService.removeById(id);
    categoryServiceimpl.remove(i
    return Res.success("分类信息删除成功");
}

功能完善

在上述的测试中，我们看到分类数据是可以正常删除的。但是并没有检查删除的分类是否关联了菜品或者套餐，所以我们需要进行功能完善。完善后的逻辑为：

根据当前分类的ID，查询该分类下是否存在菜品，如果存在，则提示错误信息
根据当前分类的ID，查询该分类下是否存在套餐，如果存在，则提示错误信息
执行正常的删除分类操作

准备菜品(Dish)及套餐(Setmeal)实体类

/**
 菜品
 */
@Data
public class Dish implements Serializable {
    private static final long serialVersionUID = 1L;

    private Long id;

    //菜品名称
    private String name;

    //菜品分类id
    private Long categoryId;

    //菜品价格
    private BigDecimal price;

    //商品码
    private String code;

    //图片
    private String image;

    //描述信息
    private String description;

    //0 停售 1 起售
    private Integer status;

    //顺序
    private Integer sort;

    @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;
}

/**
 * 套餐
 */
@Data
public class Setmeal implements Serializable {
    private static final long serialVersionUID = 1L;

    private Long id;

    //分类id
    private Long categoryId;

    //套餐名称
    private String name;

    //套餐价格
    private BigDecimal price;

    //状态 0:停用 1:启用
    private Integer status;

    //编码
    private String code;

    //描述信息
    private String description;

    //图片
    private String image;

    @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;
}

Mapper接口DishMapper和SetmealMapper

Service接口DishService和SetmealService

Service实现类DishServiceImpl和SetmealServiceImpl

就不加以赘述

代码实现

在业务逻辑操作过程中,如果遇到一些业务参数、操作异常的情况下，我们直接抛出此异常。

所在包：common

/**
 * 自定义业务异常类
 */
public class CustomException extends RuntimeException {
    public CustomException(String message){
        super(message);
    }
}

在CategoryService中扩展remove方法

public interface CategoryService extends IService<Category> {
	//根据ID删除分类
    public void remove(Long id);
}

在CategoryServiceImpl中实现remove方法

@Autowired
private DishService dishService;
@Autowired
private SetmealService setmealService;

/**
 * 根据id删除分类，删除之前需要进行判断
 * @param id
 */
@Override
public void remove(Long id) {
    //添加查询条件，根据分类id进行查询菜品数据
    LambdaQueryWrapper<Dish> dishLambdaQueryWrapper = new LambdaQueryWrapper<>();
    dishLambdaQueryWrapper.eq(Dish::getCategoryId,id);
    int count1 = dishService.count(dishLambdaQueryWrapper);
    //如果已经关联，抛出一个业务异常
    if(count1 > 0){
        throw new CustomException("当前分类下关联了菜品，不能删除");//已经关联菜品，抛出一个业务异常
    }

    //查询当前分类是否关联了套餐，如果已经关联，抛出一个业务异常
    LambdaQueryWrapper<Setmeal> setmealLambdaQueryWrapper = new LambdaQueryWrapper<>();
    setmealLambdaQueryWrapper.eq(Setmeal::getCategoryId,id);
    int count2 = setmealService.count(setmealLambdaQueryWrapper);
    if(count2 > 0){
        throw new CustomException("当前分类下关联了套餐，不能删除");//已经关联套餐，抛出一个业务异常
    }

    //正常删除分类
    super.removeById(id);
}

那么在上述的业务逻辑中，当分类下关联的有菜品或者套餐时，我们在业务代码中抛出了自定义异常，并且在异常中封装了错误提示信息，那这个错误提示信息如何提示给页面呢？

异常抛出之后，会被异常处理器捕获，我们只需要在异常处理器中捕获这一类的异常，然后给页面返回对应的提示信息即可。

在GlobalExceptionHandler中处理自定义异常

在全局异常处理器中增加方法，用于捕获我们自定义的异常 CustomException

/**
 * 异常处理方法
 * @return
 */
@ExceptionHandler(CustomException.class)
public Res<String> exceptionHandler(CustomException ex){
    log.error(ex.getMessage());
    return Res.error(ex.getMessage());
}

改造CategoryController的delete方法

注释掉原有的代码，在delete方法中直接调用categoryService中我们自定义的remove方法。

/**
* 根据id删除分类
* @param id
* @return
*/
@DeleteMapping
public Res<String> delete(Long id){
    log.info("删除分类，id为：{}",id);

    //categoryService.removeById(id);
    categoryService.remove(id);

    return Res.success("分类信息删除成功");
}

文件上传下载

文件上传，也称为upload，是指将本地图片、视频、音频等文件上传到服务器上，可以供其他用户浏览或下载的过程。文件上传在项目中应用非常广泛，我们经常发微博、发微信朋友圈都用到了文件上传功能。

文件上传时，对页面的form表单有如下要求：

表单属性	取值	说明
method	post	必须选择post方式提交
enctype	multipart/form-data	采用multipart格式上传文件
type	file	使用input的file控件上传

简单html页面表单

<form method="post" action="/common/upload" enctype="multipart/form-data">
    <input name="myFile" type="file"  />
    <input type="submit" value="提交" /> 
</form>

ElementUI中提供的upload上传组件

目前一些前端组件库也提供了相应的上传组件，但是底层原理还是基于form表单的文件上传。

服务端

服务端要接收客户端页面上传的文件，通常都会使用Apache的两个组件：

commons-fileupload
commons-io

而Spring框架在spring-web包中对文件上传进行了封装，大大简化了服务端代码，我们只需要在Controller的方法中声明一个MultipartFile类型的参数即可接收上传的文件。通过浏览器进行文件下载，展示到页面上。

上传代码实现

前端介绍

对于前端页面，可以使用ElementUI提供的上传组件。可以直接使用资料中提供的上传页面，位置：资料/文件上传下载页面/upload.html

在上述的浏览器抓取的网络请求中，上传文件的调用url，在哪里配置的呢，这个时候，我们需要去看一下前端上传组件。

虽然上述是ElementUI封装的代码，但是实际上最终还通过file域上传文件，如果未指定上传文件的参数名，默认为file。

服务端实现

1). application.yml

需要在application.yml中定义文件存储路径

reggie:
  path: D:\img\

2). CommonController

编写文件上传的方法, 通过MultipartFile类型的参数即可接收上传的文件, 方法形参的名称需要与页面的file域的name属性一致。

所在包: controller

上传逻辑:

1). 获取文件的原始文件名, 通过原始文件名获取文件后缀

2). 通过UUID重新声明文件名, 文件名称重复造成文件覆盖

3). 创建文件存放目录

4). 将上传的临时文件转存到指定位置

代码实现:

@Value("${takeaway.path}")
private String basePa
@PostMapping("/upload")
public Res<String> upload(MultipartFile file){
    //file是一个临时文件，需要转存到指定位置，否则本次请求完成后临时文件会删除
    log.info(file.toString(
    //原始文件名
 	String originalFilename = file.getOriginalFilename();//abc.jpg
 	String suffix = originalFilename.substring(originalFilename.lastIndexOf(".")	
 	    //使用UUID重新生成文件名，防止文件名称重复造成文件覆盖
 	    String fileName = UUID.randomUUID().toString() + suffix;//dfsdfdfd.j	
 	    //创建一个目录对象
 	    File dir = new File(basePath);
 	    //判断当前目录是否存在
 	    if(!dir.exists()){
 	        //目录不存在，需要创建
 	        dir.mkdirs();
 	   	
 	    try {
 	        //将临时文件转存到指定位置
 	        file.transferTo(new File(basePath + fileName));
 	    } catch (IOException e) {
 	        e.printStackTrace();
 	    }
 	    return Res.success(fileName);
 	}

下载代码实现

文件下载，前端页面可以使用标签展示下载的图片。

<img v-if="imageUrl" :src="imageUrl" class="avatar"></img>

那么，通过<img>标签如何展示图片数据呢，接下来我们来解析一下具体的流程：

在文件上传成功后，在 handleAvatarSuccess 方法中获取文件上传成功之后返回的数据(文件名)，然后调用 /common/download?name=xxx 进行文件的下载。在这里，我们想让上传的照片能够在页面展示出来，所以我们就需要在服务端将文件以流的形式写回浏览器。

服务端代码

在 CommonController 中定义方法download，并接收页面传递的参数name，然后读取图片文件的数据，然后以流的形式写回浏览器。

具体逻辑如下：

1). 定义输入流，通过输入流读取文件内容

2). 通过response对象，获取到输出流

3). 通过response对象设置响应数据格式(image/jpeg)

4). 通过输入流读取文件数据，然后通过上述的输出流写回浏览器

5). 关闭资源

@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();
       }
   }

菜品新增

后台系统中可以管理菜品信息，通过新增功能来添加一个新的菜品，在添加菜品时需要选择当前菜品所属的菜品分类，并且需要上传菜品图片，在移动端会按照菜品分类来展示对应的菜品信息。

新增菜品，其实就是将新增页面录入的菜品信息插入到dish表，如果添加了口味做法，还需要向dish_flavor表插入数据。所以在新增菜品时，涉及到两个表：

表结构	说明
dish	菜品表
dish_flavor	菜品口味表

在开发业务功能前，先将需要用到的类和接口基本结构创建好：

有实体类 DishFlavor，Mapper接口DishFlavorMapper，业务层接口 DishFlavorService，业务层实现类 DishFlavorServiceImpl，控制层 DishController。

前端页面分析

基本的准备工作我们已经做完了，那么接下来我们就需要来实现新增菜品功能，在开发代码之前，需要梳理一下新增菜品时前端页面和服务端的交互过程。

点击新建菜品按钮, 访问页面(backend/page/food/add.html), 页面加载时发送ajax请求，请求服务端获取菜品分类数据并展示到下拉框中
页面发送请求进行图片上传，请求服务端将图片保存到服务器(上传功能已实现)
页面发送请求进行图片下载，将上传的图片进行回显(下载功能已实现)
点击保存按钮，发送ajax请求，将菜品相关数据以json形式提交到服务端

开发新增菜品功能，其实就是在服务端编写代码去处理前端页面发送的这4次请求(上传、下载已实现)即可。经过上述的分析，我们还需要在服务端实现两块功能：

菜品分类数据列表查询, 具体请求信息整理如下 :

请求	说明
请求方式	GET
请求路径	/category/list
请求参数	?type=1

保存菜品信息, 具体请求信息整理如下 :

请求	说明
请求方式	POST
请求路径	/dish
请求参数	json格式

下面呢,我们就需要根据这里分析的结果,分别来实现菜品分类列表的展示功能、保存菜品的功能。

代码实现

菜品分类查询

在CategoryController中增加方法实现菜品分类查询，根据分类进行查询，并对查询的结果按照sort排序字段进行升序排序，如果sort相同，再按照修改时间倒序排序。

/**
* 根据条件查询分类数据
* @param category
* @return
*/
@GetMapping("/list")
  public Res<List<Category>> list(Category category){
      //条件构造器
      LambdaQueryWrapper<Category> queryWrapper = new LambdaQueryWrapper<>();
      //添加条件
      queryWrapper.eq(category.getType() != null,Category::getType,category.getType());
        //添加排序条件
        queryWrapper.orderByAsc(Category::getSort).orderByDesc(Category::getUpdateTime);

        List<Category> list = categoryServiceimpl.list(queryWrapper);
        return Res.success(list);
    }

保存菜品信息

在上述的分析中，我们可以看到在保存菜品时，页面传递过来的是json格式数据

在服务端我们应该如何来封装前端传递的数据呢，我们发现，如果使用菜品类Dish来封装，只能封装菜品的基本属性，flavors属性是无法封装的。那么这个时候，我们应该如何处理呢?

这个时候，我们需要自定义一个实体类，然后继承自 Dish，并对Dish的属性进行拓展，增加 flavors 集合属性(内部封装DishFlavor)。清楚了这一点之后,接下来就进行功能开发。

导入 DishDto 实体类

封装页面传递的请求参数。

所属包: dto

@Data
public class DishDto extends Dish {
    private List<DishFlavor> flavors = new ArrayList<>();
	
    private String categoryName;
	
    private Integer copies;
}

DishController定义方法新增菜品

在该Controller的方法中，不仅需要保存菜品的基本信息，还需要保存菜品的口味信息，需要操作两张表，所以我们需要在DishService接口中定义接口方法，在这个方法中需要保存上述的两部分数据。

/**
 * 新增菜品
 * @param dishDto
 * @return
 */
@PostMapping
public Res<String> save(@RequestBody DishDto dishDto){
    log.info(dishDto.toString(
    dishService.saveWithFlavor(dishDt
    return Res.success("新增菜品成功");
}

DishService中增加方法saveWithFlavor

//新增菜品，同时插入菜品对应的口味数据，需要操作两张表：dish、dish_flavor
public void saveWithFlavor(DishDto dishDto);

DishServiceImpl中实现方法saveWithFlavor

页面传递的菜品口味信息，仅仅包含name 和 value属性，缺少一个非常重要的属性dishId，所以在保存完菜品的基本信息后，我们需要获取到菜品ID，然后为菜品口味对象属性dishId赋值。

具体逻辑如下：

①. 保存菜品基本信息 ;

②. 获取保存的菜品ID ;

③. 获取菜品口味列表，遍历列表，为菜品口味对象属性dishId赋值;

④. 批量保存菜品口味列表;

@Autowired
private DishFlavorService dishFlavorService;
/**
* 新增菜品，同时保存对应的口味数据
* @param dishDto
*/
@Transactional
public void saveWithFlavor(DishDto dishDto) {
    //保存菜品的基本信息到菜品表dish
    this.save(dishDto);
	
    Long dishId = dishDto.getId();//菜品id
    //菜品口味
    List<DishFlavor> flavors = dishDto.getFlavors();
    flavors = flavors.stream().map((item) -> {
        item.setDishId(dishId);
        return item;
    }).collect(Collectors.toList());

    //保存菜品口味数据到菜品口味表dish_flavor
    dishFlavorService.saveBatch(flavors);
}

在引导类上加注解 @EnableTransactionManagement

Service层方法上加的注解@Transactional要想生效，需要在引导类上加上注解 @EnableTransactionManagement，开启对事务的支持。

@Slf4j
@SpringBootApplication
@ServletComponentScan
@EnableTransactionManagement //开启对事物管理的支持
public class ReggieApplication {
    public static void main(String[] args) {
        SpringApplication.run(ReggieApplication.class,args);
        log.info("项目启动成功...");
    }
}

小小星仔

https://deades-coder.github.io/2022/04/27/spring-xiang-mu-wai-mai-ping-tai-san/

本博客所有文章除特別声明外，均采用 CC BY 4.0 许可协议。转载请注明来源小小星仔 !

Java JavaWeb

Spring项目--外卖平台（四）

外卖平台以及其管理平台开发

2022-04-27 Java

Java JavaWeb

Spring项目--外卖平台（二）

外卖平台以及其管理平台开发

2022-04-27 Java

Java JavaWeb

Spring项目--外卖平台（三）

新增分类

数据模型

前端页面分析

代码实现

实体类Category

分类信息分页查询

前端页面分析

代码实现

删除分类

前端页面分析

代码实现

功能完善

代码实现

文件上传下载

服务端

上传代码实现

前端介绍

服务端实现

代码实现:

下载代码实现

服务端代码

菜品新增

前端页面分析

代码实现

菜品分类查询

保存菜品信息