public XmlBeanDefinitionReader(BeanDefinitionRegistry registry) 
{
		super(registry);
}

Create new XmlBeanDefinitionReader for the given bean factory.

Parameters:

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

 protected BeanDefinitionDocumentReader createBeanDefinitionDocumentReader() 
{
		return (BeanDefinitionDocumentReader) BeanUtils.instantiateClass(this.documentReaderClass);
}

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

Default implementation instantiates the specified "documentReaderClass".

 protected NamespaceHandlerResolver createDefaultNamespaceHandlerResolver() 
{
		return new DefaultNamespaceHandlerResolver(getResourceLoader().getClassLoader());
}

Create the default implementation of NamespaceHandlerResolver used if none is specified. Default implementation returns an instance of DefaultNamespaceHandlerResolver .

 protected XmlReaderContext createReaderContext(Resource resource) 
{
		if (this.namespaceHandlerResolver == null) {
			this.namespaceHandlerResolver = createDefaultNamespaceHandlerResolver();
		}
		return new XmlReaderContext(resource, this.problemReporter, this.eventListener,
				this.sourceExtractor, this, this.namespaceHandlerResolver);
}

Create the XmlReaderContext to pass over to the document reader.

 protected int detectValidationMode(Resource resource) 
{
		if (resource.isOpen()) {
			throw new BeanDefinitionStoreException(
					"Passed-in Resource [" + resource + "] contains an open stream: " +
					"cannot determine validation mode automatically. Either pass in a Resource " +
					"that is able to create fresh streams, or explicitly specify the validationMode " +
					"on your XmlBeanDefinitionReader instance.");
		}
		InputStream inputStream;
		try {
			inputStream = resource.getInputStream();
		}
		catch (IOException ex) {
			throw new BeanDefinitionStoreException(
					"Unable to determine validation mode for [" + resource + "]: cannot open InputStream. " +
					"Did you attempt to load directly from a SAX InputSource without specifying the " +
					"validationMode on your XmlBeanDefinitionReader instance?", ex);
		}
		try {
			return this.validationModeDetector.detectValidationMode(inputStream);
		}
		catch (IOException ex) {
			throw new BeanDefinitionStoreException("Unable to determine validation mode for [" +
					resource + "]: an error occurred whilst reading from the InputStream.", ex);
		}
}

Detects 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.

 protected int doLoadBeanDefinitions(InputSource inputSource,
    Resource resource) throws BeanDefinitionStoreException 
{
		try {
			int validationMode = getValidationModeForResource(resource);
			Document doc = this.documentLoader.loadDocument(
					inputSource, getEntityResolver(), this.errorHandler, validationMode, isNamespaceAware());
			return registerBeanDefinitions(doc, resource);
		}
		catch (BeanDefinitionStoreException ex) {
			throw ex;
		}
		catch (SAXParseException ex) {
			throw new XmlBeanDefinitionStoreException(resource.getDescription(),
					"Line " + ex.getLineNumber() + " in XML document from " + resource + " is invalid", ex);
		}
		catch (SAXException ex) {
			throw new XmlBeanDefinitionStoreException(resource.getDescription(),
					"XML document from " + resource + " is invalid", ex);
		}
		catch (ParserConfigurationException ex) {
			throw new BeanDefinitionStoreException(resource.getDescription(),
					"Parser configuration exception parsing XML from " + resource, ex);
		}
		catch (IOException ex) {
			throw new BeanDefinitionStoreException(resource.getDescription(),
					"IOException parsing XML document from " + resource, ex);
		}
		catch (Throwable ex) {
			throw new BeanDefinitionStoreException(resource.getDescription(),
					"Unexpected exception parsing XML document from " + resource, ex);
		}
}

Actually load bean definitions from the specified XML file.

 protected EntityResolver getEntityResolver() 
{
		if (this.entityResolver == null) {
			// Determine default EntityResolver to use.
			ResourceLoader resourceLoader = getResourceLoader();
			if (resourceLoader != null) {
				this.entityResolver = new ResourceEntityResolver(resourceLoader);
			}
			else {
				this.entityResolver = new DelegatingEntityResolver(getBeanClassLoader());
			}
		}
		return this.entityResolver;
}

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

 public int getValidationMode() 
{
		return this.validationMode;
}

Return the validation mode to use.

 protected int getValidationModeForResource(Resource resource) 
{
		int validationModeToUse = getValidationMode();
		if (validationModeToUse != VALIDATION_AUTO) {
			return validationModeToUse;
		}
		int detectedMode = detectValidationMode(resource);
		if (detectedMode != VALIDATION_AUTO) {
			return detectedMode;
		}
		// Hmm, we didn't get a clear indication... Let's assume XSD,
		// since apparently no DTD declaration has been found up until
		// detection stopped (before finding the document's root tag).
		return VALIDATION_XSD;
}

Gets the validation mode for the specified Resource . If no explicit validation mode has been configured then the validation mode is detected .

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

 public boolean isNamespaceAware() 
{
		return this.namespaceAware;
}

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

 public int loadBeanDefinitions(Resource resource) throws BeanDefinitionStoreException 
{
		return loadBeanDefinitions(new EncodedResource(resource));
}

