Interface XMLGrammarLoader


  • public interface XMLGrammarLoader
    The intention of this interface is to provide a generic means by which Grammar objects may be created without parsing instance documents. Implementations of this interface will know how to load specific types of grammars (e.g., DTD's or schemas); a wrapper will be provided for user applications to interact with these implementations.
    Version:
    $Id: XMLGrammarLoader.java 699892 2008-09-28 21:08:27Z mrglavas $
    Author:
    Neil Graham, IBM
    • Method Detail

      • getRecognizedFeatures

        java.lang.String[] getRecognizedFeatures()
        Returns a list of feature identifiers that are recognized by this XMLGrammarLoader. This method may return null if no features are recognized.
      • setFeature

        void setFeature​(java.lang.String featureId,
                        boolean state)
                 throws XMLConfigurationException
        Sets the state of a feature.
        Parameters:
        featureId - The feature identifier.
        state - The state of the feature.
        Throws:
        XMLConfigurationException - Thrown when a feature is not recognized or cannot be set.
      • getRecognizedProperties

        java.lang.String[] getRecognizedProperties()
        Returns a list of property identifiers that are recognized by this XMLGrammarLoader. This method may return null if no properties are recognized.
      • getProperty

        java.lang.Object getProperty​(java.lang.String propertyId)
                              throws XMLConfigurationException
        Returns the state of a property.
        Parameters:
        propertyId - The property identifier.
        Throws:
        XMLConfigurationException - Thrown on configuration error.
      • setProperty

        void setProperty​(java.lang.String propertyId,
                         java.lang.Object state)
                  throws XMLConfigurationException
        Sets the state of a property.
        Parameters:
        propertyId - The property identifier.
        state - The state of the property.
        Throws:
        XMLConfigurationException - Thrown when a property is not recognized or cannot be set.
      • setLocale

        void setLocale​(java.util.Locale locale)
        Set the locale to use for messages.
        Parameters:
        locale - The locale object to use for localization of messages.
        Throws:
        XNIException - Thrown if the parser does not support the specified locale.
      • getLocale

        java.util.Locale getLocale()
        Return the Locale the XMLGrammarLoader is using.
      • setErrorHandler

        void setErrorHandler​(XMLErrorHandler errorHandler)
        Sets the error handler.
        Parameters:
        errorHandler - The error handler.
      • getErrorHandler

        XMLErrorHandler getErrorHandler()
        Returns the registered error handler.
      • setEntityResolver

        void setEntityResolver​(XMLEntityResolver entityResolver)
        Sets the entity resolver.
        Parameters:
        entityResolver - The new entity resolver.
      • getEntityResolver

        XMLEntityResolver getEntityResolver()
        Returns the registered entity resolver.
      • loadGrammar

        Grammar loadGrammar​(XMLInputSource source)
                     throws java.io.IOException,
                            XNIException
        Returns a Grammar object by parsing the contents of the entity pointed to by source.
        Parameters:
        source - the location of the entity which forms the starting point of the grammar to be constructed.
        Throws:
        java.io.IOException - When a problem is encountered reading the entity XNIException When a condition arises (such as a FatalError) that requires parsing of the entity be terminated.
        XNIException