Class DOMParser

    • Field Detail

      • USE_ENTITY_RESOLVER2

        protected static final String USE_ENTITY_RESOLVER2
        Feature identifier: EntityResolver2.
        See Also:
        Constant Field Values
      • XMLGRAMMAR_POOL

        protected static final String XMLGRAMMAR_POOL
        Property identifier: XML grammar pool.
        See Also:
        Constant Field Values
      • fUseEntityResolver2

        protected boolean fUseEntityResolver2
        Use EntityResolver2.
    • Constructor Detail

      • DOMParser

        public DOMParser​(XMLParserConfiguration config)
        Constructs a DOM parser using the specified parser configuration.
      • DOMParser

        public DOMParser()
        Constructs a DOM parser using the dtd/xml schema parser configuration.
      • DOMParser

        public DOMParser​(SymbolTable symbolTable)
        Constructs a DOM parser using the specified symbol table.
      • DOMParser

        public DOMParser​(SymbolTable symbolTable,
                         XMLGrammarPool grammarPool)
        Constructs a DOM parser using the specified symbol table and grammar pool.
    • Method Detail

      • parse

        public void parse​(String systemId)
                   throws SAXException,
                          IOException
        Parses the input source specified by the given system identifier.

        This method is equivalent to the following:

             parse(new InputSource(systemId));
         
        Parameters:
        systemId - The system identifier (URI).
        Throws:
        SAXException - Throws exception on SAX error.
        IOException - Throws exception on i/o error.
      • setEntityResolver

        public void setEntityResolver​(EntityResolver resolver)
        Sets the resolver used to resolve external entities. The EntityResolver interface supports resolution of public and system identifiers.
        Parameters:
        resolver - The new entity resolver. Passing a null value will uninstall the currently installed resolver.
      • setErrorHandler

        public void setErrorHandler​(ErrorHandler errorHandler)
        Allow an application to register an error event handler.

        If the application does not register an error handler, all error events reported by the SAX parser will be silently ignored; however, normal processing may not continue. It is highly recommended that all SAX applications implement an error handler to avoid unexpected bugs.

        Applications may register a new or different handler in the middle of a parse, and the SAX parser must begin using the new handler immediately.

        Parameters:
        errorHandler - The error handler.
        Throws:
        NullPointerException - If the handler argument is null.
        See Also:
        getErrorHandler()
      • setFeature

        public void setFeature​(String featureId,
                               boolean state)
                        throws SAXNotRecognizedException,
                               SAXNotSupportedException
        Set the state of any feature in a SAX2 parser. The parser might not recognize the feature, and if it does recognize it, it might not be able to fulfill the request.
        Parameters:
        featureId - The unique identifier (URI) of the feature.
        state - The requested state of the feature (true or false).
        Throws:
        SAXNotRecognizedException - If the requested feature is not known.
        SAXNotSupportedException - If the requested feature is known, but the requested state is not supported.
      • getFeature

        public boolean getFeature​(String featureId)
                           throws SAXNotRecognizedException,
                                  SAXNotSupportedException
        Query the state of a feature. Query the current state of any feature in a SAX2 parser. The parser might not recognize the feature.
        Parameters:
        featureId - The unique identifier (URI) of the feature being set.
        Returns:
        The current state of the feature.
        Throws:
        SAXNotRecognizedException - If the requested feature is not known.
        SAXNotSupportedException - If the requested feature is known but not supported.
      • setProperty

        public void setProperty​(String propertyId,
                                Object value)
                         throws SAXNotRecognizedException,
                                SAXNotSupportedException
        Set the value of any property in a SAX2 parser. The parser might not recognize the property, and if it does recognize it, it might not support the requested value.
        Parameters:
        propertyId - The unique identifier (URI) of the property being set.
        value - The value to which the property is being set.
        Throws:
        SAXNotRecognizedException - If the requested property is not known.
        SAXNotSupportedException - If the requested property is known, but the requested value is not supported.
      • getXMLParserConfiguration

        public XMLParserConfiguration getXMLParserConfiguration()
        Returns this parser's XMLParserConfiguration.