diff --git a/org.springframework.beans/src/main/java/org/springframework/beans/factory/xml/DocumentLoader.java b/org.springframework.beans/src/main/java/org/springframework/beans/factory/xml/DocumentLoader.java
index 778483ce3f9..676eacd289f 100644
--- a/org.springframework.beans/src/main/java/org/springframework/beans/factory/xml/DocumentLoader.java
+++ b/org.springframework.beans/src/main/java/org/springframework/beans/factory/xml/DocumentLoader.java
@@ -1,5 +1,5 @@
/*
- * Copyright 2002-2007 the original author or authors.
+ * Copyright 2002-2009 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
@@ -38,7 +38,7 @@ public interface DocumentLoader {
* @param validationMode the type of validation
* {@link org.springframework.util.xml.XmlValidationModeDetector#VALIDATION_DTD DTD}
* or {@link org.springframework.util.xml.XmlValidationModeDetector#VALIDATION_XSD XSD})
- * @param namespaceAware true if the loading is provide support for XML namespaces
+ * @param namespaceAware true if support for XML namespaces is to be provided
* @return the loaded {@link Document document}
* @throws Exception if an error occurs
*/
diff --git a/org.springframework.beans/src/main/java/org/springframework/beans/factory/xml/XmlBeanDefinitionReader.java b/org.springframework.beans/src/main/java/org/springframework/beans/factory/xml/XmlBeanDefinitionReader.java
index ecc7aed92dd..1790b85d0ff 100644
--- a/org.springframework.beans/src/main/java/org/springframework/beans/factory/xml/XmlBeanDefinitionReader.java
+++ b/org.springframework.beans/src/main/java/org/springframework/beans/factory/xml/XmlBeanDefinitionReader.java
@@ -1,5 +1,5 @@
/*
- * Copyright 2002-2008 the original author or authors.
+ * Copyright 2002-2009 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
@@ -99,10 +99,10 @@ public class XmlBeanDefinitionReader extends AbstractBeanDefinitionReader {
/** Constants instance for this class */
private static final Constants constants = new Constants(XmlBeanDefinitionReader.class);
- private boolean namespaceAware;
-
private int validationMode = VALIDATION_AUTO;
+ private boolean namespaceAware = false;
+
private Class documentReaderClass = DefaultBeanDefinitionDocumentReader.class;
private ProblemReporter problemReporter = new FailFastProblemReporter();
@@ -135,21 +135,6 @@ public class XmlBeanDefinitionReader extends AbstractBeanDefinitionReader {
}
- /**
- * Set whether or not the XML parser should be XML namespace aware.
- * Default is "false".
- */
- public void setNamespaceAware(boolean namespaceAware) {
- this.namespaceAware = namespaceAware;
- }
-
- /**
- * Return whether or not the XML parser should be XML namespace aware.
- */
- public boolean isNamespaceAware() {
- return this.namespaceAware;
- }
-
/**
* Set the validation mode to use by name. Defaults to {@link #VALIDATION_AUTO}.
*/
@@ -172,56 +157,72 @@ public class XmlBeanDefinitionReader extends AbstractBeanDefinitionReader {
}
/**
- * Specify which {@link org.springframework.beans.factory.parsing.ProblemReporter} to use. Default implementation is
- * {@link 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.
+ * Set whether or not the XML parser should be XML namespace aware.
+ * Default is "false".
+ */
+ public void setNamespaceAware(boolean namespaceAware) {
+ this.namespaceAware = namespaceAware;
+ }
+
+ /**
+ * Return whether or not the XML parser should be XML namespace aware.
+ */
+ public boolean isNamespaceAware() {
+ return this.namespaceAware;
+ }
+
+ /**
+ * Specify which {@link org.springframework.beans.factory.parsing.ProblemReporter} to use.
+ *
The default implementation is {@link 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 setProblemReporter(ProblemReporter problemReporter) { this.problemReporter = (problemReporter != null ? problemReporter : new FailFastProblemReporter()); } /** - * Specify which {@link 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. + * Specify which {@link 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.
*/
public void setEventListener(ReaderEventListener eventListener) {
this.eventListener = (eventListener != null ? eventListener : new EmptyReaderEventListener());
}
/**
- * Specify the {@link SourceExtractor} to use. The default implementation is
- * {@link 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.
+ * Specify the {@link SourceExtractor} to use.
+ *
The default implementation is {@link 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 setSourceExtractor(SourceExtractor sourceExtractor) {
this.sourceExtractor = (sourceExtractor != null ? sourceExtractor : new NullSourceExtractor());
}
/**
- * Specify the {@link NamespaceHandlerResolver} to use. If none is specified a default
- * instance will be created by {@link #createDefaultNamespaceHandlerResolver()}.
+ * Specify the {@link NamespaceHandlerResolver} to use.
+ *
If none is specified, a default instance will be created through + * {@link #createDefaultNamespaceHandlerResolver()}. */ public void setNamespaceHandlerResolver(NamespaceHandlerResolver namespaceHandlerResolver) { this.namespaceHandlerResolver = namespaceHandlerResolver; } /** - * Specify the {@link DocumentLoader} to use. The default implementation is - * {@link DefaultDocumentLoader} which loads {@link Document} instances using JAXP. + * Specify the {@link DocumentLoader} to use. + *
The default implementation is {@link DefaultDocumentLoader} + * which loads {@link Document} instances using JAXP. */ public void setDocumentLoader(DocumentLoader documentLoader) { this.documentLoader = (documentLoader != null ? documentLoader : new DefaultDocumentLoader()); } /** - * 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. - * @see BeansDtdResolver + * Set a SAX entity resolver to be used for parsing. + *
By default, {@link ResourceEntityResolver} will be used. Can be overridden + * for custom entity resolution, for example relative to some specific base path. */ public void setEntityResolver(EntityResolver entityResolver) { this.entityResolver = entityResolver; @@ -258,12 +259,10 @@ public class XmlBeanDefinitionReader extends AbstractBeanDefinitionReader { } /** - * Specify the BeanDefinitionDocumentReader implementation to use, + * Specify the {@link BeanDefinitionDocumentReader} implementation to use, * responsible for the actual reading of the XML bean definition document. - *
Default is DefaultBeanDefinitionDocumentReader. + *
The default is {@link DefaultBeanDefinitionDocumentReader}. * @param documentReaderClass the desired BeanDefinitionDocumentReader implementation class - * @see BeanDefinitionDocumentReader - * @see DefaultBeanDefinitionDocumentReader */ public void setDocumentReaderClass(Class documentReaderClass) { if (documentReaderClass == null || !BeanDefinitionDocumentReader.class.isAssignableFrom(documentReaderClass)) {