Load bean definitions from the specified XML file.

 public int loadBeanDefinitions(EncodedResource encodedResource) throws BeanDefinitionStoreException 
{
		Assert.notNull(encodedResource, "EncodedResource must not be null");
		if (logger.isInfoEnabled()) {
			logger.info("Loading XML bean definitions from " + encodedResource.getResource());
		}
		Set currentResources = (Set) this.resourcesCurrentlyBeingLoaded.get();
		if (currentResources == null) {
			currentResources = new HashSet(4);
			this.resourcesCurrentlyBeingLoaded.set(currentResources);
		}
		if (!currentResources.add(encodedResource)) {
			throw new BeanDefinitionStoreException(
					"Detected recursive loading of " + encodedResource + " - check your import definitions!");
		}
		try {
			InputStream inputStream = encodedResource.getResource().getInputStream();
			try {
				InputSource inputSource = new InputSource(inputStream);
				if (encodedResource.getEncoding() != null) {
					inputSource.setEncoding(encodedResource.getEncoding());
				}
				return doLoadBeanDefinitions(inputSource, encodedResource.getResource());
			}
			finally {
				inputStream.close();
			}
		}
		catch (IOException ex) {
			throw new BeanDefinitionStoreException(
					"IOException parsing XML document from " + encodedResource.getResource(), ex);
		}
		finally {
			currentResources.remove(encodedResource);
			if (currentResources.isEmpty()) {
				this.resourcesCurrentlyBeingLoaded.set(null);
			}
		}
}

Load bean definitions from the specified XML file.

 public int loadBeanDefinitions(InputSource inputSource) throws BeanDefinitionStoreException 
{
		return loadBeanDefinitions(inputSource, "resource loaded through SAX InputSource");
}

Load bean definitions from the specified XML file.

 public int loadBeanDefinitions(InputSource inputSource,
    String resourceDescription) throws BeanDefinitionStoreException 
{
		return doLoadBeanDefinitions(inputSource, new DescriptiveResource(resourceDescription));
}

Load bean definitions from the specified XML file.

 public int registerBeanDefinitions(Document doc,
    Resource resource) throws BeanDefinitionStoreException 
{
		// Support old XmlBeanDefinitionParser SPI for backwards-compatibility.
		if (this.parserClass != null) {
			XmlBeanDefinitionParser parser =
					(XmlBeanDefinitionParser) BeanUtils.instantiateClass(this.parserClass);
			return parser.registerBeanDefinitions(this, doc, resource);
		}
		// Read document based on new BeanDefinitionDocumentReader SPI.
		BeanDefinitionDocumentReader documentReader = createBeanDefinitionDocumentReader();
		int countBefore = getRegistry().getBeanDefinitionCount();
		documentReader.registerBeanDefinitions(doc, createReaderContext(resource));
		return getRegistry().getBeanDefinitionCount() - countBefore;
}

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.

 public  void setDocumentLoader(DocumentLoader documentLoader) 
{
		this.documentLoader = (documentLoader != null ? documentLoader : new DefaultDocumentLoader());
}

Specify the DocumentLoader to use. The default implementation is DefaultDocumentLoader which loads Document instances using JAXP.

 public  void setDocumentReaderClass(Class documentReaderClass) 
{
		if (documentReaderClass == null || !BeanDefinitionDocumentReader.class.isAssignableFrom(documentReaderClass)) {
			throw new IllegalArgumentException(
					"documentReaderClass must be an implementation of the BeanDefinitionDocumentReader interface");
		}
		this.documentReaderClass = documentReaderClass;
}

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

Default is DefaultBeanDefinitionDocumentReader.

 public  void setEntityResolver(EntityResolver entityResolver) 
{
		this.entityResolver = entityResolver;
}

Set a SAX entity resolver to be used for parsing. By default, BeansDtdResolver will be used. Can be overridden for custom entity resolution, for example relative to some specific base path.

 public  void setErrorHandler(ErrorHandler errorHandler) 
{
		this.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.

 public  void setEventListener(ReaderEventListener eventListener) 
{
		this.eventListener = (eventListener != null ? eventListener : new EmptyReaderEventListener());
}

Specify which ReaderEventListener to use. 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.

 public  void setNamespaceAware(boolean namespaceAware) 
{
		this.namespaceAware = namespaceAware;
}

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

 public  void setNamespaceHandlerResolver(NamespaceHandlerResolver namespaceHandlerResolver) 
{
		this.namespaceHandlerResolver = namespaceHandlerResolver;
}

Specify the NamespaceHandlerResolver to use. If none is specified a default instance will be created by #createDefaultNamespaceHandlerResolver() .

 public  void setParserClass(Class parserClass) 
{
		if (this.parserClass == null || !XmlBeanDefinitionParser.class.isAssignableFrom(parserClass)) {
			throw new IllegalArgumentException("'parserClass' must be an XmlBeanDefinitionParser");
		}
		this.parserClass = parserClass;
}

Set the XmlBeanDefinitionParser implementation to use, responsible for the actual parsing of XML bean definitions.

 public  void setProblemReporter(ProblemReporter problemReporter) 
{
		this.problemReporter = (problemReporter != null ? problemReporter : new FailFastProblemReporter());
}

Specify which org.springframework.beans.factory.parsing.ProblemReporter to use. Default implementation is org.springframework.beans.factory.parsing.FailFastProblemReporter which exhibits fail fast behaviour. External tools can provide an alternative implementation that collates errors and warnings for display in the tool UI.

 public  void setSourceExtractor(SourceExtractor sourceExtractor) 
{
		this.sourceExtractor = (sourceExtractor != null ? sourceExtractor : new NullSourceExtractor());
}

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.

 public  void setValidating(boolean validating) 
{
		this.validationMode = (validating ? VALIDATION_AUTO : VALIDATION_NONE);
}

Set if the XML parser should validate the document and thus enforce a DTD.

 public  void setValidationMode(int validationMode) 
{
		this.validationMode = validationMode;
}

Set the validation mode to use. Defaults to #VALIDATION_AUTO .

 public  void setValidationModeName(String validationModeName) 
{
		setValidationMode(constants.asNumber(validationModeName).intValue());
}

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