Redian新闻
>
利用 Java 反射机制提高 SpringBoot 的代码质量

利用 Java 反射机制提高 SpringBoot 的代码质量

公众号新闻

👉 这是一个或许对你有用的社群

🐱 一对一交流/面试小册/简历优化/求职解惑,欢迎加入芋道快速开发平台知识星球。下面是星球提供的部分资料: 

👉这是一个或许对你有用的开源项目

国产 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 双版本 

来源:juejin.cn/post/
7293118779781955634


保持好的代码质量和遵守编码标准是开发可维护和健壮软件的重要方面。在 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.classargs);
        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.ProductServiceAddProduct
    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 应用程序在发展过程中保持干净和一致的实用方法。


欢迎加入我的知识星球,全面提升技术能力。

👉 加入方式,长按”或“扫描”下方二维码噢

星球的内容包括:项目实战、面试招聘、源码解析、学习路线。

文章有帮助的话,在看,转发吧。

谢谢支持哟 (*^__^*)

微信扫码关注该文公众号作者

戳这里提交新闻线索和高质量文章给我们。
相关阅读
湖南大学聂舟团队Angew |工程化Anti-CRISPR蛋白创建CRISPR-Cas蛋白开关用于激活型基因编辑和病毒蛋白酶检测SpringBoot接口添加IP白名单限制SpringBoot 中实现订单30分钟自动取消的策略[掌设] Macbook Air 15 m2 对比Thinkbook14+ 2024款8845h段永平经典分享:改正错误要尽快,多大的代价都是最小的代价SpringBoot 实现 RAS+AES 自动接口解密Stack Overflow 拿我的代码去训练 AI 大模型,还封了我的账号​拒绝写重复代码,试试这套开源的 SpringBoot 组件,效率翻倍~SpringBoot 容器镜像更新只要200k,你敢信???SpringBoot + Lua = 王炸!Off the Books: Inside the Struggle to Save China’s Preschools狗子偷吃减肥药,第二天化身喷射机拉得满屏马赛克…网友:就主人没瘦哈哈苹果真乃良心企业,消费者用8GB内存的价格,买到了12GB内存颗粒Nginx静态压缩和代码压缩,提高访问速度!《巴郞笔谈》008:水火饮食Spring Boot 干预优化+加快启动时间(干货典藏版)2024 款 LG gram 14 轻薄本开售:酷睿Ultra 5处理器 + 16GB + 512GB 售 6999 元SpringBoot+Redis+定时任务模拟手机短信验证神舟优雅 X5 笔记本开售:i9-12900H + 16GB RAM + 512GB 存储空间售 2999 元美股基本面 - 2024_03_24 * 晨报 * 美联储助攻点燃资金狂热,美股能否开启新行情。多家航司莫斯科线免费退改签 莫美女,老啦!为什么建议你替换掉 SpringBoot 框架中的 Tomcat ?spring是“春天”,chicken是“鸡”,那spring chicken什么意思?Spring Boot 3.2 和 Spring Framework 6.1添加对 Java 21、虚拟线程和 CRaC 的支持舒适化口腔治疗:笑—氧混合吸入在咽反射敏感患者中的应用70B模型秒出1000token,代码重写超越GPT-4o,来自OpenAI投资的代码神器Cursor团队如何通过内网穿透实现外部网络对 SpringBoot 接口的 HTTP 监听和调试?雷神 AIbook 15 轻薄本上架预约:OCuLink 接口、RGB 背光键盘、酷睿 Ultra7Stack Overflow拿我的代码去训练AI大模型,还封了我的账号​苹果真乃良心企业,消费者用 8GB 内存的价格,买到了 12GB 内存颗粒离奇!麻州房屋突发火灾 竟是被浴室镜子反射阳光引燃突然反悔了?哈佛大学、加州理工学院双双官宣,25Fall申请者「强制提交」标化!风骨回国杂记(2308)好人一生平安字节系多款 App 被指控抄袭源代码,连拼错的代码都抄走了?美摄回应:我们不是碰瓷,是在维权
logo
联系我们隐私协议©2024 redian.news
Redian新闻
Redian.news刊载任何文章,不代表同意其说法或描述,仅为提供更多信息,也不构成任何建议。文章信息的合法性及真实性由其作者负责,与Redian.news及其运营公司无关。欢迎投稿,如发现稿件侵权,或作者不愿在本网发表文章,请版权拥有者通知本网处理。