EntityResolver2

getExternalSubset

InputSource getExternalSubset (String name, 
                String baseURI)

允许应用程序为未明确定义文档的文档提供外部子集。 具有省略外部子集的DOCTYPE声明的文档因此可以增加可用于验证，实体处理和属性处理（标准化，默认和包括ID的报告类型）的声明。 通过startDTD()方法报告此增强，就好像文档文本最初包含外部子集一样; 此回调在任何内部子集数据或错误报告之前进行。

此方法也可以用于没有DOCTYPE声明的文档。 遇到根元素但未见DOCTYPE声明时，将调用此方法。 如果它为外部子集返回一个值，则将该根元素声明为根元素，从而在文档的序言末尾处拼接DOCTYPE声明的效果，否则该文档不会有效。 在这种情况下，解析器回调的顺序在逻辑上类似于以下内容：

 ... comments and PIs from the prolog (as usual)
 startDTD ("rootName", source.getPublicId (), source.getSystemId ());
 startEntity ("[dtd]");
 ... declarations, comments, and PIs from the external subset
 endEntity ("[dtd]");
 endDTD ();
 ... then the rest of the document (as usual)
 startElement (..., "rootName", ...);
 

请注意，InputSource不会得到进一步的解决方案。 该方法的实现可能希望调用resolveEntity()以获得诸如使用DTD实体的本地缓存之类的益处。 此外，此方法将永远不会被不包含外部参数实体的（非验证）处理器使用。

此方法的用途包括在与XML处理器互操作时促进数据验证，这些处理器始终要求对外部实体进行不良网络访问，或者出于其他原因采用“无DTD”策略。 非验证动机包括强制文档包含DTD，以便始终如一地处理属性。 例如，XPath处理器需要知道哪些属性具有类型“ID”，才能处理广泛使用的引用类型。

警告：返回外部子集会修改输入文档。 通过为一般实体提供定义，它可以使格式错误的文档看起来形成良好。

resolveEntity

InputSource resolveEntity (String name, 
                String publicId, 
                String baseURI, 
                String systemId)

允许应用程序将对外部实体的引用映射到输入源，或者告诉解析器它应该使用传统的URI解析。 此方法仅适用于已正确声明的外部实体。 这种方法比EntityResolver接口提供了更多的灵活性，支持更复杂的目录方案的实现，如OASIS XML Catalogs规范定义的目录方案。

配置为使用此解析器方法的解析器将调用它来确定由于XML文本中的引用而包含的任何外部实体使用的输入源。 这不包括文档实体和由getExternalSubset()返回的任何外部实体。 当（非验证）处理器通过使用特征标志被配置为不包括一类实体（参数或一般）时，不会为这些实体调用此方法。

请注意，此处使用的实体命名方案与 LexicalHandler或 ContentHandler.skippedEntity()方法中使用的实体命名方案相同。