## org.mortbay.xml
Class XmlParser

    java.lang.Object
      org.mortbay.xml.XmlParser

    public class XmlParser

extends Object

XML Parser wrapper. This class wraps any standard JAXP1.1 parser with convieniant error and entity handlers and a mini dom-like document tree.

By default, the parser is created as a validating parser only if xerces is present. This can be configured by setting the "org.mortbay.xml.XmlParser.Validating" system property.

Author:
  Greg Wilkins (gregw)

Nested Class Summary
`static class` `XmlParser.Attribute` XML Attribute.
`static class` `XmlParser.Node` XML Node.

Constructor Summary
`XmlParser()` Construct
`XmlParser(boolean validating)` Constructor.

Method Summary
`void` `addContentHandler(String trigger, ContentHandler observer)` Add a ContentHandler.
`String` `getDTD()`
`String` `getXpath()`
`XmlParser.Node` `parse(File file)` Parse File.
`XmlParser.Node` `parse(InputSource source)`
`XmlParser.Node` `parse(InputStream in)` Parse InputStream.
`XmlParser.Node` `parse(String url)` Parse String URL.
`void` `redirectEntity(String name, URL entity)`
`void` `setValidating(boolean validating)`
`void` `setXpath(String xpath)` Set an XPath A very simple subset of xpath is supported to select a partial tree.

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

Constructor Detail

### XmlParser

    public XmlParser()

  Construct

### XmlParser

    public XmlParser(boolean validating)

  Constructor.

Method Detail

### setValidating

    public void setValidating(boolean validating)

### redirectEntity

    public void redirectEntity(String name,
                               URL entity)

  Parameters:
    `name` -
    `entity` -

### getXpath

    public String getXpath()

  Returns:
    Returns the xpath.

### setXpath

    public void setXpath(String xpath)

  Set an XPath A very simple subset of xpath is supported to select a partial tree. Currently only path like "/node1/nodeA | /node1/nodeB" are supported.

  Parameters:
    `xpath` - The xpath to set.

### getDTD

    public String getDTD()

### addContentHandler

    public void addContentHandler(String trigger,
                                  ContentHandler observer)

  Add a ContentHandler. Add an additional _content handler that is triggered on a tag name. SAX events are passed to the ContentHandler provided from a matching start element to the corresponding end element. Only a single _content handler can be registered against each tag.

  Parameters:
    `trigger` - Tag local or q name.
    `observer` - SAX ContentHandler

### parse

    public XmlParser.Node parse(InputSource source)
                         throws IOException,
                                SAXException

  Throws:
    `IOException`
    `SAXException`

### parse

    public XmlParser.Node parse(String url)
                         throws IOException,
                                SAXException

  Parse String URL.

  Throws:
    `IOException`
    `SAXException`

### parse

    public XmlParser.Node parse(File file)
                         throws IOException,
                                SAXException

  Parse File.

  Throws:
    `IOException`
    `SAXException`

### parse

    public XmlParser.Node parse(InputStream in)
                         throws IOException,
                                SAXException

  Parse InputStream.

  Throws:
    `IOException`
    `SAXException`

Copyright © 2007 Mort Bay Consulting. All Rights Reserved.