Package org.apache.commons.digester.parser

Class XercesParser

  • @Deprecated
public class XercesParser
extends java.lang.Object
    Deprecated.
    Create an XMLParser instance yourself, configure validation appropriately, and pass it as a parameter to the Digester constructor, or use Digester.setXMLSchema(javax.xml.validation.Schema) for validation.
    Create a SAXParser based on the underlying Xerces version. Currently, Xerces 2.3 and up doesn't implement schema validation the same way 2.1 was. In other to support schema validation in a portable way between parser, some features/properties need to be set.
    Since:
    1.6

    • Field Summary

      Fields 
      Modifier and Type Field Description
      protected static java.lang.String JAXP_SCHEMA_LANGUAGE
      Deprecated.
      The JAXP 1.2 property to set up the schemaLanguage used.
      private static java.lang.String JAXP_SCHEMA_SOURCE
      Deprecated.
      The JAXP 1.2 property required to set up the schema location.
      protected static org.apache.commons.logging.Log log
      Deprecated.
      The Log to which all SAX event related logging calls will be made.
      protected static float version
      Deprecated.
      A float representing the underlying Xerces version
      protected static java.lang.String versionNumber
      Deprecated.
      The current Xerces version.
      protected static java.lang.String XERCES_DYNAMIC
      Deprecated.
      Xerces dynamic validation property
      protected static java.lang.String XERCES_SCHEMA
      Deprecated.
      Xerces schema validation property

    • Constructor Summary

      Constructors 
      Constructor Description
      XercesParser()
      Deprecated.
       

    • Method Summary

      All Methods Static Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      private static void configureOldXerces​(javax.xml.parsers.SAXParser parser, java.util.Properties properties)
      Deprecated.
      Configure schema validation as recommended by the JAXP 1.2 spec.
      private static void configureXerces​(javax.xml.parsers.SAXParserFactory factory)
      Deprecated.
      Configure schema validation as recommended by the Xerces spec.
      private static java.lang.String getXercesVersion()
      Deprecated.
      Return the current Xerces version.
      static javax.xml.parsers.SAXParser newSAXParser​(java.util.Properties properties)
      Deprecated.
      Create a SAXParser based on the underlying Xerces version.

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Field Detail

      • log

        protected static org.apache.commons.logging.Log log
        Deprecated.
        The Log to which all SAX event related logging calls will be made.

      • JAXP_SCHEMA_SOURCE

        private static final java.lang.String JAXP_SCHEMA_SOURCE
        Deprecated.
        The JAXP 1.2 property required to set up the schema location.
        See Also:
        Constant Field Values

      • JAXP_SCHEMA_LANGUAGE

        protected static java.lang.String JAXP_SCHEMA_LANGUAGE
        Deprecated.
        The JAXP 1.2 property to set up the schemaLanguage used.

      • XERCES_DYNAMIC

        protected static java.lang.String XERCES_DYNAMIC
        Deprecated.
        Xerces dynamic validation property

      • XERCES_SCHEMA

        protected static java.lang.String XERCES_SCHEMA
        Deprecated.
        Xerces schema validation property

      • version

        protected static float version
        Deprecated.
        A float representing the underlying Xerces version

      • versionNumber

        protected static java.lang.String versionNumber
        Deprecated.
        The current Xerces version.

    • Constructor Detail

      • XercesParser

        public XercesParser()
        Deprecated.

    • Method Detail

      • getXercesVersion

        private static java.lang.String getXercesVersion()
        Deprecated.
        Return the current Xerces version.
        Returns:
        the current Xerces version.

      • newSAXParser

        public static javax.xml.parsers.SAXParser newSAXParser​(java.util.Properties properties)
                                                throws javax.xml.parsers.ParserConfigurationException,
                                                       org.xml.sax.SAXException,
                                                       org.xml.sax.SAXNotSupportedException
        Deprecated.
        Create a SAXParser based on the underlying Xerces version.
        Parameters:
        properties - parser specific properties/features
        Returns:
        an XML Schema/DTD enabled SAXParser
        Throws:
        javax.xml.parsers.ParserConfigurationException
        org.xml.sax.SAXException
        org.xml.sax.SAXNotSupportedException

      • configureOldXerces

        private static void configureOldXerces​(javax.xml.parsers.SAXParser parser,
                                       java.util.Properties properties)
                                throws javax.xml.parsers.ParserConfigurationException,
                                       org.xml.sax.SAXNotSupportedException
        Deprecated.
        Configure schema validation as recommended by the JAXP 1.2 spec. The properties object may contains information about the schema local and language.
        Parameters:
        properties - parser optional info
        Throws:
        javax.xml.parsers.ParserConfigurationException
        org.xml.sax.SAXNotSupportedException

      • configureXerces

        private static void configureXerces​(javax.xml.parsers.SAXParserFactory factory)
                             throws javax.xml.parsers.ParserConfigurationException,
                                    org.xml.sax.SAXNotRecognizedException,
                                    org.xml.sax.SAXNotSupportedException
        Deprecated.
        Configure schema validation as recommended by the Xerces spec. Both DTD and Schema validation will be enabled simultaneously.

        NOTE: This method is broken. It is supposed to set up validation against the schema specified in property "schemaLocation", but it doesn't.

        Parameters:
        factory - SAXParserFactory to be configured
        Throws:
        javax.xml.parsers.ParserConfigurationException
        org.xml.sax.SAXNotRecognizedException
        org.xml.sax.SAXNotSupportedException