JEditorPaneHTMLEditorKitParserMethodNonSealed非密封

wen java案例 2026-07-16 1

本文目录导读：

背景
为什么需要 non-sealed？
常见的编码场景
如何查看具体声明？
常见问题

您提到的是 Java Swing 中 JEditorPane 与 HTMLEditorKit 在处理 HTML 解析时涉及的一个技术细节：Parser 内部类的 non-sealed 修饰符。

这通常与 Java 17+ 的密封类（Sealed Classes） 特性有关。HTMLEditorKit 的内部 Parser 类被设计为 non-sealed，从而允许开发者创建自定义解析器，同时保持类层次结构的可控性。

背景

在 Java 17 中引入了密封类（sealed）与非密封类（non-sealed）的概念，密封类限制哪些子类可以继承它；而 non-sealed 则表示：即使父类是密封的，这个子类重新“开放”继承权限，允许未知的类继承它。

javax.swing.text.html.HTMLEditorKit.Parser 是 HTMLEditorKit 的一个内部类，在较新的 JDK 实现中被标记为：

public non-sealed abstract class Parser {
    public abstract void parse(Reader r, HTMLEditorKit.ParserCallback cb, boolean ignoreCharSet) throws IOException;
}

注意：non-sealed 是相对于它的密封父类（可能是 Object 或它自己的抽象密封层级）而言的，在此场景中，Parser 本身是一个抽象类，但通过 non-sealed 让外部代码可以自由继承它。

为什么需要 `non-sealed`？

javax.swing.text.html.HTMLEditorKit.Parser 允许第三方实现自定义的 HTML 解析器，在 Java 17 之前，它只是一个普通的 abstract class，引入密封类后，如果不加 non-sealed，那么所有子类都必须显式许可，这会破坏 Swing 原有的扩展性设计。

JDK 设计者选择：

将 Parser 类声明为 non-sealed，恢复其被任意子类继承的能力。
同时保持它从父类（如某些密封接口或类）继承而来的密封约束，但通过 non-sealed 解除进一步的限制。

常见的编码场景

如果您的代码直接继承 HTMLEditorKit.Parser 或使用 JEditorPane 设置自定义解析器，您可能会遇到以下情况：

场景 1：自定义解析器

import javax.swing.text.html.HTMLEditorKit;
public class MyCustomParser extends HTMLEditorKit.Parser {
    @Override
    public void parse(Reader r, HTMLEditorKit.ParserCallback cb, boolean ignoreCharSet) throws IOException {
        // 实现自己的解析逻辑
    }
}

在 Java 17+ 中，因为 Parser 是 non-sealed，这段代码仍然可以编译并正常运行，不需要任何特殊权限声明。

场景 2：反射警告

如果您通过反射获取 Parser 的修饰符，可能会看到 ACC_NON_SEALED 标志（0x0010），这不是错误，只是表明该类标记为非密封。

如何查看具体声明？

您可以在 JDK 17+ 的源码中找到：

src/java.desktop/share/classes/javax/swing/text/html/HTMLEditorKit.java

大致结构如下：

public class HTMLEditorKit extends StyledEditorKit implements Accessible {
    // ...
    public abstract non-sealed static class Parser {
        public abstract void parse(Reader r, ParserCallback cb, boolean ignoreCharSet) throws IOException;
    }
    // ...
}

注意：不同 JDK 版本的修饰符可能不同，但从 JDK 17 起，为了兼容已存在的子类，Parser 被明确标记为 non-sealed。

常见问题

❓ 编译错误：“class is not allowed to extend sealed class”

如果您遇到类似错误,说明你试图继承的父类是密封的，但你没有在 permits 子句中列出，对于 Parser，因为它是 non-sealed，所以不会出现这个错误。

❓ 为什么我的自定义解析器不被 `JEditorPane` 使用？

即便 Parser 是非密封的，您还需要通过 HTMLEditorKit 设置自定义解析器：

HTMLEditorKit kit = new HTMLEditorKit() {
    @Override
    public Parser getParser() {
        return new MyCustomParser();
    }
};
JEditorPane editor = new JEditorPane();
editor.setEditorKit(kit);

概念	说明
`non-sealed`	Java 密封类特性的关键字，表示该类重新开放继承权限
`Parser` 类	`HTMLEditorKit` 的内部抽象类，用于解析 HTML
作用	允许开发者自定义解析器，不影响现有的 Swing 扩展机制
注意 JDK 版本	在 JDK 17+ 中生效；较早 JDK 中不存在 `non-sealed` 关键字