Java图形设计（四）

上一篇博客我们探讨 Java AWT 事件模型的工作机制，那么接下来探讨如何以更加结构化的方式处理动作（actions）事件。《Java核心技术》这本书已经给了详细的讨论，我们要做的就是像以前一样把它压缩、化简和提炼。

通常，激活一个命令可以有多种方式。用户可以通过菜单、击键或工具栏上的按钮选择特定的功能。在 AWT 事件模型中实现这些非常容易：将所有事件连接到同一个监听器上。例如，假设 blueAction 是一个动作监听器，它的 actionPerformed 方法可以将背景颜色改成蓝色。将一个监听器对象加到下面几个事件源上：

• 标记为 Blue 的工具栏按钮
• 标记为 Blue 的菜单项
• 按键 CTRL+B

然后，无论改变背景颜色的命令是通过哪种方式下达的，是点击按钮、菜单选择，还是按键，其处理都是一样的。

swing 包提供了一种非常实用的机制来封装命令，并将它们连接到多个事件源，这就是 Action 接口。一个动作是一个封装下列内容的对象：

• 命令的说明（一个文本字符串和一个可选图标）；
• 执行命令所需的参数（例如，在列举的例子中请求改变的颜色）。

Action 接口包含下列方法：

void actionPerformed(ActionEvent event)
void setEnabled(boolean b)
boolean isEnabled()
void putValue(String key, Object value)
Object getValue(String key)
void addPropertyChangeListener(PropertyChangeListener listener)
void removePropertyChangeListener(PropertyChangeListener listener)

第一个方法是 ActionListener 接口中很熟悉的一个：实际上，Action 接口扩展于 ActionListener 接口，因此，可以在任何需要 ActionListener 对象的地方使用 Action 对象。

接下来的两个方法允许启动或禁用这个动作，并检查这个动作当前是否启用。当一个连接到菜单或工具栏上的动作被禁用时，这个选项就会变成灰色。

putValue 和 getValue 方法允许存储和检索动作对象中的任意名/值。有两个重要的预定义字符串：Action.NAME 和 Action.SMALL_ICON，用于将动作的名字和图标存储到一个动作对象中：

action.putValue(Action.NAME, "Blue");
action.putValue(Action.SMALL_ICON, new ImageIcon("blue-ball.gif"));

下表给出了所有预定义的动作表名称。

名称	值
NAME	动作名称，显示在按钮和菜单上
SMALL_ICON	存储小图标的地方；显示在按钮、菜单栏和工具栏中
SHORT_DESCRIPTION	图标的简要说明；显示在工具提示中
LONG_DESCRIPTION	图标的详细说明；使用在在线帮助中。没有 Swing 组件使用这个值
MNEMONIC_KEY	快捷键缩写；显示在菜单项中。
ACCELERATOR_KEY	存储加速击键的地方；Swing 组件不使用这个值
ACTION_COMMAND_KEY	历史遗留；仅在旧版本的 registerKeyboardAction 方法中使用
DEFAULT	可能有用的综合属性；Swing 组件不使用这个值

如果动作对象添加到菜单或工具栏上，它的名称和图标就会被自动地提取出来，并显示在菜单项和工具栏项中。SHORT_DESCRIPTION 值变成了工具提示。

Action 接口的最后两个方法能够让其他对象在动作对象的属性发生变化时得到通告，尤其是菜单或工具栏出发的动作。例如，如果增加一个菜单，作为动作对象的属性变更监听器，而这个动作对象随后被禁用，菜单就会被调用，并将动作名称变为灰色。

需要注意，Action 是一个接口，而不是一个类。实现这个接口的所有类都必须实现刚才讨论的 7 个 方法。庆幸的是，有一个类实现了这个接口除 actionPerformed 方法之外的所有方法，它就是 AbstractAction 。这个类存储了所有名/值对，并管理着属性变更监听器。我们可以 直接扩展 AbstractAction 类，并在扩展类中实现 actionPerformed 方法。

下面构造一个用于执行改变颜色命令的动作对象。首先存储这个命令的名称、图标和需要的颜色。将颜色存储在 AbstractAction 类提供的名/值对表中。下面是 ColorAction 类的代码。构造器设置名/值对，而 actionPerformed 方法执行改变颜色的动作。

public class ColorAction extends AbstractAction{

    public ColorAction(String name, Icon icon, Color c) {
        putValue(Action.NAME, name);
        putValue(Action.SMALL_ICON,icon);
        putValue(Action.SHORT_DESCRIPTION,"Set panel color to " + name.toLowerCase());
        putValue("Color",c);
    }

