类 XmlBeanDefinitionReader

字段详细资料

• VALIDATION_NONE

  public static final int VALIDATION_NONE

  Indicates that the validation should be disabled.

  另请参阅:

  常量字段值

• VALIDATION_AUTO

  public static final int VALIDATION_AUTO

  Indicates that the validation mode should be detected automatically.

  另请参阅:

  常量字段值

• VALIDATION_DTD

  public static final int VALIDATION_DTD

  Indicates that DTD validation should be used.

  另请参阅:

  常量字段值

• VALIDATION_XSD

  public static final int VALIDATION_XSD

  Indicates that XSD validation should be used.

  另请参阅:

  常量字段值

构造器详细资料

• XmlBeanDefinitionReader

  public XmlBeanDefinitionReader​(BeanDefinitionRegistry registry)

  Create new XmlBeanDefinitionReader for the given bean factory.

  参数:

  registry - the BeanFactory to load bean definitions into, in the form of a BeanDefinitionRegistry

方法详细资料

• setValidating

  public void setValidating​(boolean validating)

  Set whether to use XML validation. Default is true.

  This method switches namespace awareness on if validation is turned off, in order to still process schema namespaces properly in such a scenario.

  另请参阅:

  setValidationMode(int), setNamespaceAware(boolean)

• setValidationModeName

  public void setValidationModeName​(String validationModeName)

  Set the validation mode to use by name. Defaults to VALIDATION_AUTO.

  另请参阅:

  setValidationMode(int)

• setValidationMode

  public void setValidationMode​(int validationMode)

  Set the validation mode to use. Defaults to VALIDATION_AUTO.

  Note that this only activates or deactivates validation itself. If you are switching validation off for schema files, you might need to activate schema namespace support explicitly: see setNamespaceAware(boolean).

• getValidationMode

  public int getValidationMode()

  Return the validation mode to use.

• setNamespaceAware

  public void setNamespaceAware​(boolean namespaceAware)

  Set whether or not the XML parser should be XML namespace aware. Default is "false".

  This is typically not needed when schema validation is active. However, without validation, this has to be switched to "true" in order to properly process schema namespaces.

• isNamespaceAware

  public boolean isNamespaceAware()

  Return whether or not the XML parser should be XML namespace aware.

• setProblemReporter

  public void setProblemReporter​(@Nullable
                                 ProblemReporter problemReporter)

  Specify which ProblemReporter to use.

  The default implementation is FailFastProblemReporter which exhibits fail fast behaviour. External tools can provide an alternative implementation that collates errors and warnings for display in the tool UI.

• setEventListener

  public void setEventListener​(@Nullable
                               ReaderEventListener eventListener)

  Specify which ReaderEventListener to use.

  The default implementation is EmptyReaderEventListener which discards every event notification. External tools can provide an alternative implementation to monitor the components being registered in the BeanFactory.

• setSourceExtractor

  public void setSourceExtractor​(@Nullable
                                 SourceExtractor sourceExtractor)

  Specify the SourceExtractor to use.

  The default implementation is NullSourceExtractor which simply returns null as the source object. This means that - during normal runtime execution - no additional source metadata is attached to the bean configuration metadata.

• setNamespaceHandlerResolver

  public void setNamespaceHandlerResolver​(@Nullable
                                          NamespaceHandlerResolver namespaceHandlerResolver)

  Specify the NamespaceHandlerResolver to use.

  If none is specified, a default instance will be created through createDefaultNamespaceHandlerResolver().

• setDocumentLoader

  public void setDocumentLoader​(@Nullable
                                DocumentLoader documentLoader)

  Specify the DocumentLoader to use.

  The default implementation is DefaultDocumentLoader which loads Document instances using JAXP.

• setEntityResolver

  public void setEntityResolver​(@Nullable
                                EntityResolver entityResolver)

  Set a SAX entity resolver to be used for parsing.

  By default, ResourceEntityResolver will be used. Can be overridden for custom entity resolution, for example relative to some specific base path.

• getEntityResolver

  protected EntityResolver getEntityResolver()

  Return the EntityResolver to use, building a default resolver if none specified.

• setErrorHandler

  public void setErrorHandler​(ErrorHandler errorHandler)

  Set an implementation of the org.xml.sax.ErrorHandler interface for custom handling of XML parsing errors and warnings.

  If not set, a default SimpleSaxErrorHandler is used that simply logs warnings using the logger instance of the view class, and rethrows errors to discontinue the XML transformation.

  另请参阅:

  SimpleSaxErrorHandler

• setDocumentReaderClass

  public void setDocumentReaderClass​(Class<? extends BeanDefinitionDocumentReader> documentReaderClass)

  Specify the BeanDefinitionDocumentReader implementation to use, responsible for the actual reading of the XML bean definition document.

  The default is DefaultBeanDefinitionDocumentReader.

  参数:

  documentReaderClass - the desired BeanDefinitionDocumentReader implementation class

• loadBeanDefinitions

  public int loadBeanDefinitions​(Resource resource)
                          throws BeanDefinitionStoreException

  Load bean definitions from the specified XML file.

  参数:

  resource - the resource descriptor for the XML file

  返回:

  the number of bean definitions found

  抛出:

  BeanDefinitionStoreException - in case of loading or parsing errors

