解决SonarQube父类方法中“未使用参数”警告的策略与设计模式

// 父类方法
protected void doSomething(Object firstParameter, Object secondParameter) {
    // 仅使用了 firstParameter 的逻辑
    System.out.println("Parent processing first parameter: " + firstParameter);
    // secondParameter 在父类中未使用
}

// 部分子类方法
@Override
protected void doSomething(Object firstParameter, Object secondParameter) {
    super.doSomething(firstParameter, secondParameter);
    // 额外使用了 secondParameter 的逻辑
    System.out.println("Child processing second parameter: " + secondParameter);
}

// 参数对象
class DoSomethingContext {
    private Object firstParameter;
    private Object secondParameter;

    public DoSomethingContext(Object firstParameter, Object secondParameter) {
        this.firstParameter = firstParameter;
        this.secondParameter = secondParameter;
    }

    public Object getFirstParameter() {
        return firstParameter;
    }

    public Object getSecondParameter() {
        return secondParameter;
    }
}

// 父类方法使用参数对象
protected void doSomething(DoSomethingContext context) {
    System.out.println("Parent processing first parameter: " + context.getFirstParameter());
    // SonarQube 将不再报告 secondParameter 未使用，因为它被封装在 context 对象中
    // 并且父类可以选择性地访问 context 中的任何参数
}

// 子类方法使用参数对象
@Override
protected void doSomething(DoSomethingContext context) {
    super.doSomething(context);
    if (context.getSecondParameter() != null) {
        System.out.println("Child processing second parameter: " + context.getSecondParameter());
    }
}

// 抽象父类
abstract class Parent {
    protected void doSomething(Object firstParameter, Object secondParameter) {
        // 通用逻辑，使用 firstParameter
        System.out.println("Parent processing first parameter: " + firstParameter);
        // 将 secondParameter 的处理委托给一个抽象方法
        // SonarQube 不会警告 secondParameter 未使用，因为它被传递给了另一个方法
        doSomethingElse(secondParameter);
    }

    // 抽象方法，子类必须实现
    // 这个方法负责处理 secondParameter
    protected abstract void doSomethingElse(Object secondParameter);
}

// 不需要额外处理 secondParameter 的子类
abstract class DoNothingElse extends Parent {
    @Override
    protected void doSomethingElse(Object secondParameter) {
        // 什么也不做，或者提供一个默认的空实现
        // 确保 SonarQube 不会在此处报告 secondParameter 未使用
    }
}

// 需要额外处理 secondParameter 的子类
class ChildThatDoesSomethingElse extends Parent {
    @Override
    protected void doSomethingElse(Object secondParameter) {
        // 在这里使用 secondParameter
        System.out.println("Child processing second parameter: " + secondParameter);
    }
}

// 另一个不需要额外处理 secondParameter 的子类，继承自 DoNothingElse
class ChildThatDoesNothingElse extends DoNothingElse {
    // 无需重写 doSomethingElse，因为它已经由 DoNothingElse 提供了空实现
}