ContentHandler

characters

void characters (char[] ch, 
                int start, 
                int length)

接收字符数据的通知。

解析器将调用此方法来报告每个字符数据块。 SAX解析器可能会将所有连续的字符数据返回到单个块中，或者它们可能会将其分割为多个块; 但是，任何单个事件中的所有字符必须来自相同的外部实体，以便定位器提供有用的信息。

应用程序不能尝试从指定范围之外的数组读取数据。

单个字符可能包含多个Java char值。 发生这种情况有两种重要的情况，因为字符不能用十六位表示。 在一种情况下，字符在代理对中表示，使用两个特殊的Unicode值。 这些字符位于所谓的“星体飞机”中，代码点高于U + FFFF。 第二种情况涉及复合字符，例如与一个或多个重音字符组合的基本字符。

你的代码不应该假定使用char - char -a-time成语的算法将以字符单位工作; 在某些情况下，他们会分割字符。 在XML允许任意字符（如属性值，处理指令数据和注释）以及从该方法报告的数据中，这是相关的。 每当Java代码操纵国际化文本时，它也通常相关; 这个问题不是XML所特有的。

请注意，一些解析器将使用 ignorableWhitespace方法而不是这个方法报告元素内容中的空白（验证解析器 必须这样做）。

endDocument

void endDocument ()

接收文档结束的通知。

该方法的文档与fatalError(SAXParseException)的文档之间存在明显的矛盾。 在未来的主要版本中解决这个歧义之前，客户端应该不会假设在解析器报告fatalError（）或引发异常时endDocument（）是否会被调用。

SAX解析器只会调用一次该方法，它将是解析过程中调用的最后一个方法。 解析器不应该调用此方法，直到它放弃解析（由于错误不可恢复）或到达输入的结尾。

endElement

void endElement (String uri, 
                String localName, 
                String qName)

接收元素结束的通知。

SAX解析器将在XML文档中的每个元素的末尾调用此方法; 每个endElement事件都会有相应的startElement事件（即使元素为空）。

有关名称的信息，请参阅startElement。

endPrefixMapping

void endPrefixMapping (String prefix)

结束前缀-URI映射的范围。

详情请参阅startPrefixMapping 。 这些事件将会立即发生，相应的后endElement事件，但顺序endPrefixMapping事件是不是另有保证。

ignorableWhitespace

void ignorableWhitespace (char[] ch, 
                int start, 
                int length)

接收元素内容中可忽略空白的通知。

验证解析器必须使用此方法报告元素内容中的每个空白块（请参阅W3C XML 1.0建议的第2.10节）：如果非验证解析器能够解析和使用内容模型，则也可以使用此方法。

SAX解析器可能会将单个块中的所有连续空白值返回，或者可能会将其分割为多个块; 但是，任何单个事件中的所有字符必须来自相同的外部实体，以便定位器提供有用的信息。

应用程序不能尝试从指定范围之外的数组读取数据。

processingInstruction

void processingInstruction (String target, 
                String data)

接收处理指令的通知。

解析器将为找到的每个处理指令调用一次该方法：请注意，处理指令可能发生在主文档元素之前或之后。

SAX解析器不得使用此方法报告XML声明（XML 1.0，第2.8节）或文本声明（XML 1.0，第4.3.1节）。

像 characters()一样，处理指令数据可能具有需要多个 char值的字符。

setDocumentLocator

void setDocumentLocator (Locator locator)

接收一个对象以查找SAX文档事件的来源。

SAX解析器强烈建议（尽管不是绝对必需）提供定位器：如果这样做，它必须在调用ContentHandler接口中的任何其他方法之前通过调用此方法将定位器提供给应用程序。

定位器允许应用程序确定任何文档相关事件的结束位置，即使解析器未报告错误。 通常情况下，应用程序将使用此信息报告自己的错误（例如与应用程序业务规则不匹配的字符内容）。 由定位器返回的信息可能不足以用于搜索引擎。

请注意，只有在调用SAX事件回调期间， startDocument返回之后和endDocument之前，定位器才会返回正确的信息。 应用程序不应该尝试在任何其他时间使用它。

skippedEntity

void skippedEntity (String name)

接收跳过实体的通知。 这不是为标记结构中的实体引用调用的，例如元素开始标记或标记声明。 （XML建议要求报告跳过的外部实体，除标记结构内外，SAX还报告内部实体扩展/非扩展。）

每次实体被跳过时，解析器都会调用这个方法。 未验证的处理器可能会在实体没有看到声明时跳过实体（例如，因为实体是在外部DTD子集中声明的）。 所有处理器可能跳过外部实体，具体取决于http://xml.org/sax/features/external-general-entities和http://xml.org/sax/features/external-parameter-entities属性的值。

startDocument

void startDocument ()

接收文档开始的通知。

SAX解析器只会在任何其他事件回调（ setDocumentLocator除外）之前调用此方法一次。

startElement

void startElement (String uri, 
                String localName, 
                String qName, 
                Attributes atts)

接收元素开始的通知。

解析器将在XML文档的每个元素的开始处调用此方法; 每个startElement事件都会有相应的endElement事件（即使元素为空）。 所有元素的内容将依次在相应的endElement事件之前报告。

此事件允许每个元素最多包含三个名称组件：

1. the Namespace URI;
2. the local name; and
3. the qualified (prefixed) name.

根据 http://xml.org/sax/features/namespaces和 http://xml.org/sax/features/namespace-prefixes属性的值，可以提供任何或全部这些内容：

• the Namespace URI and local name are required when the namespaces property is true (the default), and are optional when the namespaces property is false (if one is specified, both must be);
• the qualified name is required when the namespace-prefixes property is true, and is optional when the namespace-prefixes property is false (the default).

请注意，提供的属性列表将仅包含具有显式值（指定或默认值）的属性：#IMPLIED属性将被省略。 仅当http://xml.org/sax/features/namespace-prefixes属性为true（默认情况下为false，并且对真值的支持为可选）时，属性列表将包含用于名称空间声明（xmlns *属性）的属性。

像 characters()一样，属性值可能具有需要多个 char值的字符。

startPrefixMapping

void startPrefixMapping (String prefix, 
                String uri)

开始前缀-URI命名空间映射的范围。

来自此事件的信息对于正常的命名空间处理不是必需的：当 http://xml.org/sax/features/namespaces功能为 真 （默认）时，SAX XML阅读器将自动替换元素和属性名称的前缀。

然而，有些情况下，当应用程序需要在字符数据或属性值中使用前缀时，它们无法安全地自动扩展; 如有必要，start / endPrefixMapping事件将信息提供给应用程序以在这些上下文中自行扩展前缀。

请注意，不保证start / endPrefixMapping事件相对于彼此正确嵌套：所有startPrefixMapping事件将紧接在相应的 startElement事件之前发生，并且所有 endPrefixMapping事件将紧接在相应的 endElement事件之后发生，但是它们的顺序没有另外的保证。

不应该有“xml”前缀的start / endPrefixMapping事件，因为它是预先声明且不可变的。