oracle.ifs.beans.parsers
Interface XmlParserInterface

All Known Implementing Classes:

LiteralDocumentParser, IfsSimpleXmlParser

public interface XmlParserInterface

An XmlParserInterface is implemented by content-specific XML parsers that want to use the iFS XML parser framework. A parser application would invoke IfsXmlParser, which in turn would select the appropriate content-specific XML parser.

See Also:

IfsXmlParser

Method Summary

LibraryObject

parse(IfsXmlParser ifsxmlparser, java.io.InputStream stream, ParserCallback callback, java.util.Hashtable options) Parses the specified InputStream representing an XML document.

Method Detail

parse

public LibraryObject parse(IfsXmlParser ifsxmlparser,
                           java.io.InputStream stream,
                           ParserCallback callback,
                           java.util.Hashtable options)
                    throws IfsException

Parses the specified InputStream representing an XML document.

Parameters:

ifsxmlparser - this object is the entry point parser and can be used by the content-specific parsers to construct the DOM object, using the Oracle DOM parser

stream - the InputStream

callback - an application object that interacts with the the parsing process; optional, can be null

options - any parser-specific options

Returns:

The primary object created. If there is only one top level object then this is returned. If no object is "primary" then null is returned.

Throws:

IfsException - (IFS-12601) if the operation fails