利用 Java 反射机制提高 SpringBoot 的代码质量
👉 这是一个或许对你有用的社群
🐱 一对一交流/面试小册/简历优化/求职解惑,欢迎加入「芋道快速开发平台」知识星球。下面是星球提供的部分资料:
《项目实战(视频)》:从书中学,往事上“练” 《互联网高频面试题》:面朝简历学习,春暖花开 《架构 x 系统设计》:摧枯拉朽,掌控面试高频场景题 《精进 Java 学习指南》:系统学习,互联网主流技术栈 《必读 Java 源码专栏》:知其然,知其所以然
👉这是一个或许对你有用的开源项目
国产 Star 破 10w+ 的开源项目,前端包括管理后台 + 微信小程序,后端支持单体和微服务架构。
功能涵盖 RBAC 权限、SaaS 多租户、数据权限、商城、支付、工作流、大屏报表、微信公众号、CRM 等等功能:
Boot 仓库:https://gitee.com/zhijiantianya/ruoyi-vue-pro Cloud 仓库:https://gitee.com/zhijiantianya/yudao-cloud 视频教程:https://doc.iocoder.cn 【国内首批】支持 JDK 21 + SpringBoot 3.2.2、JDK 8 + Spring Boot 2.7.18 双版本
代码质量的重要性 Spring Boot 项目中的痛点问题 使用 Java 反射来提高质量 Demo 第 1 步:创建 NamingConventionValidator 第 2 步:创建 ClassScanner 实用程序 第 3 步:使用 NamingConventionValidator 第 4 步:运行应用程序 Java 反射对提升代码质量的好处 结论
保持好的代码质量和遵守编码标准是开发可维护和健壮软件的重要方面。在 Spring Boot 应用程序中,确保始终遵循命名约定、代码结构和其他质量标准是一项艰巨的任务,尤其是当项目的复杂性和规模不断扩大时更是如此。
“
在本文中,我们将探讨如何使用 Java 反射来提高 Spring Boot 应用程序的代码质量和可维护性。
代码质量的重要性
代码质量不仅仅是个人喜好的问题;它直接影响项目的可维护性、可扩展性和健壮性。代码质量的一致性对于基于团队的开发至关重要,因为它可以促进协作、减少混乱,并使得随着时间的推移更容易管理和发展代码库。
基于 Spring Boot + MyBatis Plus + Vue & Element 实现的后台管理系统 + 用户小程序,支持 RBAC 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能
项目地址:https://github.com/YunaiV/ruoyi-vue-pro 视频教程:https://doc.iocoder.cn/video/
Spring Boot 项目中的痛点问题
Spring Boot 以其强大的功能和灵活性,使开发人员能够构建广泛的应用程序。然而,Spring Boot 极具吸引力的灵活性也可能导致代码质量不一致。开发人员可能会无意中偏离既定的命名约定、项目结构和编码标准。
基于 Spring Cloud Alibaba + Gateway + Nacos + RocketMQ + Vue & Element 实现的后台管理系统 + 用户小程序,支持 RBAC 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能
项目地址:https://github.com/YunaiV/yudao-cloud 视频教程:https://doc.iocoder.cn/video/
使用 Java 反射来提高质量
为了解决这些代码质量带来的风险,我们可以利用 Java强大的反射功能来扫描和验证我们的代码库。Java 反射允许我们在运行时检查和操作类、方法、字段和其他代码元素。我们可以使用它来强制命名约定、验证方法签名并确保遵守编码标准。
Demo
让我们深入研究一个实际示例,了解如何利用 Java 反射来提高 Spring Boot 应用程序中的代码质量:
第 1 步:创建 NamingConventionValidator
在您的 Spring Boot 项目中,创建一个NamingConventionValidator
类。此类将包含使用 Java 反射进行命名约定验证的逻辑。
import jackynote.pro.utils.ClassScanner;
import lombok.extern.log4j.Log4j2;
import org.springframework.stereotype.Component;
import java.lang.reflect.Method;
import java.util.regex.Pattern;
@Log4j2
@Component
public class NamingConventionValidator {
/**
* Some examples of valid class names:
*
* com.example.MyClass
* MyClass
* _MyClass
* $SomeClass
* Some invalid examples:
*
* 1MyClass (can't start with number)
* My Class (no spaces allowed)
*/
private static final Pattern CLASS_NAME_PATTERN = Pattern.compile("([a-zA-Z_$][a-zA-Z\d_$]*\.)*[a-zA-Z_$][a-zA-Z\d_$]*");
/**
* The regex used checks:
*
* Must start with a lowercase letter
* Can contain letters, numbers, underscores after first character
* Some examples of valid method names:
*
* getUser
* calculateTotal
* _processData
* Some invalid examples:
*
* 1calculate (can't start with number)
* GetUser (must start lowercase)
* Some best practices for method name validation:
*
* Start with lowercase letter
* Use camelCase notation
* No spaces or special characters besides _
* Use verb or verb phrase names for methods
* Use nouns for getters and setters
* Avoid overly long names
*/
private static final Pattern METHOD_NAME_PATTERN = Pattern.compile("[a-z][a-zA-Z0-9_]*");
public void validateNamingConventions(String basePackage) {
log.info("Execute validateNamingConventions");
String[] classNames = ClassScanner.getClassesInPackage(basePackage);
for (String className: classNames) {
if (!CLASS_NAME_PATTERN.matcher(className).matches()) {
throw new NamingConventionViolationException("Class name violation: " + className);
}
Class<?> clazz;
try {
clazz = Class.forName(className);
Method[] methods = clazz.getDeclaredMethods();
for (Method method : methods) {
System.out.print(method.getName());
if (!METHOD_NAME_PATTERN.matcher(method.getName()).matches()) {
throw new NamingConventionViolationException("Method name violation in class " + className + ": " + method.getName());
}
}
} catch (ClassNotFoundException e) {
e.printStackTrace();
}
}
}
}
第 2 步:创建 ClassScanner 实用程序
您需要一个实用程序类ClassScanner
来扫描指定包中的类。该类使用 Spring 的类路径扫描来查找类。
import org.springframework.beans.factory.config.BeanDefinition;
import org.springframework.context.annotation.ClassPathScanningCandidateComponentProvider;
import org.springframework.core.type.filter.AssignableTypeFilter;
import java.util.ArrayList;
import java.util.List;
import java.util.Set;
public class ClassScanner {
public static String[] getClassesInPackage(String basePackage) {
List<String> classNames = new ArrayList<>();
ClassPathScanningCandidateComponentProvider scanner = new ClassPathScanningCandidateComponentProvider(false);
scanner.addIncludeFilter(new AssignableTypeFilter(Object.class));
Set<BeanDefinition> components = scanner.findCandidateComponents(basePackage);
for (BeanDefinition bd : components) {
classNames.add(bd.getBeanClassName());
}
return classNames.toArray(new String[0]);
}
}
第 3 步:使用 NamingConventionValidator
在 Spring Boot 应用程序的主类中NamingConventionValidator
从 Spring 应用程序上下文获取 bean。然后,调用validateNamingConventions
指定基础包的方法。
import jackynote.pro.config.NamingConventionValidator;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.ConfigurableApplicationContext;
@SpringBootApplication
public class MainApplication {
public static void main(String... args) {
ConfigurableApplicationContext context = SpringApplication.run(MainApplication.class, args);
NamingConventionValidator validator = context.getBean(NamingConventionValidator.class);
String basePackage = "jackynote.pro"; // Specify your base package here
validator.validateNamingConventions(basePackage);
}
}
第 4 步:运行应用程序
创建ProductService.java
以检查验证器是否正常工作:
import org.springframework.stereotype.Service;
@Service
public class ProductService {
public ProductService() { }
// TODO - try with method name is not good
public void AddProduct() {
}
}
当您运行 Spring Boot 应用程序时,它将NamingConventionValidator
扫描您的代码库,验证类和方法的命名约定,并将任何违规情况打印到控制台。
Exception in thread "main" jackynote.pro.config.NamingConventionViolationException: Method name violation in class jackynote.pro.service.ProductService: AddProduct
at jackynote.pro.config.NamingConventionValidator.validateNamingConventions(NamingConventionValidator.java:69)
at jackynote.pro.MainApplication.main(MainApplication.java:15)
Java 反射对提升代码质量的好处
一致性: 自动化确保命名约定和编码标准得到一致遵循,从而减少代码库中的混乱。 早期检测: 一旦提交代码,就会检测到违反命名约定的行为,从而防止问题累积并变得更难以解决。 提高代码质量: 强制命名约定提高了代码的可读性和可维护性,使代码更容易理解和修改。 减少手动工作: 自动化减少了强制命名约定所需的手动工作,使开发人员能够专注于更关键的任务。
结论
在 Spring Boot 项目中,维护代码质量对于保证项目的可维护性和可扩展性至关重要。Java 反射提供了一个强大的工具,通过自动命名约定验证和遵守编码标准来提高代码质量。
通过使用NamingConventionValidator
和 类扫描技术,您可以提高代码库的质量并促进开发团队内部的协作。使用 Java 反射自动执行代码质量检查是确保 Spring Boot 应用程序在发展过程中保持干净和一致的实用方法。
欢迎加入我的知识星球,全面提升技术能力。
👉 加入方式,“长按”或“扫描”下方二维码噢:
星球的内容包括:项目实战、面试招聘、源码解析、学习路线。
文章有帮助的话,在看,转发吧。
谢谢支持哟 (*^__^*)
微信扫码关注该文公众号作者