JEditorPaneHTMLEditorKitParserMethodCancelled取消键

wen java案例 2026-07-15 1

本文目录导读：

错误信息含义
常见触发原因及解决
完整示例（屏蔽 ESC 取消）
如果仍然出现

在 Java 的 JEditorPane 配合 HTMLEditorKit 解析 HTML 时，如果遇到 “取消键” 或 “ParserMethodCancelled” 相关错误或行为，通常是由以下几个原因引起的：

错误信息含义

ParserMethodCancelled 是 HTML 解析器在解析过程中被中断/取消时抛出的异常，常见场景：

用户按下 ESC 或取消按钮
解析过程中调用了 cancel() 方法
线程被中断 (Thread.interrupt())

常见触发原因及解决

✅ 原因1：用户按 ESC 键

默认情况下,JEditorPane 在加载 HTML 时，按 ESC 会取消解析。

解决方法：

JEditorPane editor = new JEditorPane();
editor.getKeymap().removeKeyStrokeBinding(
    KeyStroke.getKeyStroke(KeyEvent.VK_ESCAPE, 0));

✅ 原因2：页面加载过程中被中断

如果使用 setText() 或 setPage() 加载大 HTML 时，线程被中断。

解决方法：

try {
    editor.setPage(new URL("http://example.com"));
} catch (IOException e) {
    // 忽略中断相关异常，或检查是否为 ParserMethodCancelled
    if (!(e.getCause() instanceof javax.swing.text.html.parser.ParserDelegator.CancelledException)) {
        e.printStackTrace();
    }
}

✅ 原因3：手动调用了 `HTMLEditorKit.ParserCallback` 的取消

如果自定义解析时调用了取消方法。

解决方法：

检查代码中是否有 parser.parse(...) 被中断
不要在解析过程中调用 Thread.interrupt()

✅ 原因4：Swing 事件线程问题

在非 EDT（事件分发线程）中操作 JEditorPane。

解决方法：

SwingUtilities.invokeLater(() -> {
    editor.setText("<html>...</html>");
});

完整示例（屏蔽 ESC 取消）

import javax.swing.*;
import java.awt.event.KeyEvent;
public class SafeEditorPane extends JEditorPane {
    public SafeEditorPane() {
        super();
        // 移除 ESC 取消键绑定
        this.getKeymap().removeKeyStrokeBinding(
            KeyStroke.getKeyStroke(KeyEvent.VK_ESCAPE, 0));
    }
}

如果仍然出现

升级 Java 版本：旧版 Swing 解析器存在已知 bug
切换解析器：用 EditorKit 的 read 方法捕获异常
使用 JavaFX WebView 替代：更稳定的 HTML 渲染

// 异常捕获示例
try {
    editor.getEditorKit().read(
        new StringReader("<html>..."),
        editor.getDocument(),
        0);
} catch (Exception e) {
    if (e.getMessage() != null && e.getMessage().contains("Cancelled")) {
        System.out.println("解析被取消（可能是 ESC 或其他中断）");
    }
}

问题	解决方案
用户按 ESC 取消	移除 ESC 键绑定
线程中断	捕获 `CancelledException` 并忽略
非 EDT 操作	使用 `SwingUtilities.invokeLater()`
大文档卡死	使用 `SwingWorker` 后台加载