• loadBeanDefinitions

  public int loadBeanDefinitions​(EncodedResource encodedResource)
                          throws BeanDefinitionStoreException

  Load bean definitions from the specified XML file.

  参数:

  encodedResource - the resource descriptor for the XML file, allowing to specify an encoding to use for parsing the file

  返回:

  the number of bean definitions found

  抛出:

  BeanDefinitionStoreException - in case of loading or parsing errors

• loadBeanDefinitions

  public int loadBeanDefinitions​(InputSource inputSource)
                          throws BeanDefinitionStoreException

  Load bean definitions from the specified XML file.

  参数:

  inputSource - the SAX InputSource to read from

  返回:

  the number of bean definitions found

  抛出:

  BeanDefinitionStoreException - in case of loading or parsing errors

• loadBeanDefinitions

  public int loadBeanDefinitions​(InputSource inputSource,
                                 @Nullable
                                 String resourceDescription)
                          throws BeanDefinitionStoreException

  Load bean definitions from the specified XML file.

  参数:

  inputSource - the SAX InputSource to read from

  resourceDescription - a description of the resource (can be null or empty)

  返回:

  the number of bean definitions found

  抛出:

  BeanDefinitionStoreException - in case of loading or parsing errors

• doLoadBeanDefinitions

  protected int doLoadBeanDefinitions​(InputSource inputSource,
                                      Resource resource)
                               throws BeanDefinitionStoreException

  Actually load bean definitions from the specified XML file.

  参数:

  inputSource - the SAX InputSource to read from

  resource - the resource descriptor for the XML file

  返回:

  the number of bean definitions found

  抛出:

  BeanDefinitionStoreException - in case of loading or parsing errors

  另请参阅:

  doLoadDocument(org.xml.sax.InputSource, org.springframework.core.io.Resource), registerBeanDefinitions(org.w3c.dom.Document, org.springframework.core.io.Resource)

• doLoadDocument

  protected Document doLoadDocument​(InputSource inputSource,
                                    Resource resource)
                             throws Exception

  Actually load the specified document using the configured DocumentLoader.

  参数:

  inputSource - the SAX InputSource to read from

  resource - the resource descriptor for the XML file

  返回:

  the DOM Document

  抛出:

  Exception - when thrown from the DocumentLoader

  另请参阅:

  setDocumentLoader(org.springframework.beans.factory.xml.DocumentLoader), DocumentLoader.loadDocument(org.xml.sax.InputSource, org.xml.sax.EntityResolver, org.xml.sax.ErrorHandler, int, boolean)

• getValidationModeForResource

  protected int getValidationModeForResource​(Resource resource)

  Determine the validation mode for the specified Resource. If no explicit validation mode has been configured, then the validation mode gets detected from the given resource.

  Override this method if you would like full control over the validation mode, even when something other than VALIDATION_AUTO was set.

  另请参阅:

  detectValidationMode(org.springframework.core.io.Resource)

• detectValidationMode

  protected int detectValidationMode​(Resource resource)

  Detect which kind of validation to perform on the XML file identified by the supplied Resource. If the file has a DOCTYPE definition then DTD validation is used otherwise XSD validation is assumed.

  Override this method if you would like to customize resolution of the VALIDATION_AUTO mode.

• registerBeanDefinitions

  public int registerBeanDefinitions​(Document doc,
                                     Resource resource)
                              throws BeanDefinitionStoreException

  Register the bean definitions contained in the given DOM document. Called by loadBeanDefinitions.

  Creates a new instance of the parser class and invokes registerBeanDefinitions on it.

  参数:

  doc - the DOM document

  resource - the resource descriptor (for context information)

  返回:

  the number of bean definitions found

  抛出:

  BeanDefinitionStoreException - in case of parsing errors

  另请参阅:

  loadBeanDefinitions(org.springframework.core.io.Resource), setDocumentReaderClass(java.lang.Class<? extends org.springframework.beans.factory.xml.BeanDefinitionDocumentReader>), BeanDefinitionDocumentReader.registerBeanDefinitions(org.w3c.dom.Document, org.springframework.beans.factory.xml.XmlReaderContext)

• createBeanDefinitionDocumentReader

  protected BeanDefinitionDocumentReader createBeanDefinitionDocumentReader()

  Create the BeanDefinitionDocumentReader to use for actually reading bean definitions from an XML document.

  The default implementation instantiates the specified "documentReaderClass".

  另请参阅:

  setDocumentReaderClass(java.lang.Class<? extends org.springframework.beans.factory.xml.BeanDefinitionDocumentReader>)

• createReaderContext

  public XmlReaderContext createReaderContext​(Resource resource)

  Create the XmlReaderContext to pass over to the document reader.

• getNamespaceHandlerResolver

  public NamespaceHandlerResolver getNamespaceHandlerResolver()

  Lazily create a default NamespaceHandlerResolver, if not set before.

  另请参阅:

  createDefaultNamespaceHandlerResolver()

• createDefaultNamespaceHandlerResolver

  protected NamespaceHandlerResolver createDefaultNamespaceHandlerResolver()

  Create the default implementation of NamespaceHandlerResolver used if none is specified.

  The default implementation returns an instance of DefaultNamespaceHandlerResolver.

  另请参阅:

  DefaultNamespaceHandlerResolver(ClassLoader)