Java项目——苍穹外卖（一）

Entity、DTO、VO

Entity（实体）

Entity 是表示数据库表的对象，通常对应数据库中的一行数据。它通常包含与数据库表对应的字段，并可能包含一些业务逻辑。

DTO（数据传输对象）

作用：DTO 是用于在不同层之间传输数据的对象，通常用于网络传输或服务间调用。DTO 主要用于减少网络请求的次数，携带数据而不包含业务逻辑。
特点：DTO类通常只包含数据字段和相应的getter和setter方法，不包含任何业务逻辑。它们可能包含与Entity类相似的字段，但也可能根据需要进行裁剪或扩展。

VO（视图对象）

位置：虽然VO这个术语不如DTO和Entity那样普遍，但在一些项目中，你可能会看到vo包用于存放视图对象。
作用：VO主要用于封装返回给前端的数据。它们可以被视为DTO的一种特殊形式，专门用于视图层的数据展示。VO可以根据前端的需求进行定制，包含前端需要展示的所有数据，以及可能的前端逻辑（如格式化数据）。
特点：VO类与DTO类似，主要关注数据的封装和传输，但更侧重于前端展示的需求。它们可能包含与Entity或DTO不同的字段，或者对字段进行不同的封装和格式化。

举例

对于数据库中的employee表：

