public final class XMLSchema11Factory
extends javax.xml.validation.SchemaFactory
SchemaFactory for XML Schema.| Constructor and Description | 
|---|
| XMLSchema11Factory() | 
| Modifier and Type | Method and Description | 
|---|---|
| org.xml.sax.ErrorHandler | getErrorHandler()Gets the current  ErrorHandlerset to thisSchemaFactory. | 
| boolean | getFeature(java.lang.String name)Look up the value of a feature flag. | 
| protected java.util.Locale | getLocale() | 
| java.lang.Object | getProperty(java.lang.String name)Look up the value of a property. | 
| org.w3c.dom.ls.LSResourceResolver | getResourceResolver()Gets the current  LSResourceResolverset to thisSchemaFactory. | 
| boolean | isSchemaLanguageSupported(java.lang.String schemaLanguage)Is specified schema supported by this  SchemaFactory? | 
| javax.xml.validation.Schema | newSchema()Creates a special  Schemaobject. | 
| javax.xml.validation.Schema | newSchema(javax.xml.transform.Source[] schemas)Parses the specified source(s) as a schema and returns it as a schema. | 
| javax.xml.validation.Schema | newSchema(org.apache.xerces.xni.grammars.XMLGrammarPool pool) | 
| void | setErrorHandler(org.xml.sax.ErrorHandler errorHandler)Sets the  ErrorHandlerto receive errors encountered
 during thenewSchemamethod invocation. | 
| void | setFeature(java.lang.String name,
          boolean value)Set the value of a feature flag. | 
| void | setProperty(java.lang.String name,
           java.lang.Object object)Set the value of a property. | 
| void | setResourceResolver(org.w3c.dom.ls.LSResourceResolver resourceResolver)Sets the  LSResourceResolverto customize
 resource resolution when parsing schemas. | 
public boolean isSchemaLanguageSupported(java.lang.String schemaLanguage)
javax.xml.validation.SchemaFactoryIs specified schema supported by this SchemaFactory?
isSchemaLanguageSupported in class javax.xml.validation.SchemaFactoryschemaLanguage - Specifies the schema language which the returned SchemaFactory will understand.
    schemaLanguage must specify a valid schema language.true if SchemaFactory supports schemaLanguage, else false.public org.w3c.dom.ls.LSResourceResolver getResourceResolver()
javax.xml.validation.SchemaFactoryLSResourceResolver set to this SchemaFactory.getResourceResolver in class javax.xml.validation.SchemaFactorySchemaFactory.setResourceResolver(LSResourceResolver) method, or null
      if that method has never been called since this SchemaFactory
      has created.SchemaFactory.setErrorHandler(ErrorHandler)public void setResourceResolver(org.w3c.dom.ls.LSResourceResolver resourceResolver)
javax.xml.validation.SchemaFactoryLSResourceResolver to customize
 resource resolution when parsing schemas.
 
 
 SchemaFactory uses a LSResourceResolver
 when it needs to locate external resources while parsing schemas,
 although exactly what constitutes "locating external resources" is
 up to each schema language. For example, for W3C XML Schema,
 this includes files <include>d or <import>ed,
 and DTD referenced from schema files, etc.
 
 
 Applications can call this method even during a Schema
 is being parsed. 
 
 
 When the LSResourceResolver is null, the implementation will
 behave as if the following LSResourceResolver is set:
 
