如何解决JRadioButtonMenuItem监听器通用方法的作用域问题？

问题背景 #

Java匿名内部类引用外部局部变量时，要求变量必须是final或有效final（初始化后不再修改）。直接封装通用方法时，因为要修改传入的属性变量，会触发编译错误，只能重复编写监听器代码。

可行但重复的代码示例 #

monochromeOption.addActionListener(new ActionListener() {
    public void actionPerformed(ActionEvent e) {
        gameboard.monochromeColor = cO;
        gameboard.monochromeColor_temp = cO;
        gameboard.repaint();
    }
});
monochromeOption.addMouseListener(new MouseListener() {
    public void mouseClicked(MouseEvent e) {}
    public void mousePressed(MouseEvent e) {}
    public void mouseReleased(MouseEvent e) {}

    @Override
    public void mouseEntered(MouseEvent e) {
        gameboard.monochromeColor_temp = gameboard.monochromeColor;
        gameboard.monochromeColor = cO;
        gameboard.repaint();
    }

    @Override
    public void mouseExited(MouseEvent e) {
        gameboard.monochromeColor = gameboard.monochromeColor_temp;
        gameboard.repaint();
    }
});

尝试封装但失败的代码示例 #

private static <T> void addRadioListenersWithMouseOver(NerdChessGameboard board, JRadioButtonMenuItem button, T toAssign, T gameboardT, T gameboardT_temp) {
    button.addActionListener(new ActionListener() {
        public void actionPerformed(ActionEvent e) {
            gameboardT = toAssign;
            gameboardT_temp = toAssign;
            board.repaint();
        }
    });
    button.addMouseListener(new MouseListener() {
        public void mouseClicked(MouseEvent e) {}
        public void mousePressed(MouseEvent e) {}
        public void mouseReleased(MouseEvent e) {}

        @Override
        public void mouseEntered(MouseEvent e) {
            gameboardT_temp = gameboardT;
            gameboardT = toAssign;
            board.repaint();
        }

        @Override
        public void mouseExited(MouseEvent e) {
            gameboardT = gameboardT_temp;
            board.repaint();
        }
    });
}

替代解决方案 #

无需重复编写代码，以下几种方式可规避作用域限制：

1. 用包装类传递可变值 #

Java是值传递，用简单包装类包裹需要修改的变量，让包装类本身成为有效final，内部修改包装类的属性值：

// 通用包装类
private static class Wrapper<T> {
    T value;
    Wrapper(T value) {
        this.value = value;
    }
}

// 封装后的通用方法
private static <T> void addRadioListenersWithMouseOver(NerdChessGameboard board, JRadioButtonMenuItem button, T toAssign, Wrapper<T> gameboardT, Wrapper<T> gameboardT_temp) {
    button.addActionListener(new ActionListener() {
        public void actionPerformed(ActionEvent e) {
            gameboardT.value = toAssign;
            gameboardT_temp.value = toAssign;
            board.repaint();
        }
    });
    // 用MouseAdapter简化空方法实现
    button.addMouseListener(new MouseAdapter() {
        @Override
        public void mouseEntered(MouseEvent e) {
            gameboardT_temp.value = gameboardT.value;
            gameboardT.value = toAssign;
            board.repaint();
        }

        @Override
        public void mouseExited(MouseEvent e) {
            gameboardT.value = gameboardT_temp.value;
            board.repaint();
        }
    });
}

// 调用方式
addRadioListenersWithMouseOver(gameboard, monochromeOption, cO, 
    new Wrapper<>(gameboard.monochromeColor), 
    new Wrapper<>(gameboard.monochromeColor_temp));

2. 封装属性读写逻辑为函数式接口 #

把属性的读写逻辑抽象成函数式接口，避免直接传递变量：

// 定义属性读写接口
@FunctionalInterface
private interface PropertyAccessor<T> {
    T get();
    void set(T value);
}

// 封装后的通用方法
private static <T> void addRadioListenersWithMouseOver(NerdChessGameboard board, JRadioButtonMenuItem button, T toAssign, PropertyAccessor<T> mainProp, PropertyAccessor<T> tempProp) {
    button.addActionListener(e -> {
        mainProp.set(toAssign);
        tempProp.set(toAssign);
        board.repaint();
    });
    button.addMouseListener(new MouseAdapter() {
        @Override
        public void mouseEntered(MouseEvent e) {
            tempProp.set(mainProp.get());
            mainProp.set(toAssign);
            board.repaint();
        }

        @Override
        public void mouseExited(MouseEvent e) {
            mainProp.set(tempProp.get());
            board.repaint();
        }
    });
}

// 调用方式
addRadioListenersWithMouseOver(gameboard, monochromeOption, cO,
    () -> gameboard.monochromeColor, val -> gameboard.monochromeColor = val,
    () -> gameboard.monochromeColor_temp, val -> gameboard.monochromeColor_temp = val);

3. 将逻辑封装到Gameboard类（推荐） #

遵循面向对象封装原则，把颜色切换逻辑放到NerdChessGameboard内部，暴露方法供外部调用：

// 在NerdChessGameboard类中添加方法
public void setMonochromeColor(Color color) {
    this.monochromeColor = color;
    this.monochromeColor_temp = color;
    repaint();
}

public void previewMonochromeColor(Color color) {
    this.monochromeColor_temp = this.monochromeColor;
    this.monochromeColor = color;
    repaint();
}

public void cancelPreviewMonochromeColor() {
    this.monochromeColor = this.monochromeColor_temp;
    repaint();
}

// 外部封装监听器方法
private void addColorPreviewListener(JRadioButtonMenuItem button, Color color) {
    button.addActionListener(e -> gameboard.setMonochromeColor(color));
    button.addMouseListener(new MouseAdapter() {
        @Override
        public void mouseEntered(MouseEvent e) {
            gameboard.previewMonochromeColor(color);
        }

        @Override
        public void mouseExited(MouseEvent e) {
            gameboard.cancelPreviewMonochromeColor();
        }
    });
}

// 最终调用只需一行
addColorPreviewListener(monochromeOption, cO);

总结 #

Java开发者无需靠重复代码规避该问题，通过包装类、函数式接口、封装业务逻辑等方式，既能解决匿名内部类的作用域限制，又能让代码更简洁易维护。

内容的提问来源于stack exchange，提问作者Lapid Palid