一个SpringBoot单体项目--》外卖平台项目之后台管理端基础功能开发
外卖平台
- 一 、项目基础实现
-
- 1.1、搭建项目之项目引入静态资源
- 1.2、项目功能实现 --> 后台用户
-
- 1.2.1 -->后台用户登录逻辑的实现
-
- 1.2.1.1 前后端交互流程
- 1.2.1.2 流程说明
- 1.2.2-->后台用户登出逻辑的实现
- 1.2.2.1 请求流程分析
- 1.2.3-->后台新增员工逻辑的实现
-
- 1.2.3.1 程序执行流程
- 1.2.3.2 代码实现流程
- 1.2.3.2 该功能实现注意事项
- 1.2.4-->后台员工信息的分页查询逻辑的实现
-
- 1.2.4.1 程序执行流程
- 1.2.4.2 代码实现
- 1.2.5-->后台启用/禁用员工逻辑的实现
-
- 1.2.5.1 展示效果
- 1.2.5.2 程序执行流程
- 1.2.5.3 代码实现后出现的问题
- 1.2.6-->后台编辑员工逻辑的实现
-
- 1.2.6.1 程序执行流程
-
- 1.2.6.2 根据ID查询员工
- 1.2.6.3 修改员工
- 1.3 关于实现MP提供的公共字段填充
-
- 1.3.1 基于ThreadLocal封装的工具类
- 1.3.2 自动填充类
- 1.4 项目后台功能实现 --> 分类管理
-
- 1.4.1 新增分类
-
- 1.4.1.1 程序执行过程
- 1.4.1.1 代码实现
- 1.4.2 分类信息的分页查询
-
- 1.4.2.1 程序执行过程
- 1.4.2.2 代码实现
- 1.4.3 删除分类
-
- 1.4.3.1 执行流程
- 1.4.3.2 代码实现
- 1.4.4 修改分类
-
- 1.4.4.1 分析
- 1.4.4.1 实现
- 1.5 项目后台功能实现 --> 菜品管理
-
- 1.5.1 关于菜品管理 需要上传菜品图片 ==》涉及文件上传与下载
-
- 上传逻辑:
- 下载逻辑:
- 具体实现：
- 1.5.2 菜品新增
-
- 1.5.2.1 交互流程
-
- 各种类型的实体模型
- 1.5.2.2 代码实现
- 1.5.3 菜品分页查询
-
- 1.5.3.1 需求分析
- 1.5.3.2 前端和服务端交互过程
- 1.5.3.3 代码实现
- 1.5.3 菜品修改
-
- 1.5.3.1 需求分析
- 1.5.3.2 交互流程
- 1.5.3.3 功能实现
-
- 根据ID查询菜品信息
- 修改菜品信息
- 1.6 项目后台功能实现 --> 套餐管理
-
- 1.6.1 --> 新增套餐
-
- 1.6.1.1 需求分析
- 1.6.1.2 数据模型
- 1.6.1.3 前端页面与服务端的交互过程
- 1.6.1.4 代码开发
-
- 根据分类查询菜品
- 保存套餐
- 1.6.2 --> 套餐的分页查询
-
- 1.6.2.1 前端页面和服务端的交互过程
- 1.6.2.2 代码开发
-
- 基本信息查询
- 1.6.3 --> 删除套餐
-
- 1.6.3.1 --> 需求分析
- 1.6.3.2 --> 交互过程
- 1.6.3.3 --> 代码实现
一 、项目基础实现
1.1、搭建项目之项目引入静态资源
关于SpringBoot一体化开发，可以将静态资源（html/css/js等）放在resource文件下，然后编写一个SpringMvc的WebMvcConfig（需要继承一个WebMvcConfigurationSupport，重写一个addResoucehandlers(增加来源处理器)方法）进行响应配置代码的编写；
demo：
import lombok.extern.slf4j.Slf4j;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport;
@Slf4j
@Configuration
public class WebMvcConfig extends WebMvcConfigurationSupport {
/**
* 设置静态资源映射
* @param registry
*/
@Override
protected void addResourceHandlers(ResourceHandlerRegistry registry) {
log.info("开始进行静态资源映射...");
registry.addResourceHandler("/backend/**（访问谁）").addResourceLocations("classpath:/backend/（映射到哪里去）");
registry.addResourceHandler("/front/** 访问谁）").addResourceLocations("classpath:/front/"（映射到哪里去）);
}
}
1.2、项目功能实现 --> 后台用户
1.2.1 -->后台用户登录逻辑的实现
1.2.1.1 前后端交互流程
1.2.1.2 流程说明
前端发送一个post请求，请求体中携带本次请求应该带有的参数，在后台，经过javaweb提供的过滤器（使用它，需要在启动类中加入@ServletConponentScan），进行访问路径的过滤，然后放行到员工的cotroller层，在cotroller进行账号是否存在，密码是否正确，以及该账号的状态是否已被禁用，然后同一个返回一个结果给前端控制器，前端控制器将数据给前端页面；
注意：在登录成功后，要记录该登录用户到session域对象中，以备之后对用户信息的回显，判断用户登录状态，登出用户的操作；
1.2.2–>后台用户登出逻辑的实现
1.2.2.1 请求流程分析
前端发一个post请求到后端，后端清理session中保存的用户id，返回结果
1.2.3–>后台新增员工逻辑的实现
1.2.3.1 程序执行流程
A. 点击"保存"按钮, 页面发送ajax请求，将新增员工页面中输入的数据以json的形式提交到服务端, 请求方式POST, 请求路径 /employee
B. 服务端Controller接收页面提交的数据并调用Service将数据进行保存
C. Service调用Mapper操作数据库，保存数据
1.2.3.2 代码实现流程
A. 在新增员工时， 按钮页面原型中的需求描述， 需要给员工设置初始默认密码 123456， 并对密码进行MD5加密。
B. 在组装员工信息时, 还需要封装创建时间、修改时间，创建人、修改人信息(从session中获取当前登录用户)。
1.2.3.2 该功能实现注意事项
因为在数据库中对用户名进行了唯一的约束，假设，前台提交的增加用户的用户名，在数据库中已经存在，便会抛出一个Duplicate entry异常；显然，在spring中如果让它抛出了，就不得劲了，此时我们便使用Spring提供的全局异常处理机制，也就是说，所有的异常处理都交给spring，spring对异常进行处理；
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.bind.annotation.RestController;
import java.sql.SQLIntegrityConstraintViolationException;
/**
* 全局异常处理
*/
@ControllerAdvice(annotations = {RestController.class, Controller.class})
@ResponseBody
@Slf4j
public class GlobalExceptionHandler {
/**
* 异常处理方法
* @return
*/
@ExceptionHandler(SQLIntegrityConstraintViolationException.class)
public R<String> exceptionHandler(SQLIntegrityConstraintViolationException ex){
log.error(ex.getMessage());
if(ex.getMessage().contains("Duplicate entry")){
String[] split = ex.getMessage().split(" ");
String msg = split[2] + "已存在";
return R.error(msg);
}
return R.error("未知错误");
}
}
注解说明：
@ControllerAdvice : 指定拦截那些类型的控制器;
@ResponseBody: 将方法的返回值 R 对象转换为json格式的数据, 响应给页面;
1.2.4–>后台员工信息的分页查询逻辑的实现
1.2.4.1 程序执行流程
A. 点击菜单，打开员工管理页面时，执行查询：
1). 页面发送ajax请求，将分页查询参数(page、pageSize、name)提交到服务端
2). 服务端Controller接收页面提交的数据, 并组装条件调用Service查询数据
3). Service调用Mapper操作数据库，查询分页数据
4). Controller将查询到的分页数据, 响应给前端页面
5). 页面接收到分页数据, 并通过ElementUI的Table组件展示到页面上
B. 搜索栏输入员工姓名,回车,执行查询:
1). 页面发送ajax请求，将分页查询参数(page、pageSize、name)提交到服务端
2). 服务端Controller接收页面提交的数据, 并组装条件调用Service查询数据
3). Service调用Mapper操作数据库，查询分页数据
4). Controller将查询到的分页数据, 响应给前端页面
5). 页面接收到分页数据, 并通过ElementUI的Table组件展示到页面上
最终发送给服务端的请求为 : GET请求 , 请求链接 /employee/page?page=1&pageSize=10&name=xxx
1.2.4.2 代码实现
1. 分页查询==》本项目dao层框架使用的是mybatis+mybatispuls==〉在dao层框架中提供了分页插件，如果要使用，只需要进行相应配置与导入即可；
2. 配置分页插件步骤：创建一个mybatisPlus的配置文件，要加上@Configration注解，然后编写一个返回返回值为mybatisPlusInterceptor(mybatisplus的拦截器)的方法；在方法中new一个mybatisPlusInterceptor，然后调用该对象中addInnerInterceptor(增加内部拦截器方法)，该方法的概述为分页内部拦截器：
demo：
import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
/**
* 配置MP的分页插件
*/
@Configuration
public class MybatisPlusConfig {
@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor(){
MybatisPlusInterceptor mybatisPlusInterceptor = new MybatisPlusInterceptor();
mybatisPlusInterceptor.addInnerInterceptor(new PaginationInnerInterceptor());
return mybatisPlusInterceptor;
}
}
3. cotroller中代码实现逻辑
1. 构造分页构造器；new 一个page<>对象
2. 构造条件构造器
3. 添加过滤条件
4. 添加排序条件
5. 执行查询
1.2.5–>后台启用/禁用员工逻辑的实现
1.2.5.1 展示效果
员工的启用\禁用操作中，在前台两者的操作只能是管理员进行，也就是说只有管理员（admin用户）可以对其他普通用户进行启用、禁用操作，所以普通用户登录系统后启用、禁用按钮不显示，这是在前台代码中对登录的用户进行了一个判断；
1.2.5.2 程序执行流程
1). 页面发送ajax请求，将参数(id、status)提交到服务端
2). 服务端Controller接收页面提交的数据并调用Service更新数据
3). Service调用Mapper操作数据库
注意：启用、禁用员工账号，本质上就是一个更新操作，也就是对status状态字段进行操作。在Controller中创建update方法，此方法是一个通用的修改员工信息的方法。
1.2.5.3 代码实现后出现的问题
关于后台查询出来的员工对象的id值为一个19位的Long类型，但是前端的Long类型只能处理16位，此时需要我们将后端发给前台的long类型的数据，提前转为String类型，而当前台提交过来也会将String再转为Long
具体实现：
该功能是由于在SpringMVC中, 将Controller方法返回值转换为json对象, 是通过jackson来实现的, 涉及到SpringMVC中的一个消息转换器MappingJackson2HttpMessageConverter, 解决方法是对这个消息转换器进行扩展
实现步骤：
1). 提供对象转换器JacksonObjectMapper，基于Jackson进行Java对象到json数据的转换
package com.itheima.reggie.common;
import com.fasterxml.jackson.databind.DeserializationFeature;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.module.SimpleModule;
import com.fasterxml.jackson.databind.ser.std.ToStringSerializer;
import com.fasterxml.jackson.datatype.jsr310.deser.LocalDateDeserializer;
import com.fasterxml.jackson.datatype.jsr310.deser.LocalDateTimeDeserializer;
import com.fasterxml.jackson.datatype.jsr310.deser.LocalTimeDeserializer;
import com.fasterxml.jackson.datatype.jsr310.ser.LocalDateSerializer;
import com.fasterxml.jackson.datatype.jsr310.ser.LocalDateTimeSerializer;
import com.fasterxml.jackson.datatype.jsr310.ser.LocalTimeSerializer;
import java.math.BigInteger;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.time.format.DateTimeFormatter;
import static com.fasterxml.jackson.databind.DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES;
/**
* 对象映射器:基于jackson将Java对象转为json，或者将json转为Java对象
* 将JSON解析为Java对象的过程称为 [从JSON反序列化Java对象]
* 从Java对象生成JSON的过程称为 [序列化Java对象到JSON]
*/
public class JacksonObjectMapper extends ObjectMapper {
public static final String DEFAULT_DATE_FORMAT = "yyyy-MM-dd";
public static final String DEFAULT_DATE_TIME_FORMAT = "yyyy-MM-dd HH:mm:ss";
public static final String DEFAULT_TIME_FORMAT = "HH:mm:ss";
public JacksonObjectMapper() {
super();
//收到未知属性时不报异常
this.configure(FAIL_ON_UNKNOWN_PROPERTIES, false);
//反序列化时，属性不存在的兼容处理
this.getDeserializationConfig().withoutFeatures(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);
SimpleModule simpleModule = new SimpleModule()
.addDeserializer(LocalDateTime.class, new LocalDateTimeDeserializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_TIME_FORMAT)))
.addDeserializer(LocalDate.class, new LocalDateDeserializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_FORMAT)))
.addDeserializer(LocalTime.class, new LocalTimeDeserializer(DateTimeFormatter.ofPattern(DEFAULT_TIME_FORMAT)))
.addSerializer(BigInteger.class, ToStringSerializer.instance)
.addSerializer(Long.class, ToStringSerializer.instance)
//long ==》String
.addSerializer(LocalDateTime.class, new LocalDateTimeSerializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_TIME_FORMAT)))
.addSerializer(LocalDate.class, new LocalDateSerializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_FORMAT)))
.addSerializer(LocalTime.class, new LocalTimeSerializer(DateTimeFormatter.ofPattern(DEFAULT_TIME_FORMAT)));
//注册功能模块 例如，可以添加自定义序列化器和反序列化器
this.registerModule(simpleModule);
}
}
2). 在WebMvcConfig配置类中扩展Spring mvc的消息转换器，在此消息转换器中使用提供的对象转换器进行Java对象到json数据的转换
/**
* 扩展mvc框架的消息转换器
* @param converters
*/
@Override
protected void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
log.info("扩展消息转换器...");
//创建消息转换器对象
MappingJackson2HttpMessageConverter messageConverter = new MappingJackson2HttpMessageConverter();
//设置对象转换器，底层使用Jackson将Java对象转为json
messageConverter.setObjectMapper(new JacksonObjectMapper());
//将上面的消息转换器对象追加到mvc框架的转换器集合中
converters.add(0,messageConverter);
}
1.2.6–>后台编辑员工逻辑的实现
1.2.6.1 程序执行流程
1). 点击编辑按钮时，页面跳转到add.html，并在url中携带参数[员工id]
2). 在add.html页面获取url中的参数[员工id]
3). 发送ajax请求，请求服务端，同时提交员工id参数
4). 服务端接收请求，根据员工id查询员工信息，将员工信息以json形式响应给页面
5). 页面接收服务端响应的json数据，通过VUE的数据绑定进行员工信息回显
6). 点击保存按钮，发送ajax请求，将页面中的员工信息以json方式提交给服务端
7). 服务端接收员工信息，并进行处理，完成后给页面响应
8). 页面接收到服务端响应信息后进行相应处理
1.2.6.2 根据ID查询员工
代码实现：
/**
* 根据id查询员工信息
* @param id
* @return
*/
@GetMapping("/{id}")
public R<Employee> getById(@PathVariable Long id){
log.info("根据id查询员工信息...");
Employee employee = employeeService.getById(id);
if(employee != null){
return R.success(employee);
}
return R.error("没有查询到对应员工信息");
}
1.2.6.3 修改员工
代码实现：
/**
* 根据id修改员工信息
* @param employee
* @return
*/
@PutMapping
public R<String> update(HttpServletRequest request,@RequestBody Employee employee){
log.info(employee.toString());
Long empId = (Long)request.getSession().getAttribute("employee");
employee.setUpdateTime(LocalDateTime.now());
employee.setUpdateUser(empId);
employeeService.updateById(employee);
return R.success("员工信息修改成功");
}
1.3 关于实现MP提供的公共字段填充
分析：我们可以从数据库中各个表中观察得知，每一张数据表都含有createUser、createTi me、updateUser、updateTime这些公共字段，而在本项目的技术选型中，选用mybatis以及它的最好搭档mybatisplus进行dao层的框架的搭建，而在mybatisplus中提供了公共字段自动填充的功能，通过在实体类中需要填充的字段加上@TableField注解以及编写一个自定义元数据类去实现一个MetaObjectHandler接口，实现其中的方法，该类需要交给spring容器进行管理；在通过元数据对象.setValue去设置公共字段填充内容；
关于自动填充创建/更新用户ID，子啊自定义元数据类中在通过session与获取userID的自动填充，显然是不现实的，接下来想另外一个方法去进行登录用户的信息的保存与提取—》通过实现得知，当一个请求来到后端—〉首先经过了过滤器，然后经过cotroller ，然后经过元数据处理类，最后在去service，dao层，而这一条数据处理链，都是由一个线程来处理的，也就是说，客户端发送的每次http请求，对应的在服务端都会分配一个新的线程来处理，在处理过程中涉及到下面类中的方法都属于相同的一个线程：所以我们可以用这个线程先保存信息，通过thread中threadlocal局部表量，去设置/获取参数；
ThreadLocal常用方法：
A. public void set(T value) : 设置当前线程的线程局部变量的值
B. public T get() : 返回当前线程所对应的线程局部变量的值
C. public void remove() : 删除当前线程所对应的线程局部变量的值
1.3.1 基于ThreadLocal封装的工具类
作用：设置线程中数据与获取线程中数据
实现：
package cn.zkwf.takeout.common;
import cn.zkwf.takeout.entity.Employee;
/**
* @description:线程数据共享工具类
* @author: Sw_Ljb
* @PACKAGE_NAME:cn.zkwf.takeout.common
* @time: 2022/7/21 下午12:53
* @version: 1.0
*/
public class ThreadContext {
//1、直接new出来这个对象 范性T是参数类型
private static ThreadLocal<Long> threadLocal = new ThreadLocal<Long>();
/**
* 设置参数值
* @param empId
*/
public static void setParameter(Long empId ){
threadLocal.set(empId);
}
/**
* 得到参数
* @return
*/
public static Long getParameter(){
return threadLocal.get();
}
}
1.3.2 自动填充类
package cn.zkwf.takeout.common;
import cn.zkwf.takeout.entity.Employee;
import com.baomidou.mybatisplus.core.handlers.MetaObjectHandler;
import lombok.extern.slf4j.Slf4j;
import org.apache.ibatis.reflection.MetaObject;
import org.springframework.stereotype.Component;
import java.time.LocalDateTime;
/**
* @description: 元数据处理类
* @author: Sw_Ljb
* @PACKAGE_NAME:cn.zkwf.takeout.common
* @time: 2022/7/21 下午12:46
* @version: 1.0
*/
@Component
@Slf4j
public class MyMetaObjectHandler implements MetaObjectHandler {
@Override
public void insertFill(MetaObject metaObject) {
log.info("MP进入插入时自动注入元素信息");
//1、设置自动注入时间
metaObject.setValue("createTime", LocalDateTime.now());
metaObject.setValue("updateTime",LocalDateTime.now());
//2、设置自动注入操作人员 因为session不能在这使用 又由于这一条执行链是同一个线程 因此使用localthread进行参数共享
//2.1 得到线程中的值
Long empID = ThreadContext.getParameter();
metaObject.setValue("createUser",empID);
metaObject.setValue("updateUser",empID);
}
@Override
public void updateFill(MetaObject metaObject) {
log.info("MP进入更新数据时自动注入元素信息");
//1、设置更新自动注入时间
metaObject.setValue("updateTime",LocalDateTime.now());
//2、设置自动注入操作人员 因为session不能在这使用 又由于这一条执行链是同一个线程 因此使用localthread进行参数共享
//2.1 得到线程中的值
Long empID = ThreadContext.getParameter();
metaObject.setValue("updateUser",empID);
}
}
1.4 项目后台功能实现 --> 分类管理
1.4.1 新增分类
1.4.1.1 程序执行过程
1). 在页面(backend/page/category/list.html)的新增分类表单中填写数据，点击 “确定” 发送ajax请求，将新增分类窗口输入的数据以json形式提交到服务端
2). 服务端Controller接收页面提交的数据并调用Service将数据进行保存
3). Service调用Mapper操作数据库，保存数据
1.4.1.1 代码实现
1. 基础环境的搭建（实体类+mapper（继承basemapper<实体类>）+service(interface IService<实体类>)(serviceimpl(extends ServiceImpl<实体类mapper，实体类> interface service))+controller）；
2. 代码实现流程：前端将数据转为json传递给后端，后端在controller中使用@RequestBody注解 使用实体类去接受，然后直接调用service直接操作；
1.4.2 分类信息的分页查询
1.4.2.1 程序执行过程
1). 页面发送ajax请求，将分页查询参数(page、pageSize)提交到服务端
2). 服务端Controller接收页面提交的数据并调用Service查询数据
3). Service调用Mapper操作数据库，查询分页数据
4). Controller将查询到的分页数据响应给页面
5). 页面接收到分页数据并通过ElementUI的Table组件展示到页面上
1.4.2.2 代码实现
/**
* 分页查询
* @param page
* @param pageSize
* @return
*/
@GetMapping("/page")
public R<Page> page(int page,int pageSize){
//分页构造器
Page<Category> pageInfo = new Page<>(page,pageSize);
//条件构造器
LambdaQueryWrapper<Category> queryWrapper = new LambdaQueryWrapper<>();
//添加排序条件，根据sort进行排序
queryWrapper.orderByAsc(Category::getSort);
//分页查询
categoryService.page(pageInfo,queryWrapper);
return R.success(pageInfo);
}
1.4.3 删除分类
1.4.3.1 执行流程
1). 点击删除，页面发送ajax请求，将参数(id)提交到服务端
2). 服务端Controller接收页面提交的数据并调用Service删除数据
3). Service调用Mapper操作数据库
1.4.3.2 代码实现
分析：在执行删除分类操作时，删除逻辑不能时直接将分类，而是应该先检查当前分类下是否关联了菜品或者套餐，然后将这个分类的id拿着，去菜品或者套餐中查询是否含有该分类的数据，如果有抛一个自定义异常，如果没有，则可以删除该分类；
实现步骤：
- 创建自定义异常
package cn.zkwf.takeout.exception;
/**
* @description:
* @author: Sw_Ljb
* @PACKAGE_NAME:cn.zkwf.takeout.exception
* @time: 2022/7/21 下午2:05
* @version: 1.0
*/
public class CostomExcetion extends RuntimeException{
public CostomExcetion(String message) {
super(message);
}
}
- 在全局异常处理器中将自定义异常加入
全局异常处理器：
package cn.zkwf.takeout.common;
import cn.zkwf.takeout.exception.CostomExcetion;
import cn.zkwf.takeout.resulttype.R;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.bind.annotation.RestController;
import java.sql.SQLIntegrityConstraintViolationException;
/**
* @description:
* @author: Sw_Ljb
* @PACKAGE_NAME:cn.zkwf.takeout.common
* @time: 2022/7/20 下午1:53
* @version: 1.0
*/
@Slf4j
@ControllerAdvice(annotations = {RestController.class, Controller.class})
@ResponseBody
public class GlobalExceptionHandler {
@ExceptionHandler(SQLIntegrityConstraintViolationException.class)
public R<String> exceptionHandler(SQLIntegrityConstraintViolationException ex){
//1、打印日志
log.info("自定义全局异常处理正在运行！！");
//Duplicate entry 'zhangsan' for key 'employee.idx_username'
if (ex.getMessage().contains("Duplicate entry ")){
//2、判断当前抛出的异常是否为Duplicate entry
String[] strArray = ex.getMessage().split(" ");
//3、截取异常信息中重点错误信息
String msg= strArray[2] +"已经存在了!!";
//4、设置返回信息
return R.error(msg);
}
//4、设置返回信息
return R.error("未知错误！");
}
@ExceptionHandler(CostomExcetion.class)
public R<String> costomerExceptionHandler(CostomExcetion ex){
//1、打印日志
log.info("自定义全局异常处理正在运行！！==>自定义异常");
return R.error(ex.getMessage());
}
}
- 扩展分类service，实现该方法
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);
}
1.4.4 修改分类
1.4.4.1 分析
当前端点"修改"按钮的时候，当信息被修改后，点击保存按钮，页面在发送一个请求，去修改分类信息
1.4.4.1 实现
回显：回显这一步的操作前端已经实现
修改：
/**
* 根据id修改分类信息
* @param category
* @return
*/
@PutMapping
public R<String> update(@RequestBody Category category){
log.info("修改分类信息：{}",category);
categoryService.updateById(category);
return R.success("修改分类信息成功");
}
1.5 项目后台功能实现 --> 菜品管理
1.5.1 关于菜品管理 需要上传菜品图片 ==》涉及文件上传与下载
文件上传三要素：
| 表单属性 | 取值 | 说明 |
|---|---|---|
| method | post | 必须选择post方式提交 |
| enctype | multipart/form-data | 采用multipart格式上传文件 |
| type | file | 使用input的file控件上传 |
文件下载两种表现形式
- 以附件形式下载，弹出保存对话框，将文件保存到指定磁盘目录
- 直接在浏览器中打开，通过浏览器进行文件下载，本质上就是服务端将文件以流的形式写回浏览器的过程。
上传逻辑:
1). 获取文件的原始文件名, 通过原始文件名获取文件后缀
2). 通过UUID重新声明文件名, 文件名称重复造成文件覆盖
3). 创建文件存放目录
4). 将上传的临时文件转存到指定位置
下载逻辑:
1). 定义输入流，通过输入流读取文件内容
2). 通过response对象，获取到输出流
3). 通过response对象设置响应数据格式(image/jpeg)
4). 通过输入流读取文件数据，然后通过上述的输出流写回浏览器
5). 关闭资源
具体实现：
package cn.zkwf.takeout.controller;
import cn.zkwf.takeout.resulttype.R;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;
import javax.servlet.ServletOutputStream;
import javax.servlet.http.HttpServletResponse;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.util.UUID;
/**
* @description:
* http://localhost:7070/common/upload
* Request Method: POST
* @author: Sw_Ljb
* @PACKAGE_NAME:cn.zkwf.takeout.controller
* @time: 2022/7/22 下午2:54
* @version: 1.0
*/
@Slf4j
@RestController
@RequestMapping("/common")
public class FileController {
@Value(value = "${serverpath.serverImpPath}")
private String serverImpPath;
//Content-Disposition: form-data; name="file"; filename="0a3b3288-3446-4420-bbff-f263d0c02d8e.jpg"
@RequestMapping("/upload")
public R<String> upload(MultipartFile file){
log.info("上传路径{}:",serverImpPath);
//更保险的做法 将上传过来的照片再次创建一个uuid
String suffdex = file.getOriginalFilename().substring(file.getOriginalFilename().indexOf('.'));
String imgName = UUID.randomUUID().toString()+suffdex;
try {
//上传路径/Users/mac/Desktop/fliedemo/takeoutServerImg保险期间对目录进行一次判断
File imgfile = new File(serverImpPath);
if (!imgfile.exists()){
imgfile.mkdirs();
}
file.transferTo(new File(serverImpPath+"/"+imgName));
} catch (IOException e) {
e.printStackTrace();
}
return R.success(imgName);
}
/**
* 下载数据
* @param response
* @param name
*/
@GetMapping("/download")
public void download(HttpServletResponse response, String name){
log.info("下载文件{}",name);
try {
//输入流
FileInputStream fis = new FileInputStream(new File(serverImpPath+"/"+name));
log.info(serverImpPath+"/"+name);
//输出流
ServletOutputStream outputStream = response.getOutputStream();
//先读出来 再响应给前台
//设置响应类型
response.setContentType("image/jpeg");
//1、定义一个读出来存的字节数组
byte[] bytes = new byte[1024];
//2、定一个读多少
int len= 0;
while ((len = fis.read(bytes))!=-1){
//3、写会前台
outputStream.write(bytes,0,len);
outputStream.flush();
}
//4、记得关流,释放资源
outputStream.close();
fis.close();
} catch (Exception e) {
e.printStackTrace();
}
}
}
1.5.2 菜品新增
分析：新增菜品，其实就是将新增页面录入的菜品信息插入到dish表，如果添加了口味做法，还需要向dish_flavor表插入数据。所以在新增菜品时，涉及到两个表：dish/dish_flavor
1.5.2.1 交互流程
1). 点击新建菜品按钮, 访问页面(backend/page/food/add.html), 页面加载时发送ajax请求，请求服务端获取菜品分类数据并展示到下拉框中
2). 页面发送请求进行图片上传，请求服务端将图片保存到服务器(上传功能已实现)
3). 页面发送请求进行图片下载，将上传的图片进行回显(下载功能已实现)
4). 点击保存按钮，发送ajax请求，将菜品相关数据以json形式提交到服务端
对于前端传递到服务端的数据分析：
如果使用菜品类Dish来封装，只能封装菜品的基本属性，flavors属性是无法封装的。这个时候，我们需要自定义一个实体类，然后继承自 Dish，并对Dish的属性进行拓展，增加 flavors 集合属性(内部封装DishFlavor)。
各种类型的实体模型
1.5.2.2 代码实现
页面传递的菜品口味信息，仅仅包含name 和 value属性，缺少一个非常重要的属性dishId， 所以在保存完菜品的基本信息后，我们需要获取到菜品ID，然后为菜品口味对象属性dishId赋值。
具体逻辑如下：
①. 保存菜品基本信息 ;
②. 获取保存的菜品ID ;
③. 获取菜品口味列表，遍历列表，为菜品口味对象属性dishId赋值;
④. 批量保存菜品口味列表;
注意：由于需要进行了两次数据库的保存操作，操作了两张表，那么为了保证数据的一致性，我们需要在方法上加上注解 @Transactional来控制事务。Service层方法上加的注解@Transactional要想生效，需要在引导类上加上注解 @EnableTransactionManagement， 开启对事务的支持。
代码实现：
@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);
}
1.5.3 菜品分页查询
1.5.3.1 需求分析
系统中的菜品数据很多的时候，如果在一个页面中全部展示出来会显得比较乱，不便于查看，所以一般的系统中都会以分页的方式来展示列表数据。
在菜品列表展示时，除了菜品的基本信息(名称、售价、售卖状态、更新时间)外，还有两个字段略微特殊，第一个是图片字段 ，我们从数据库查询出来的仅仅是图片的名字，图片要想在表格中回显展示出来，就需要下载这个图片。第二个是菜品分类，这里展示的是分类名称，而不是分类ID，此时我们就需要根据菜品的分类ID，去分类表中查询分类信息，然后在页面展示。
1.5.3.2 前端和服务端交互过程
1). 访问页面(backend/page/food/list.html)时，发送ajax请求，将分页查询参数(page、pageSize、name)提交到服务端，获取分页数据
2). 页面发送请求，请求服务端进行图片下载，用于页面图片展示
1.5.3.3 代码实现
分析：
实体类 Dish 中，仅仅包含 categoryId， 不包含 categoryName，这里我们可以返回DishDto对象，在该对象中我们可以拓展一个属性 categoryName，来封装菜品分类名称。
具体逻辑为：
1). 构造分页条件对象
2). 构建查询及排序条件
3). 执行分页条件查询
4). 遍历分页查询列表数据，根据分类ID查询分类信息，从而获取该菜品的分类名称
5). 封装数据并返回
实现：
/**
* 菜品信息分页查询
* @param page
* @param pageSize
* @param name
* @return
*/
@GetMapping("/page")
public R<Page> page(int page,int pageSize,String name){
//构造分页构造器对象
Page<Dish> pageInfo = new Page<>(page,pageSize);
Page<DishDto> dishDtoPage = new Page<>();
//条件构造器
LambdaQueryWrapper<Dish> queryWrapper = new LambdaQueryWrapper<>();
//添加过滤条件
queryWrapper.like(name != null,Dish::getName,name);
//添加排序条件
queryWrapper.orderByDesc(Dish::getUpdateTime);
//执行分页查询
dishService.page(pageInfo,queryWrapper);
//对象拷贝
BeanUtils.copyProperties(pageInfo,dishDtoPage,"records");
List<Dish> records = pageInfo.getRecords();
List<DishDto> list = records.stream().map((item) -> {
DishDto dishDto = new DishDto();
BeanUtils.copyProperties(item,dishDto);
Long categoryId = item.getCategoryId();//分类id
//根据id查询分类对象
Category category = categoryService.getById(categoryId);
if(category != null){
String categoryName = category.getName();
dishDto.setCategoryName(categoryName);
}
return dishDto;
}).collect(Collectors.toList());
dishDtoPage.setRecords(list);
return R.success(dishDtoPage);
}
数据库查询菜品信息时，获取到的分页查询结果 Page 的泛型为 Dish，而我们最终需要给前端页面返回的类型为 DishDto，所以这个时候就要进行转换，基本属性我们可以直接通过属性拷贝的形式对Page中的属性进行复制，而对于结果列表 records属性，是需要进行特殊处理的(需要封装菜品分类名称);
1.5.3 菜品修改
1.5.3.1 需求分析
在菜品管理列表页面点击修改按钮，跳转到修改菜品页面，在修改页面回显菜品相关信息并进行修改，最后点击确定按钮完成修改操作。
1.5.3.2 交互流程
1). 点击菜品列表的中的修改按钮，携带菜品id跳转至add.html
2). 进入add.html，页面发送ajax请求，请求服务端获取分类数据，用于菜品分类下拉框中数据展示
3). add.html获取id, 发送ajax请求，请求服务端，根据id查询当前菜品信息，用于菜品信息回显
4). 页面发送请求，请求服务端进行图片下载，用于页图片回显
5). 点击保存按钮，页面发送ajax请求，将修改后的菜品相关数据以json形式提交到服务端
我们只需要在这里实现两个功能即可：
1). 根据ID查询菜品及菜品口味信息
2). 修改菜品及菜品口味信息
1.5.3.3 功能实现
根据ID查询菜品信息
具体逻辑为:
A. 根据ID查询菜品的基本信息
B. 根据菜品的ID查询菜品口味列表数据
C. 组装数据并返回
/**
* 根据id查询菜品信息和对应的口味信息
* @param id
* @return
*/
public DishDto getByIdWithFlavor(Long id) {
//查询菜品基本信息，从dish表查询
Dish dish = this.getById(id);
DishDto dishDto = new DishDto();
BeanUtils.copyProperties(dish,dishDto);
//查询当前菜品对应的口味信息，从dish_flavor表查询
LambdaQueryWrapper<DishFlavor> queryWrapper = new LambdaQueryWrapper<>();
queryWrapper.eq(DishFlavor::getDishId,dish.getId());
List<DishFlavor> flavors = dishFlavorService.list(queryWrapper);
dishDto.setFlavors(flavors);
return dishDto;
}
修改菜品信息
实现步骤：
点击保存按钮，页面发送ajax请求，将修改后的菜品相关数据以json形式提交到服务端。在修改菜品信息时需要注意，除了要更新dish菜品表，还需要更新dish_flavor菜品口味表；在该方法中，我们既需要更新dish菜品基本信息表，还需要更新dish_flavor菜品口味表。而页面再操作时，关于菜品的口味，有修改，有新增，也有可能删除，我们应该如何更新菜品口味信息呢，其实，无论菜品口味信息如何变化，我们只需要保持一个原则： 先删除，后添加。
@Override
@Transactional
public void updateWithFlavor(DishDto dishDto) {
//更新dish表基本信息
this.updateById(dishDto);
//清理当前菜品对应口味数据---dish_flavor表的delete操作
LambdaQueryWrapper<DishFlavor> queryWrapper = new LambdaQueryWrapper();
queryWrapper.eq(DishFlavor::getDishId,dishDto.getId());
dishFlavorService.remove(queryWrapper);
//添加当前提交过来的口味数据---dish_flavor表的insert操作
List<DishFlavor> flavors = dishDto.getFlavors();
flavors = flavors.stream().map((item) -> {
item.setDishId(dishDto.getId());
return item;
}).collect(Collectors.toList());
dishFlavorService.saveBatch(flavors);
}
1.6 项目后台功能实现 --> 套餐管理
1.6.1 --> 新增套餐
1.6.1.1 需求分析
后台系统中可以管理套餐信息，通过新增套餐功能来添加一个新的套餐，在添加套餐时需要选择当前套餐所属的套餐分类和包含的菜品，并且需要上传套餐对应的图片，在移动端会按照套餐分类来展示对应的套餐。
1.6.1.2 数据模型
新增套餐，其实就是将新增页面录入的套餐信息插入到setmeal表，还需要向setmeal_dish表插入套餐和菜品关联数据。所以在新增套餐时，涉及到两个表：
1.6.1.3 前端页面与服务端的交互过程
1). 点击新建套餐按钮，访问页面(backend/page/combo/add.html)，页面加载发送ajax请求，请求服务端获取套餐分类数据并展示到下拉框中
2). 访问页面(backend/page/combo/add.html)，页面加载时发送ajax请求，请求服务端获取菜品分类数据并展示到添加菜品窗口中
3). 当点击添加菜品窗口左侧菜单的某一个分类, 页面发送ajax请求，请求服务端，根据菜品分类查询对应的菜品数据并展示到添加菜品窗口中
4). 页面发送请求进行图片上传，请求服务端将图片保存到服务器
5). 页面发送请求进行图片下载，将上传的图片进行回显
6). 点击保存按钮，发送ajax请求，将套餐相关数据以json形式提交到服务端
分析发送的请求有5个，分别是：
A. 根据传递的参数,查询套餐分类列表
B. 根据传递的参数,查询菜品分类列表
C. 图片上传
D. 图片下载展示
E. 根据菜品分类ID,查询菜品列表
F. 保存套餐信息
1.6.1.4 代码开发
根据分类查询菜品
/**
* 根据条件查询对应的菜品数据
* @param dish
* @return
*/
@GetMapping("/list")
public R<List<Dish>> list(Dish dish){
//构造查询条件
LambdaQueryWrapper<Dish> queryWrapper = new LambdaQueryWrapper<>();
queryWrapper.eq(dish.getCategoryId() != null ,Dish::getCategoryId,dish.getCategoryId());
//添加条件，查询状态为1（起售状态）的菜品
queryWrapper.eq(Dish::getStatus,1);
//添加排序条件
queryWrapper.orderByAsc(Dish::getSort).orderByDesc(Dish::getUpdateTime);
List<Dish> list = dishService.list(queryWrapper);
return R.success(list);
}
保存套餐
分析: 在进行套餐信息保存时，前端提交的数据，不仅包含套餐的基本信息，还包含套餐关联的菜品列表数据 setmealDishes。所以这个时候我们使用Setmeal就不能完成参数的封装了，我们需要在Setmeal的基本属性的基础上，再扩充一个属性 setmealDishes 来接收页面传递的套餐关联的菜品列表，而我们在准备工作中，导入进来的SetmealDto能够满足这个需求。
SetmealServiceImpl.saveWithDish():
具体逻辑:
A. 保存套餐基本信息
B. 获取套餐关联的菜品集合，并为集合中的每一个元素赋值套餐ID(setmealId)
C. 批量保存套餐关联的菜品集合
代码实现：
/**
* 新增套餐，同时需要保存套餐和菜品的关联关系
* @param setmealDto
*/
@Transactional
public void saveWithDish(SetmealDto setmealDto) {
//保存套餐的基本信息，操作setmeal，执行insert操作
this.save(setmealDto);
List<SetmealDish> setmealDishes = setmealDto.getSetmealDishes();
setmealDishes.stream().map((item) -> {
item.setSetmealId(setmealDto.getId());
return item;
}).collect(Collectors.toList());
//保存套餐和菜品的关联信息，操作setmeal_dish,执行insert操作
setmealDishService.saveBatch(setmealDishes);
}
1.6.2 --> 套餐的分页查询
1.6.2.1 前端页面和服务端的交互过程
1). 访问页面(backend/page/combo/list.html)，页面加载时，会自动发送ajax请求，将分页查询参数(page、pageSize、name)提交到服务端，获取分页数据
2). 在列表渲染展示时，页面发送请求，请求服务端进行图片下载，用于页面图片展示
1.6.2.2 代码开发
基本信息查询
基本逻辑：
1). 构建分页条件对象
2). 构建查询条件对象，如果传递了套餐名称，根据套餐名称模糊查询， 并对结果按修改时间降序排序
3). 执行分页查询
4). 由于查询套餐信息时, 只包含套餐的基本信息, 并不包含套餐的分类名称, 所以在这里查询到套餐的基本信息后, 还需要根据分类ID(categoryId), 查询套餐分类名称(categoryName)，并最终将套餐的基本信息及分类名称信息封装到SetmealDto。组装数据并返回
代码实现：
/**
* 套餐分页查询
* @param page
* @param pageSize
* @param name
* @return
*/
@GetMapping("/page")
public R<Page> page(int page,int pageSize,String name){
//分页构造器对象
Page<Setmeal> pageInfo = new Page<>(page,pageSize);
Page<SetmealDto> dtoPage = new Page<>();
LambdaQueryWrapper<Setmeal> queryWrapper = new LambdaQueryWrapper<>();
//添加查询条件，根据name进行like模糊查询
queryWrapper.like(name != null,Setmeal::getName,name);
//添加排序条件，根据更新时间降序排列
queryWrapper.orderByDesc(Setmeal::getUpdateTime);
setmealService.page(pageInfo,queryWrapper);
//对象拷贝
BeanUtils.copyProperties(pageInfo,dtoPage,"records");
List<Setmeal> records = pageInfo.getRecords();
List<SetmealDto> list = records.stream().map((item) -> {
SetmealDto setmealDto = new SetmealDto();
//对象拷贝
BeanUtils.copyProperties(item,setmealDto);
//分类id
Long categoryId = item.getCategoryId();
//根据分类id查询分类对象
Category category = categoryService.getById(categoryId);
if(category != null){
//分类名称
String categoryName = category.getName();
setmealDto.setCategoryName(categoryName);
}
return setmealDto;
}).collect(Collectors.toList());
dtoPage.setRecords(list);
return R.success(dtoPage);
}
1.6.3 --> 删除套餐
1.6.3.1 --> 需求分析
在套餐管理列表页面,点击删除按钮，可以删除对应的套餐信息。也可以通过复选框选择多个套餐，点击批量删除按钮一次删除多个套餐。注意，对于状态为售卖中的套餐不能删除，需要先停售，然后才能删除
1.6.3.2 --> 交互过程
1). 点击删除, 删除单个套餐时，页面发送ajax请求，根据套餐id删除对应套餐
2). 删除多个套餐时，页面发送ajax请求，根据提交的多个套餐id删除对应套餐
分析：开发删除套餐功能，其实就是在服务端编写代码去处理前端页面发送的这2次请求即可，一次请求为根据ID删除，一次请求为根据ID批量删除。观察删除单个套餐和批量删除套餐的请求信息可以发现，两种请求的地址和请求方式都是相同的，不同的则是传递的id个数，所以在服务端可以提供一个方法来统一处理。
1.6.3.3 --> 代码实现
分析：删除套餐时, 我们不仅要删除套餐, 还要删除套餐与菜品的关联关系。
实现：SetmealServiceImpl.removeWithDish():
具体的逻辑:
A. 查询该批次套餐中是否存在售卖中的套餐, 如果存在, 不允许删除
B. 删除套餐数据
C. 删除套餐关联的菜品数据
/**
* 删除套餐，同时需要删除套餐和菜品的关联数据
* @param ids
*/
@Transactional
public void removeWithDish(List<Long> ids) {
//select count(*) from setmeal where id in (1,2,3) and status = 1
//查询套餐状态，确定是否可用删除
LambdaQueryWrapper<Setmeal> queryWrapper = new LambdaQueryWrapper();
queryWrapper.in(Setmeal::getId,ids);
queryWrapper.eq(Setmeal::getStatus,1);
int count = this.count(queryWrapper);
if(count > 0){
//如果不能删除，抛出一个业务异常
throw new CustomException("套餐正在售卖中，不能删除");
}
//如果可以删除，先删除套餐表中的数据---setmeal
this.removeByIds(ids);
//delete from setmeal_dish where setmeal_id in (1,2,3)
LambdaQueryWrapper<SetmealDish> lambdaQueryWrapper = new LambdaQueryWrapper<>();
lambdaQueryWrapper.in(SetmealDish::getSetmealId,ids);
//删除关系表中的数据----setmeal_dish
setmealDishService.remove(lambdaQueryWrapper);
}