    public void actionPerformend(ActionEvent event) {
        Color c = (Color)getValue("color");
        buttonPanel.setBackground(c);
    }
}

在测试程序中，创建了这个类的三个对象，如下所示：

Action blueAction = new ColorAction("Blue", new ImageIcon("blue-ball.gif"),Color.BLUE);

接下来，将这个动作与一个按钮关联起来。由于JButton 有一个用 Action 对象作为参数的构造器，所以实现这项操作很容易。

JButton blueButton = new JButton(blueAction);

构造器读取动作的名称和图标，为工具提示设置简要说明，将动作设置为监听器。

有关映射不想讨论了，贼鸡儿难，没完全看懂，更记不住。

下面总结一下用同一个动作响应按钮、菜单项或按键的方式：

1. 实现一个扩展于 AbstractAction 类的类。多个相关的动作可以使用同一个类。
2. 构造一个动作类对象。
3. 使用动作对象创建按钮或菜单项。构造器将从动作对象中读取标签文本和图标。
4. 为了能够通过按键触发动作，必须额外地执行几个步骤。首先定位顶层窗口组件，例如，包含所有其他组件的面板。
5. 然后，得到顶层组件的 WHEN_ANCESTOR_OF_FOCUS_COMPONENT 输入映射。为需要的按键创建一个 KeyStrike 对象。创建一个描述动作字符串这样的动作键对象。将（按键，动作键）对添加到输入映射中。

6. 随后，得到顶层组件的动作映射。将（动作键，动作对象）添加到映射中。

   下面程序给出了将按钮和按键映射到动作对象的完整代码。试试看，点击按钮或按下 CTRL+Y、CTRL+B或CTRL+R来改变面板颜色。

ActionFrame.java

package action;

import java.awt.*;
import java.awt.event.*;
import javax.swing.*;

public class ActionFrame extends JFrame{
    private JPanel buttonPanel;
    private static final int DEFAULT_WIDTH=300;
    private static final int DEFAULT_HEIGHT=200;

    public ActionFrame(){
        setSize(DEFAULT_WIDTH, DEFAULT_HEIGHT);
        buttonPanel=new JPanel();

        Action yellowAction=new ColorAction("Yellow", new ImageIcon("yellow.gif"), Color.YELLOW);
        Action blueAction=new ColorAction("Blue", new ImageIcon("blue.gif"), Color.BLUE);
        Action redAction=new ColorAction("Red", new ImageIcon("red.gif"), Color.RED);

        //用Action对象构造按钮，把动作和按钮关联起来
        buttonPanel.add(new JButton(yellowAction));
        buttonPanel.add(new JButton(blueAction));
        buttonPanel.add(new JButton(redAction));
        add(buttonPanel);

        //得到顶层组件的WHEN_ANCESTOR_OF_FOCUSED_COMPONENT输入映射
        InputMap imap=buttonPanel.getInputMap(JComponent.WHEN_ANCESTOR_OF_FOCUSED_COMPONENT);
        //将(按键，动作键)添加到输入映射中
        imap.put(KeyStroke.getKeyStroke("ctrl Y"), "panel.yellow");
        imap.put(KeyStroke.getKeyStroke("ctrl B"), "panel.bule");
        imap.put(KeyStroke.getKeyStroke("ctrl R"), "panel.red");

        //得到顶层组件的动作映射
        ActionMap amap=buttonPanel.getActionMap();
        //将(动作键，动作对象)添加到映射中
        amap.put("panel.yellow", yellowAction);
        amap.put("panel.blue", blueAction);
        amap.put("panel.red", redAction);
    }

    public class ColorAction extends AbstractAction{
        public ColorAction(String name,Icon icon,Color c){
            //存储命令的名称、图标、简要说明和需要的颜色
            putValue(Action.NAME, name);
            putValue(Action.SMALL_ICON, icon);
            putValue(Action.SHORT_DESCRIPTION, "Set panel color to "+name.toLowerCase());//显示在工具提示里
            putValue("color", c);
        }

        public void actionPerformed(ActionEvent arg0) {
            Color c=(Color) getValue("color");
            buttonPanel.setBackground(c);
        }

    }

}

ActionFrameTest.java

package action;

import java.awt.*;
import javax.swing.*;

public class ActionFrameTest {
    public static void main(String[] args) {
        EventQueue.invokeLater(() -> {
            JFrame frame = new ActionFrame();
            frame.setTitle("ActionFrame");
            frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
            frame.setVisible(true);
        });
    }

}

---