Entity、DTO、VO
Entity(实体)
DTO(数据传输对象)
- 作用:DTO 是用于在不同层之间传输数据的对象,通常用于网络传输或服务间调用。DTO 主要用于减少网络请求的次数,携带数据而不包含业务逻辑。
- 特点:DTO类通常只包含数据字段和相应的getter和setter方法,不包含任何业务逻辑。它们可能包含与Entity类相似的字段,但也可能根据需要进行裁剪或扩展。
VO(视图对象)
- 位置:虽然VO这个术语不如DTO和Entity那样普遍,但在一些项目中,你可能会看到vo包用于存放视图对象。
- 作用:VO主要用于封装返回给前端的数据。它们可以被视为DTO的一种特殊形式,专门用于视图层的数据展示。VO可以根据前端的需求进行定制,包含前端需要展示的所有数据,以及可能的前端逻辑(如格式化数据)。
- 特点:VO类与DTO类似,主要关注数据的封装和传输,但更侧重于前端展示的需求。它们可能包含与Entity或DTO不同的字段,或者对字段进行不同的封装和格式化。
举例
对于数据库中的employee表:
java">@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;}
java">@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、反射
一、创建枚举类
java">/*** 数据库操作类型* 枚举类*/
public enum OperationType {/*** 更新操作*/UPDATE,/*** 插入操作*/INSERT}
二、创建自定义注解类
java">/*** 自定义注解,用于标识某个方法需要进行功能字段自动填充处理* 这个类可以作为一个注解进行使用*/
@Target(ElementType.METHOD)//指定当前的自定义注解只能加在方法上
@Retention(RetentionPolicy.RUNTIME)//固定写法
public @interface AutoFill {//数据库操作类型:UPDATE INSERT(只有增加和修改操作涉及公共字段填充)OperationType value();
}
三、在切入点方法上加入自定义注解,并指定其属性(更新操作/插入操作)
四、创建切面类,在切面类中实现通知逻辑
java">/*** 自定义切面类,实现公共字段自动填充处理逻辑*/
@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类
java">@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方法,实现文件上传功能,此方法返回文件的访问路径
java">@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类中方法的返回值)
java">@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类型响应给前端
java">@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中可以直接依赖注入)