如何编写文档监听器

原文： https://docs.oracle.com/javase/tutorial/uiswing/events/documentlistener.html

Swing 文本组件使用 Document 来表示其内容。当文档内容以任何方式更改时，都会发生文档事件。您将文档监听器附加到文本组件的文档，而不是文本组件本身。有关详细信息，请参阅实现文档过滤器。

以下示例演示两个纯文本组件上的文档事件。

Try this:

1. 单击“启动”按钮以使用 Java™Web Start （下载 JDK 7 或更高版本）运行 DocumentEventDemo。或者，要自己编译并运行示例，请参考示例索引。

2. 键入窗口左上角的文本字段或文本字段下方的文本区域。 为每个键入的字符触发一个文档事件。

3. 使用退格键删除文本。 为每个键入的退格键触发一个文档事件。
4. 选择文本，然后通过键入退格键或使用CTRL-X（剪切）等键盘命令将其删除。 整个删除都会触发一个文档事件。
5. 使用CTRL-C（复制）和CTRL-V（粘贴）等键盘命令将文本从一个文本组件复制到另一个文本组件。 无论粘贴的文本长度如何，都会针对整个粘贴操作触发一个文档事件。如果在发出粘贴命令之前在目标文本组件中选择了文本，则会触发其他文档事件，因为首先删除所选文本。

您可以在 DocumentEventDemo.java 中找到演示代码。这是演示文档的事件处理代码：

public class DocumentEventDemo ... {
    ...//where initialization occurs:
    textField = new JTextField(20);
    textField.addActionListener(new MyTextActionListener());
    textField.getDocument().addDocumentListener(new MyDocumentListener());
    textField.getDocument().putProperty("name", "Text Field");
    textArea = new JTextArea();
    textArea.getDocument().addDocumentListener(new MyDocumentListener());
    textArea.getDocument().putProperty("name", "Text Area");
    ...
class MyDocumentListener implements DocumentListener {
    String newline = "\n";
    public void insertUpdate(DocumentEvent e) {
        updateLog(e, "inserted into");
    }
    public void removeUpdate(DocumentEvent e) {
        updateLog(e, "removed from");
    }
    public void changedUpdate(DocumentEvent e) {
        //Plain text components do not fire these events
    }
    public void updateLog(DocumentEvent e, String action) {
        Document doc = (Document)e.getDocument();
        int changeLength = e.getLength();
        displayArea.append(
            changeLength + " character" +
            ((changeLength == 1) ? " " : "s ") +
            action + doc.getProperty("name") + "." + newline +
            "  Text length = " + doc.getLength() + newline);
    }
}

文档监听器不应修改文档的内容;在收听者收到更改通知时，更改已完成。而是编写一个覆盖insertString或remove方法或两者的自定义文档。有关详细信息，请参阅聆听文档更改。

DocumentListener没有适配器类。

每个文档事件方法都传递一个实现DocumentEvent接口的对象。通常，这是 DefaultDocumentEvent 的实例，在AbstractDocument中定义。

使用文档监听器的示例

下表列出了使用文档监听器的示例。