class DumbDOMResourceResolver implementsLSResourceResolver{ publicLSInputresolveResource( String publicId, String systemId, String baseURI) { return null; // always return null } }
 If a LSResourceResolver throws a RuntimeException
  (or instances of its derived classes),
 then the SchemaFactory will abort the parsing and  
 the caller of the newSchema method will receive
 the same RuntimeException. 
 
 
 When a new SchemaFactory object is created, initially
 this field is set to null.  This field will NOT be
 inherited to Schemas, Validators, or 
 ValidatorHandlers that are created from this SchemaFactory.
setResourceResolver in class javax.xml.validation.SchemaFactoryresourceResolver - A new resource resolver to be set. This parameter can be null.public org.xml.sax.ErrorHandler getErrorHandler()
javax.xml.validation.SchemaFactoryErrorHandler set to this SchemaFactory.getErrorHandler in class javax.xml.validation.SchemaFactorySchemaFactory.setErrorHandler(ErrorHandler) method, or null
      if that method has never been called since this SchemaFactory
      has created.SchemaFactory.setErrorHandler(ErrorHandler)public void setErrorHandler(org.xml.sax.ErrorHandler errorHandler)
javax.xml.validation.SchemaFactoryErrorHandler to receive errors encountered
 during the newSchema method invocation.
 
 
 Error handler can be used to customize the error handling process
 during schema parsing. When an ErrorHandler is set,
 errors found during the parsing of schemas will be first sent
 to the ErrorHandler.
 
 
 The error handler can abort the parsing of a schema immediately
 by throwing SAXException from the handler. Or for example
 it can print an error to the screen and try to continue the
 processing by returning normally from the ErrorHandler 
 
 
 If any Throwable (or instances of its derived classes)
 is thrown from an ErrorHandler,
 the caller of the newSchema method will be thrown
 the same Throwable object.
 
 
 SchemaFactory is not allowed to
 throw SAXException without first reporting it to
 ErrorHandler.
 
 
 Applications can call this method even during a Schema
 is being parsed. 
 
 
 When the ErrorHandler is null, the implementation will
 behave as if the following ErrorHandler is set:
 
class DraconianErrorHandler implementsErrorHandler{ public void fatalError(SAXParseExceptione ) throwsSAXException{ throw e; } public void error(SAXParseExceptione ) throwsSAXException{ throw e; } public void warning(SAXParseExceptione ) throwsSAXException{ // noop } }
 When a new SchemaFactory object is created, initially
 this field is set to null. This field will NOT be
 inherited to Schemas, Validators, or 
 ValidatorHandlers that are created from this SchemaFactory.
setErrorHandler in class javax.xml.validation.SchemaFactoryerrorHandler - A new error handler to be set. This parameter can be null.public javax.xml.validation.Schema newSchema(javax.xml.transform.Source[] schemas)
                                      throws org.xml.sax.SAXException
javax.xml.validation.SchemaFactory
 The callee will read all the Sources and combine them into a
 single schema. The exact semantics of the combination depends on the schema
 language that this SchemaFactory object is created for.
 
 
 When an ErrorHandler is set, the callee will report all the errors
 found in sources to the handler. If the handler throws an exception, it will
 abort the schema compilation and the same exception will be thrown from
 this method. Also, after an error is reported to a handler, the callee is allowed
 to abort the further processing by throwing it. If an error handler is not set,
 the callee will throw the first error it finds in the sources.   
 
 
The resulting schema contains components from the specified sources. The same result would be achieved if all these sources were imported, using appropriate values for schemaLocation and namespace, into a single schema document with a different targetNamespace and no components of its own, if the import elements were given in the same order as the sources. Section 4.2.3 of the XML Schema recommendation describes the options processors have in this regard. While a processor should be consistent in its treatment of JAXP schema sources and XML Schema imports, the behaviour between JAXP-compliant parsers may vary; in particular, parsers may choose to ignore all but the first <import> for a given namespace, regardless of information provided in schemaLocation.
 If the parsed set of schemas includes error(s) as
 specified in the section 5.1 of the XML Schema spec, then
 the error must be reported to the ErrorHandler.
 
 
For RELAX NG, this method must throw UnsupportedOperationException
 if schemas.length!=1.
newSchema in class javax.xml.validation.SchemaFactoryschemas - inputs to be parsed. SchemaFactory is required
      to recognize StreamSource, 
      SAXSource,
      DOMSource
      and StAXSource.Schema object.
      Note that when an error has been reported, there is no
      guarantee that the returned Schema object is
      meaningful.org.xml.sax.SAXException - If an error is found during processing the specified inputs.
      When an ErrorHandler is set, errors are reported to
      there first. See SchemaFactory.setErrorHandler(ErrorHandler).public javax.xml.validation.Schema newSchema()
                                      throws org.xml.sax.SAXException
javax.xml.validation.SchemaFactorySchema object.
 
 
 The exact semantics of the returned Schema object depends
 on the schema language that this SchemaFactory is created
 for.
 
 
Also, implementations are allowed to use implementation-specific property/feature to alter the semantics of this method.
 For XML Schema, this method creates a Schema object that
 performs validation by using location hints specified in documents.
 
 
 The returned Schema object assumes that if documents
 refer to the same URL in the schema location hints,
 they will always resolve to the same schema document. This
 assumption allows implementations to reuse parsed results of
 schema documents so that multiple validations against the same
 schema will run faster.
 
 
Note that the use of schema location hints introduces a vulnerability to denial-of-service attacks.
RELAX NG does not support this operation.
newSchema in class javax.xml.validation.SchemaFactorySchema object.org.xml.sax.SAXException - If this operation is supported but failed for some reason.public javax.xml.validation.Schema newSchema(org.apache.xerces.xni.grammars.XMLGrammarPool pool)
                                      throws org.xml.sax.SAXException
org.xml.sax.SAXExceptionpublic boolean getFeature(java.lang.String name)
                   throws org.xml.sax.SAXNotRecognizedException,
                          org.xml.sax.SAXNotSupportedException
javax.xml.validation.SchemaFactoryThe feature name is any fully-qualified URI.  It is
 possible for a SchemaFactory to recognize a feature name but
 temporarily be unable to return its value.
 
Implementors are free (and encouraged) to invent their own features, using names built on their own URIs.
getFeature in class javax.xml.validation.SchemaFactoryname - The feature name, which is a non-null fully-qualified URI.org.xml.sax.SAXNotRecognizedException - If the feature
            value can't be assigned or retrieved.org.xml.sax.SAXNotSupportedException - When the
            SchemaFactory recognizes the feature name but 
            cannot determine its value at this time.SchemaFactory.setFeature(String, boolean)public java.lang.Object getProperty(java.lang.String name)
                             throws org.xml.sax.SAXNotRecognizedException,
                                    org.xml.sax.SAXNotSupportedException
javax.xml.validation.SchemaFactoryThe property name is any fully-qualified URI.  It is
 possible for a SchemaFactory to recognize a property name but
 temporarily be unable to return its value.
SchemaFactorys are not required to recognize any specific
 property names.
Implementors are free (and encouraged) to invent their own properties, using names built on their own URIs.
getProperty in class javax.xml.validation.SchemaFactoryname - The property name, which is a non-null fully-qualified URI.org.xml.sax.SAXNotRecognizedException - If the property
            value can't be assigned or retrieved.org.xml.sax.SAXNotSupportedException - When the
            XMLReader recognizes the property name but 
            cannot determine its value at this time.SchemaFactory.setProperty(String, Object)public void setFeature(java.lang.String name,
              boolean value)
                throws org.xml.sax.SAXNotRecognizedException,
                       org.xml.sax.SAXNotSupportedException
javax.xml.validation.SchemaFactory
 Feature can be used to control the way a SchemaFactory
 parses schemas, although SchemaFactorys are not required
 to recognize any specific feature names.
The feature name is any fully-qualified URI.  It is
 possible for a SchemaFactory to expose a feature value but
 to be unable to change the current value.
All implementations are required to support the XMLConstants.FEATURE_SECURE_PROCESSING feature.
 When the feature is:
true: the implementation will limit XML processing to conform to implementation limits.
     Examples include entity expansion limits and XML Schema constructs that would consume large amounts of resources.
     If XML processing is limited for security reasons, it will be reported via a call to the registered
     ErrorHandler.fatalError(SAXParseException exception).
     See SchemaFactory.setErrorHandler(ErrorHandler errorHandler).
   false: the implementation will processing XML according to the XML specifications without
     regard to possible implementation limits.
   setFeature in class javax.xml.validation.SchemaFactoryname - The feature name, which is a non-null fully-qualified URI.value - The requested value of the feature (true or false).org.xml.sax.SAXNotRecognizedException - If the feature
            value can't be assigned or retrieved.org.xml.sax.SAXNotSupportedException - When the
            SchemaFactory recognizes the feature name but 
            cannot set the requested value.SchemaFactory.getFeature(String)public void setProperty(java.lang.String name,
               java.lang.Object object)
                 throws org.xml.sax.SAXNotRecognizedException,
                        org.xml.sax.SAXNotSupportedException
javax.xml.validation.SchemaFactoryThe property name is any fully-qualified URI.  It is
 possible for a SchemaFactory to recognize a property name but
 to be unable to change the current value.
SchemaFactorys are not required to recognize setting
 any specific property names.
setProperty in class javax.xml.validation.SchemaFactoryname - The property name, which is a non-null fully-qualified URI.object - The requested value for the property.org.xml.sax.SAXNotRecognizedException - If the property
            value can't be assigned or retrieved.org.xml.sax.SAXNotSupportedException - When the
            SchemaFactory recognizes the property name but 
            cannot set the requested value.protected java.util.Locale getLocale()
Copyright © 1999-2022 The Apache Software Foundation. All Rights Reserved.