Oracle® XML Java API Reference
Release 1 (10.1)

B12024-01

oracle.xml.parser.v2
Class XMLTokenizer

java.lang.Object
  |
  +--org.xml.sax.HandlerBase
        |
        +--oracle.xml.parser.v2.DefaultXMLDocumentHandler
              |
              +--oracle.xml.parser.v2.XMLTokenizer
All Implemented Interfaces:
DocumentHandler, DTDHandler, EntityResolver, ErrorHandler, XMLDocumentHandler

public class XMLTokenizer
extends DefaultXMLDocumentHandler

This class implements an eXtensible Markup Language (XML) 1.0 parser according to the World Wide Web Consortium (W3C) recommendation.


Constructor Summary
XMLTokenizer()
          Creates a new Tokenizer object.
XMLTokenizer(XMLToken handler)
          Creates a new Tokenizer object.

 

Method Summary
 void parseDocument()
          Parses an XML Document
 void setErrorHandler(ErrorHandler handler)
          Applications can use this to register a new error event handler.
 void setErrorStream(java.io.OutputStream out)
          Register a output stream for errors
 void setToken(int token, boolean val)
          Applications can use this to register a new token for XML tokenizer.
 void setTokenHandler(XMLToken handler)
          Applications can use this to register a new XML tokenizer event handler.
 void tokenize(InputSource in)
          Tokenizes the XML from given input source
 void tokenize(java.io.InputStream in)
          Tokenizes the XML from given input stream.
 void tokenize(java.io.Reader r)
          Tokenizes the XML from given input stream.
 void tokenize(java.lang.String in)
          Tokenizes the XML from the URL indicated
 void tokenize(java.net.URL url)
          Tokenizes the XML document pointed to by the given URL and creates the corresponding XML document hierarchy.

 

Methods inherited from class oracle.xml.parser.v2.DefaultXMLDocumentHandler
cDATASection, comment, endDoctype, endElement, endElement, endPrefixMapping, getHandler, setDoctype, setError, setHandler, setTextDecl, setXMLDecl, setXMLSchema, skippedEntity, startElement, startElement, startPrefixMapping

 

Methods inherited from class org.xml.sax.HandlerBase
characters, endDocument, endElement, error, fatalError, ignorableWhitespace, notationDecl, processingInstruction, resolveEntity, setDocumentLocator, startDocument, startElement, unparsedEntityDecl, warning

 

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

Methods inherited from interface org.xml.sax.DocumentHandler
characters, endDocument, endElement, ignorableWhitespace, processingInstruction, setDocumentLocator, startDocument, startElement

 

Constructor Detail

XMLTokenizer

public XMLTokenizer()
Creates a new Tokenizer object.

XMLTokenizer

public XMLTokenizer(XMLToken handler)
Creates a new Tokenizer object.
Method Detail

setErrorStream

public void setErrorStream(java.io.OutputStream out)
Register a output stream for errors

setErrorHandler

public void setErrorHandler(ErrorHandler handler)
Applications can use this to register a new error event handler. This replaces any previous setting for error handling.
Parameters:
handler - ErrorHandler being registered

tokenize

public final void tokenize(java.net.URL url)
                    throws XMLParseException,
SAXException,
                           java.io.IOException
Tokenizes the XML document pointed to by the given URL and creates the corresponding XML document hierarchy.
Parameters:
url - the url points to the XML document to parse.
Throws:
XMLParseException - if syntax or other error encountered.
SAXException - Any SAX exception, possibly wrapping another exception.
java.io.IOException - IO Error.

tokenize

public final void tokenize(InputSource in)
                    throws XMLParseException,
SAXException,
                           java.io.IOException
Tokenizes the XML from given input source
Parameters:
in - the org.xml.sax.InputSouce to parse
Throws:
XMLParseException - if syntax or other error encountered.
SAXException - Any SAX exception, possibly wrapping another exception.
java.io.IOException - IO Error.

tokenize

public final void tokenize(java.lang.String in)
                    throws XMLParseException,
SAXException,
                           java.io.IOException
Tokenizes the XML from the URL indicated
Parameters:
in - the String containing the URL to parse from
Throws:
XMLParseException - if syntax or other error encountered.
SAXException - Any SAX exception, possibly wrapping another exception.
java.io.IOException - IO Error.

tokenize

public final void tokenize(java.io.InputStream in)
                    throws XMLParseException,
SAXException,
                           java.io.IOException
Tokenizes the XML from given input stream.
Parameters:
in - the InputStream containing XML data to parse.
Throws:
XMLParseException - if syntax or other error encountered.
SAXException - Any SAX exception, possibly wrapping another exception.
java.io.IOException - IO Error.
See Also:
XMLParser.setBaseURL(java.net.URL)

tokenize

public final void tokenize(java.io.Reader r)
                    throws XMLParseException,
SAXException,
                           java.io.IOException
Tokenizes the XML from given input stream.
Parameters:
r - the Reader containing XML data to parse.
Throws:
XMLParseException - if syntax or other error encountered.
SAXException - Any SAX exception, possibly wrapping another exception.
java.io.IOException - IO Error.
See Also:
XMLParser.setBaseURL(java.net.URL)

setTokenHandler

public void setTokenHandler(XMLToken handler)
Applications can use this to register a new XML tokenizer event handler.
Parameters:
handler - XMLToken being registered

setToken

public void setToken(int token,
                     boolean val)
Applications can use this to register a new token for XML tokenizer.
Parameters:
token - XMLToken being set

parseDocument

public void parseDocument()
                   throws SAXException,
                          java.io.IOException
Parses an XML Document
Throws:
SAXException - Any SAX Exception, possibly wrapping another exception.
java.io.IOException - IO Error.

Oracle® XML Java API Reference
Release 1 (10.1)

B12024-01

Copyright © 2003, Oracle. All Rights Reserved.