@Data
@Builder//构建器注解，此类的对象可以使用builder方法进行构建
@NoArgsConstructor
@AllArgsConstructor
public class Employee implements Serializable {private static final long serialVersionUID = 1L;private Long id;private String username;private String name;private String password;private String phone;private String sex;private String idNumber;private Integer status;//@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")private LocalDateTime createTime;//@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")private LocalDateTime updateTime;private Long createUser;private Long updateUser;}

@Data
public class EmployeeDTO implements Serializable {private Long id;private String username;private String name;private String phone;private String sex;private String idNumber;}

总结

Entity：

与数据库表对应，包含数据的持久化逻辑。
主要用于数据库操作，在数据访问层与数据库交互时使用。
封装数据库操作的细节
属性通常与数据库表字段一一对应

DTO：

用于层与层之间的数据传输，不包含业务逻辑。
用于系统内部数据传输，在服务层调用中传递数据。
封装业务逻辑的细节
可以包含额外的或部分的属性

VO：

用于封装返回给前端的数据，可能包含前端展示所需的特定逻辑。
在展示层向用户展示数据时使用
封装展示逻辑的细节
可以包含额外的或部分的属性

公共字段填充（AOP）

问题分析

在增加或查询操作中，设置下列字段时代码冗余，不便于后期维护

实现思路

技术点：枚举、注解、AOP、反射

一、创建枚举类

/*** 数据库操作类型* 枚举类*/
public enum OperationType {/*** 更新操作*/UPDATE,/*** 插入操作*/INSERT}

二、创建自定义注解类

/*** 自定义注解，用于标识某个方法需要进行功能字段自动填充处理* 这个类可以作为一个注解进行使用*/
@Target(ElementType.METHOD)//指定当前的自定义注解只能加在方法上
@Retention(RetentionPolicy.RUNTIME)//固定写法
public @interface AutoFill {//数据库操作类型：UPDATE INSERT(只有增加和修改操作涉及公共字段填充)OperationType value();
}

三、在切入点方法上加入自定义注解，并指定其属性（更新操作/插入操作）

四、创建切面类，在切面类中实现通知逻辑

/*** 自定义切面类，实现公共字段自动填充处理逻辑*/
@Aspect//设置当前类为切面类，告诉spring这个类是用来做AOP的
@Component//通知类（切面类）必须配置成Spring管理的bean
@Slf4j
public class AutoFillAspect {//此切入点表达式前半部分锁定mapper包下所有类所有方法，后半部分锁定方法中加入了AutoFill注解的方法@Pointcut("execution(* com.sky.mapper.*.*(..)) && @annotation(com.sky.annotation.AutoFill)")public void autoFillPointCut(){}/*** 前置通知，在通知中进行公共字段的赋值*/@Before("autoFillPointCut()")public void autoFill(JoinPoint joinPoint){log.info("开始进行公共字段自动填充");//1.获取当前被拦截的方法上的数据库操作类型MethodSignature signature = (MethodSignature) joinPoint.getSignature();//获得方法签名对象，并向下转型为MethodSignatureAutoFill antoFill = signature.getMethod().getAnnotation(AutoFill.class);//获得方法上的注解对象OperationType operationType = antoFill.value();//获得数据库操作类型//这三行的代码最终作用是获得注解中的数据库操作类型，也就是 @AutoFill(value = OperationType.UPDATE)中的value//2.获取当前被拦截的方法的参数--实体对象Object[] args = joinPoint.getArgs();//获取通知点方法的参数if(args == null || args.length == 0){//如果没有参数则直接返回return;}Object entity = args[0];//3.准备赋值的数据LocalDateTime now = LocalDateTime.now();//update_time的值Long currentId = BaseContext.getCurrentId();//update_user的值//4.根据当前不同的操作类型，为对应的属性通过反射来赋值if(operationType == operationType.INSERT){//新增操作为4个公共字段赋值try {//4.1通过反射获取这四个方法//使用常量类AutoFillConstant中的常量代替方法名，防止自己写写错Method setCreateTime = entity.getClass().getDeclaredMethod(AutoFillConstant.SET_CREATE_TIME, LocalDateTime.class);Method setCreateUser = entity.getClass().getDeclaredMethod(AutoFillConstant.SET_CREATE_USER, Long.class);Method setUpdateTime = entity.getClass().getDeclaredMethod(AutoFillConstant.SET_UPDATE_TIME, LocalDateTime.class);Method setUpdateUser = entity.getClass().getDeclaredMethod(AutoFillConstant.SET_UPDATE_USER, Long.class);//4.2通过反射调用获取到的四个方法为对象属性赋值setCreateTime.invoke(entity,now);//entity中存的是Employee//这行代码：使用entity对象调用setCreateTime方法，给方法传递参数nowsetCreateUser.invoke(entity,currentId);setUpdateTime.invoke(entity,now);setUpdateUser.invoke(entity,currentId);} catch (Exception e) {e.printStackTrace();}}else if(operationType == operationType.UPDATE){//修改操作为2个公共字段赋值try {Method setUpdateTime = entity.getClass().getDeclaredMethod(AutoFillConstant.SET_UPDATE_TIME, LocalDateTime.class);Method setUpdateUser = entity.getClass().getDeclaredMethod(AutoFillConstant.SET_UPDATE_USER, Long.class);setUpdateTime.invoke(entity,now);setUpdateUser.invoke(entity,currentId);} catch (Exception e) {e.printStackTrace();}}}
}

总结

1、创建枚举类，其中有插入、修改操作变量

2、创建自定义注解类，其中属性引用枚举类的变量

@Target(ElementType.METHOD)//指定当前的自定义注解只能加在方法
@Retention(RetentionPolicy.RUNTIME)//固定写法3、

3、在mapper层中的插入、修改方法上加入自定义注解，并通过属性指定其操作类型（插入或修改）

4、创建切面类，进行切入点表达式和通知的实现

@Aspect//设置当前类为切面类，告诉spring这个类是用来做AOP的
@Component//通知类（切面类）必须配置成Spring管理的bean

文件上传

利用阿里云实现文件上传功能，将文件上传并存储到阿里云存储空间，并返回文件的访问地址，以便在前端可以回显文件

一、在sky-common中的properties包下创建AliOssProperties类

@Component
@ConfigurationProperties(prefix = "sky.alioss")//将配置文件中sky.alioss的相关属性值赋给此类中的成员
@Data
public class AliOssProperties {private String endpoint;private String accessKeyId;private String accessKeySecret;private String bucketName;//Bucket名称
}

二、在sky-common中的utils包下创建AliOssUtil类

此类实现upload方法，实现文件上传功能，此方法返回文件的访问路径

@Data
@AllArgsConstructor
@Slf4j
public class AliOssUtil {private String endpoint;private String accessKeyId;private String accessKeySecret;private String bucketName;/*** 文件上传** @param bytes* @param objectName* @return*///将文件上传到阿里云并返回文件的请求路径//第一个参数：文件的字节数组，第二个参数：拼接uuid后的新文件名public String upload(byte[] bytes, String objectName) {// 创建OSSClient实例。OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);try {// 创建PutObject请求。ossClient.putObject(bucketName, objectName, new ByteArrayInputStream(bytes));} catch (OSSException oe) {System.out.println("Caught an OSSException, which means your request made it to OSS, "+ "but was rejected with an error response for some reason.");System.out.println("Error Message:" + oe.getErrorMessage());System.out.println("Error Code:" + oe.getErrorCode());System.out.println("Request ID:" + oe.getRequestId());System.out.println("Host ID:" + oe.getHostId());} catch (ClientException ce) {System.out.println("Caught an ClientException, which means the client encountered "+ "a serious internal problem while trying to communicate with OSS, "+ "such as not being able to access the network.");System.out.println("Error Message:" + ce.getMessage());} finally {if (ossClient != null) {ossClient.shutdown();}}//文件访问路径规则 https://BucketName.Endpoint/ObjectNameStringBuilder stringBuilder = new StringBuilder("https://");stringBuilder.append(bucketName).append(".").append(endpoint).append("/").append(objectName);log.info("文件上传到:{}", stringBuilder.toString());return stringBuilder.toString();}
}

三、在sky-server模块下的config包中创建OssConfiguration类

此配置类用于创建AliossUtil对象：实现aliOssUtil方法，此方法将AliOssProperties对象作为参数传入，方法内读取AliOssProperties中的四个属性，将其包装为AliossUtil对象返回，并将这个AliossUtil交给ioc容器管理，需要时可以直接依赖注入（注入的AliossUtil对象的四个属性已经赋过值）

此类相当于一个中间媒介，关联AliOssProperties类和AliOssUtil，接收一个AliOssProperties并将其转换为一个AliOssUtil后返回，本质就是将AliOssProperties中从.yml中读取到的四个属性值赋给AliOssUtil中相应的四个属性

这四个属性的的去向总结为：

.yml(人为预先定义好四个属性的值)--->AliOssProperties类(利用注解从.yml中读取四个属性)-->OssConfiguration类(从类中方法接收的参数AliOssProperties对象中读取四个属性，并封装为AliOssUtil对象)-->AliOssUtil对象(OssConfiguration类中方法的返回值)

@Configuration
@Slf4j
public class OssConfiguration {@Bean@ConditionalOnMissingBean//保证整个容器中只有一个AliOssUtil对象public AliOssUtil aliOssUtil(AliOssProperties aliOssProperties){log.info("开始创建阿里云文件上传工具类对象：{}",aliOssProperties);return new AliOssUtil(aliOssProperties.getEndpoint(),aliOssProperties.getAccessKeyId(),aliOssProperties.getAccessKeySecret(),aliOssProperties.getBucketName());}
}

四、在controller层中创建CommonController类

此类用来对前端文件上传的请求进行响应，前端传来一个文件参数

在此类中构造新的文件名称（uuid拼接原始文件名后缀）
调用AliOssUtil中的upload方法进行文件上传（方法参数为文件的字节数组和新文件名字符串）
上传方法返回值为文件的访问路径，将其封装为Result类型响应给前端

@RestController
@RequestMapping("/admin/common")
@Api(tags = "通用接口")
@Slf4j
public class CommonController {@Autowiredprivate AliOssUtil aliOssUtil;/*** 文件上传* @param file* @return*/@PostMapping("/upload")@ApiOperation("文件上传")public Result<String> upload(MultipartFile file){log.info("文件上传：{}",file);try {//获取原始文件名String originalFilename = file.getOriginalFilename();//将原始文件名的后缀截取出来String extension = originalFilename.substring(originalFilename.lastIndexOf("."));//构造新文件名称（uuid拼接原始文件名后缀）String objectName = UUID.randomUUID().toString() + extension;//获取文件的请求路径String filePath = aliOssUtil.upload(file.getBytes(), objectName);return Result.success(filePath);} catch (IOException e) {log.error("文件上传失败：{}",e);}return null;}
}

总结

文件上传功能的核心为CommonController类和AliOssUtil类

CommonController类用来对前端请求进行响应，调用依赖注入的AliOssUtil对象的upload方法进行文件上传，并返回文件的请求路径
AliOssUtil类用来实现upload方法进行文件上传功能，实现的前提是已获取到四个属性的值
剩下的AliOssProperties类和OssConfiguration类是用来创建AliOssUtil对象（将其四个属性赋值）并将其交给ioc容器（以便在CommonController中可以直接依赖注入）