站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

类 org.xml.sax.SAXException 的使用 (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

JavaTM 2 Platform
Standard Ed. 5.0

类 org.xml.sax.SAXException
的使用

使用 SAXException 的软件包
javax.xml.parsers 提供允许处理 XML 文档的类。 
javax.xml.validation 此包提供了用于 XML 文档验证的 API。 
org.xml.sax 此包提供了核心 SAX API。 
org.xml.sax.ext 此包包含适合的 SAX 驱动程序不一定支持的 SAX2 设施的接口。 
org.xml.sax.helpers 此包包含“帮助器”类,其中包括对引导基于 SAX 的应用程序的支持。 
 

javax.xml.parsersSAXException 的使用
 

抛出 SAXExceptionjavax.xml.parsers 中的方法
abstract  Parser SAXParser.getParser()
          返回由此类的实现封装的 SAX 解析器。
abstract  XMLReader SAXParser.getXMLReader()
          返回由此类的实现封装的 XMLReader
abstract  SAXParser SAXParserFactory.newSAXParser()
          使用当前配置的工厂参数创建 SAXParser 的一个新实例。
 Document DocumentBuilder.parse(File f)
          将给定文件的内容解析为一个 XML 文档,并且返回一个新的 DOM Document 对象。
 void SAXParser.parse(File f, DefaultHandler dh)
          使用指定的 DefaultHandler 将指定文件的内容解析为 XML。
 void SAXParser.parse(File f, HandlerBase hb)
          使用指定的 HandlerBase 将指定文件的内容解析为 XML。
abstract  Document DocumentBuilder.parse(InputSource is)
          将给定输入源的内容解析为一个 XML 文档,并且返回一个新的 DOM Document 对象。
 void SAXParser.parse(InputSource is, DefaultHandler dh)
          使用指定的 DefaultHandler 将给定 InputSource 的内容解析为 XML。
 void SAXParser.parse(InputSource is, HandlerBase hb)
          使用指定的 HandlerBase 将给定 InputSource 的内容解析为 XML。
 Document DocumentBuilder.parse(InputStream is)
          将给定 InputStream 的内容解析为一个 XML 文档,并且返回一个新的 DOM Document 对象。
 void SAXParser.parse(InputStream is, DefaultHandler dh)
          使用指定的 DefaultHandler 将给定的 InputStream 实例的内容解析为 XML。
 void SAXParser.parse(InputStream is, DefaultHandler dh, String systemId)
          使用指定的 DefaultHandler 将给定的 InputStream 实例的内容解析为 XML。
 void SAXParser.parse(InputStream is, HandlerBase hb)
          使用指定的 HandlerBase 将给定的 InputStream 实例的内容解析为 XML。
 void SAXParser.parse(InputStream is, HandlerBase hb, String systemId)
          使用指定的 HandlerBase 将给定的 InputStream 实例的内容解析为 XML。
 Document DocumentBuilder.parse(InputStream is, String systemId)
          将给定 InputStream 的内容解析为一个 XML 文档,并且返回一个新的 DOM Document 对象。
 Document DocumentBuilder.parse(String uri)
          将给定 URI 的内容解析为一个 XML 文档,并且返回一个新的 DOM Document 对象。
 void SAXParser.parse(String uri, DefaultHandler dh)
          使用指定的 DefaultHandler 将给定统一资源标识符 (URI) 描述的内容解析为 XML。
 void SAXParser.parse(String uri, HandlerBase hb)
          使用指定的 HandlerBase 将给定统一资源标识符 (URI) 描述的内容解析为 XML。
 

javax.xml.validationSAXException 的使用
 

抛出 SAXExceptionjavax.xml.validation 中的方法
abstract  Schema SchemaFactory.newSchema()
          创建特殊的 Schema 对象。
 Schema SchemaFactory.newSchema(File schema)
          解析作为模式的指定 File 并以 Schema 的形式返回它。
 Schema SchemaFactory.newSchema(Source schema)
          解析作为模式的指定源并以模式形式返回它。
abstract  Schema SchemaFactory.newSchema(Source[] schemas)
          解析作为模式的指定源(或多个源),并以模式形式返回它。
 Schema SchemaFactory.newSchema(URL schema)
          解析作为模式的指定 URL 并以 Schema 形式返回它。
 void Validator.validate(Source source)
          验证指定的输入。
abstract  void Validator.validate(Source source, Result result)
          验证指定输入并将扩充的验证结果发送到指定输出。
 

org.xml.saxSAXException 的使用
 

org.xml.saxSAXException 的子类
 class SAXNotRecognizedException
          用于未识别的标识符的 Exception 类。
 class SAXNotSupportedException
          用于不被支持的操作的 Exception 类。
 class SAXParseException
          封装 XML 解析错误或警告。
 

抛出 SAXExceptionorg.xml.sax 中的方法
 void ContentHandler.characters(char[] ch, int start, int length)
          接收字符数据的通知。
 void DocumentHandler.characters(char[] ch, int start, int length)
          已过时。 接收字符数据的通知。
 void HandlerBase.characters(char[] ch, int start, int length)
          已过时。 接收元素内字符数据的通知。
 void ContentHandler.endDocument()
          接收文档的结尾的通知。
 void DocumentHandler.endDocument()
          已过时。 接收文档结束的通知。
 void HandlerBase.endDocument()
          已过时。 接收文档结束的通知。
 void DocumentHandler.endElement(String name)
          已过时。 接收元素结束的通知。
 void HandlerBase.endElement(String name)
          已过时。 接收元素结束的通知。
 void ContentHandler.endElement(String uri, String localName, String qName)
          接收元素结束的通知。
 void ContentHandler.endPrefixMapping(String prefix)
          结束前缀 URI 范围的映射。
 void ErrorHandler.error(SAXParseException exception)
          接收可恢复的错误的通知。
 void HandlerBase.error(SAXParseException e)
          已过时。 接收可恢复的解析器错误的通知。
 void ErrorHandler.fatalError(SAXParseException exception)
          接收不可恢复的错误的通知。
 void HandlerBase.fatalError(SAXParseException e)
          已过时。 报告严重的 XML 解析错误。
 void ContentHandler.ignorableWhitespace(char[] ch, int start, int length)
          接收元素内容中可忽略的空白的通知。
 void DocumentHandler.ignorableWhitespace(char[] ch, int start, int length)
          已过时。 接收元素内容中可忽略的空白的通知。
 void HandlerBase.ignorableWhitespace(char[] ch, int start, int length)
          已过时。 接收元素内容中可忽略的空白的通知。
 void DTDHandler.notationDecl(String name, String publicId, String systemId)
          接收注释声明事件的通知。
 void Parser.parse(InputSource source)
          已过时。 解析 XML 文档。
 void XMLReader.parse(InputSource input)
          解析 XML 文档。
 void Parser.parse(String systemId)
          已过时。 从系统标识符 (URI) 解析 XML 文档。
 void XMLReader.parse(String systemId)
          从系统标识符 (URI) 解析 XML 文档。
 void ContentHandler.processingInstruction(String target, String data)
          接收处理指令的通知。
 void DocumentHandler.processingInstruction(String target, String data)
          已过时。 接收处理指令的通知。
 void HandlerBase.processingInstruction(String target, String data)
          已过时。 接收处理指令的通知。
 InputSource EntityResolver.resolveEntity(String publicId, String systemId)
          允许应用程序解析外部实体。
 InputSource HandlerBase.resolveEntity(String publicId, String systemId)
          已过时。 解析外部实体。
 void Parser.setLocale(Locale locale)
          已过时。 允许应用程序请求错误和警告的环境。
 void ContentHandler.skippedEntity(String name)
          接收跳过的实体的通知。
 void ContentHandler.startDocument()
          接收文档的开始的通知。
 void DocumentHandler.startDocument()
          已过时。 接收文档的开始的通知。
 void HandlerBase.startDocument()
          已过时。 接收文档开始的通知。
 void DocumentHandler.startElement(String name, AttributeList atts)
          已过时。 接收元素开始的通知。
 void HandlerBase.startElement(String name, AttributeList attributes)
          已过时。 接收元素开始的通知。
 void ContentHandler.startElement(String uri, String localName, String qName, Attributes atts)
          接收元素开始的通知。
 void ContentHandler.startPrefixMapping(String prefix, String uri)
          开始前缀 URI 名称空间范围映射。
 void DTDHandler.unparsedEntityDecl(String name, String publicId, String systemId, String notationName)
          接收未解析的实体声明事件的通知。
 void ErrorHandler.warning(SAXParseException exception)
          接收警告的通知。
 void HandlerBase.warning(SAXParseException e)
          已过时。 接收解析器警告的通知。
 

org.xml.sax.extSAXException 的使用
 

抛出 SAXExceptionorg.xml.sax.ext 中的方法
 void DeclHandler.attributeDecl(String eName, String aName, String type, String mode, String value)
          报告属性类型声明。
 void DefaultHandler2.attributeDecl(String eName, String aName, String type, String mode, String value)
           
 void LexicalHandler.comment(char[] ch, int start, int length)
          报告文档的任何位置的 XML 注释。
 void DefaultHandler2.comment(char[] ch, int start, int length)
           
 void DeclHandler.elementDecl(String name, String model)
          报告元素类型声明。
 void DefaultHandler2.elementDecl(String name, String model)
           
 void LexicalHandler.endCDATA()
          报告 CDATA 节的结束。
 void DefaultHandler2.endCDATA()
           
 void LexicalHandler.endDTD()
          报告 DTD 声明的结束。
 void DefaultHandler2.endDTD()
           
 void LexicalHandler.endEntity(String name)
          报告实体的结束。
 void DefaultHandler2.endEntity(String name)
           
 void DeclHandler.externalEntityDecl(String name, String publicId, String systemId)
          报告解析的外部实体声明。
 void DefaultHandler2.externalEntityDecl(String name, String publicId, String systemId)
           
 InputSource EntityResolver2.getExternalSubset(String name, String baseURI)
          允许应用程序为不能显式定义外部子集的文档提供外部子集。
 InputSource DefaultHandler2.getExternalSubset(String name, String baseURI)
          告知解析器如果在文档文本中没有声明任何外部子集,则不应使用任何外部子集。
 void DeclHandler.internalEntityDecl(String name, String value)
          报告内部实体声明。
 void DefaultHandler2.internalEntityDecl(String name, String value)
           
 InputSource DefaultHandler2.resolveEntity(String publicId, String systemId)
          使用 null 实体名称和基 URI 调用 EntityResolver2.resolveEntity()
 InputSource EntityResolver2.resolveEntity(String name, String publicId, String baseURI, String systemId)
          允许应用程序把对外部实体的引用映射到输入源,或告知解析器它应使用常规 URI 解析。
 InputSource DefaultHandler2.resolveEntity(String name, String publicId, String baseURI, String systemId)
          告知解析器根据 baseURI 解析 systemId,并从产生的绝对 URI 读取实体文本。
 void LexicalHandler.startCDATA()
          报告 CDATA 节的开始。
 void DefaultHandler2.startCDATA()
           
 void LexicalHandler.startDTD(String name, String publicId, String systemId)
          报告 DTD 声明的开始(如果存在)。
 void DefaultHandler2.startDTD(String name, String publicId, String systemId)
           
 void LexicalHandler.startEntity(String name)
          报告一些内部和外部 XML 实体的开始。
 void DefaultHandler2.startEntity(String name)
           
 

org.xml.sax.helpersSAXException 的使用
 

抛出 SAXExceptionorg.xml.sax.helpers 中的方法
 void DefaultHandler.characters(char[] ch, int start, int length)
          接收元素中字符数据的通知。
 void XMLReaderAdapter.characters(char[] ch, int start, int length)
          适配 SAX2 字符事件。
 void XMLFilterImpl.characters(char[] ch, int start, int length)
          过滤一个字符数据事件。
 void ParserAdapter.characters(char[] ch, int start, int length)
          适配器实现方法;不调用。
static XMLReader XMLReaderFactory.createXMLReader()
          尝试从系统默认值创建一个 XMLReader。
static XMLReader XMLReaderFactory.createXMLReader(String className)
          尝试从类名称创建一个 XML 阅读器。
 void DefaultHandler.endDocument()
          接收文档结束的通知。
 void XMLReaderAdapter.endDocument()
          结束文档事件。
 void XMLFilterImpl.endDocument()
          过滤一个结束文档事件。
 void ParserAdapter.endDocument()
          适配器实现方法;不调用。
 void ParserAdapter.endElement(String qName)
          适配器实现方法;不调用。
 void DefaultHandler.endElement(String uri, String localName, String qName)
          接收元素结束的通知。
 void XMLReaderAdapter.endElement(String uri, String localName, String qName)
          适配 SAX2 结束元素事件。
 void XMLFilterImpl.endElement(String uri, String localName, String qName)
          过滤一个结束元素事件。
 void DefaultHandler.endPrefixMapping(String prefix)
          接收名称空间映射结束的通知。
 void XMLFilterImpl.endPrefixMapping(String prefix)
          过滤一个结束名称空间前缀映射事件。
 void DefaultHandler.error(SAXParseException e)
          接收可恢复的解析器错误的通知。
 void XMLFilterImpl.error(SAXParseException e)
          过滤一个错误事件。
 void DefaultHandler.fatalError(SAXParseException e)
          报告严重的 XML 解析错误。
 void XMLFilterImpl.fatalError(SAXParseException e)
          过滤一个严重的错误事件。
 void DefaultHandler.ignorableWhitespace(char[] ch, int start, int length)
          接收元素内容中可忽略空白的通知。
 void XMLReaderAdapter.ignorableWhitespace(char[] ch, int start, int length)
          适配 SAX2 忽略空白事件。
 void XMLFilterImpl.ignorableWhitespace(char[] ch, int start, int length)
          过滤一个可忽略空格的事件。
 void ParserAdapter.ignorableWhitespace(char[] ch, int start, int length)
          适配器实现方法;不调用。
 void DefaultHandler.notationDecl(String name, String publicId, String systemId)
          接收注释声明的通知。
 void XMLFilterImpl.notationDecl(String name, String publicId, String systemId)
          过滤一个注释声明事件。
 void XMLReaderAdapter.parse(InputSource input)
          解析文档。
 void XMLFilterImpl.parse(InputSource input)
          解析一个文档。
 void ParserAdapter.parse(InputSource input)
          解析 XML 文档。
 void XMLReaderAdapter.parse(String systemId)
          解析文档。
 void XMLFilterImpl.parse(String systemId)
          解析一个文档。
 void ParserAdapter.parse(String systemId)
          解析 XML 文档。
 void DefaultHandler.processingInstruction(String target, String data)
          接收处理指令的通知。
 void XMLReaderAdapter.processingInstruction(String target, String data)
          适配 SAX2 处理指令事件。
 void XMLFilterImpl.processingInstruction(String target, String data)
          过滤一个处理指令事件。
 void ParserAdapter.processingInstruction(String target, String data)
          适配器实现方法;不调用。
 InputSource DefaultHandler.resolveEntity(String publicId, String systemId)
          解析外部实体。
 InputSource XMLFilterImpl.resolveEntity(String publicId, String systemId)
          过滤一个外部实体解析。
 void XMLReaderAdapter.setLocale(Locale locale)
          设置错误报告的语言环境。
 void DefaultHandler.skippedEntity(String name)
          接收跳过的实体的通知。
 void XMLReaderAdapter.skippedEntity(String name)
          适配 SAX2 跳过的实体事件。
 void XMLFilterImpl.skippedEntity(String name)
          过滤一个跳过的实体事件。
 void DefaultHandler.startDocument()
          接收文档开始的通知。
 void XMLReaderAdapter.startDocument()
          开始文档事件。
 void XMLFilterImpl.startDocument()
          过滤一个开始文档事件。
 void ParserAdapter.startDocument()
          适配器实现方法;不调用。
 void ParserAdapter.startElement(String qName, AttributeList qAtts)
          适配器实现方法;不调用。
 void DefaultHandler.startElement(String uri, String localName, String qName, Attributes attributes)
          接收元素开始的通知。
 void XMLReaderAdapter.startElement(String uri, String localName, String qName, Attributes atts)
          适配 SAX2 开始元素事件。
 void XMLFilterImpl.startElement(String uri, String localName, String qName, Attributes atts)
          过滤一个开始元素事件。
 void DefaultHandler.startPrefixMapping(String prefix, String uri)
          接收名称空间映射开始的通知。
 void XMLFilterImpl.startPrefixMapping(String prefix, String uri)
          过滤一个开始名称空间前缀映射事件。
 void DefaultHandler.unparsedEntityDecl(String name, String publicId, String systemId, String notationName)
          接收未解析实体声明的通知。
 void XMLFilterImpl.unparsedEntityDecl(String name, String publicId, String systemId, String notationName)
          过滤一个未解析实体声明事件。
 void DefaultHandler.warning(SAXParseException e)
          接收解析器警告的通知。
 void XMLFilterImpl.warning(SAXParseException e)
          过滤一个警告事件。
 

抛出 SAXExceptionorg.xml.sax.helpers 中的构造方法
ParserAdapter()
          构造一个新解析器适配器。
XMLReaderAdapter()
          创建一个新的适配器。
 


JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策