EntityResolver

public interface EntityResolver

Known Indirect Subclasses DefaultHandler, DefaultHandler2, EntityResolver2, HandlerBase, XMLFilterImpl DefaultHandler SAX2事件处理程序的默认基类。 DefaultHandler2 此类扩展SAX2基本处理程序类，以支持SAX2 LexicalHandler ， DeclHandler ，并 EntityResolver2扩展。 EntityResolver2 扩展接口，用于将外部实体引用映射到输入源或提供缺少的外部子集。 HandlerBase 此类已在API级别1中弃用。此类可与已弃用的DocumentHandler接口配合使用。 它已被SAX2 DefaultHandler类取代。 XMLFilterImpl 用于派生XML过滤器的基类。

用于解析实体的基本界面。

This module, both source code and documentation, is in the Public Domain, and comes with NO WARRANTY. See http://www.saxproject.org for further information.

如果SAX应用程序需要为外部实体实施自定义处理，则必须实现此接口并使用 setEntityResolver方法向SAX驱动程序注册实例。

然后，XML阅读器将允许应用程序在包含它们之前拦截任何外部实体（包括外部DTD子集和外部参数实体，如果有的话）。

许多SAX应用程序不需要实现此接口，但对于从数据库或其他专用输入源构建XML文档的应用程序或使用非URL的URI类型的应用程序来说，它尤其有用。

以下解析程序将为系统标识符为“http://www.myhost.com/today”的实体提供特殊字符流的应用程序：

 import org.xml.sax.EntityResolver;
 import org.xml.sax.InputSource;

 public class MyResolver implements EntityResolver {
   public InputSource resolveEntity (String publicId, String systemId)
   {
     if (systemId.equals("http://www.myhost.com/today")) {
              // return a special input source
       MyReader reader = new MyReader();
       return new InputSource(reader);
     } else {
              // use the default behaviour
       return null;
     }
   }
 }
 

应用程序还可以使用此接口将系统标识符重定向到本地URI或在目录中查找替换（可能通过使用公共标识符）。

Summary

Public methods

InputSource resolveEntity (String publicId, 
                String systemId)