[SPR-8240] polishing the "Context management and caching" section of the reference manual and related Javadoc.

This commit is contained in:
Sam Brannen
2011-09-29 21:36:06 +00:00
parent 1bb5b21881
commit 5db7cca9a7
3 changed files with 76 additions and 70 deletions

View File

@@ -116,19 +116,19 @@ public @interface ContextConfiguration {
* {@link #classes configuration classes} from superclasses should be
* <em>inherited</em>.
*
* <p>The default value is <code>true</code>, which means that an annotated
* <p>The default value is <code>true</code>. This means that an annotated
* class will <em>inherit</em> the resource locations or configuration
* classes defined by an annotated superclass. Specifically, the resource
* classes defined by annotated superclasses. Specifically, the resource
* locations or configuration classes for an annotated class will be
* appended to the list of resource locations or configuration classes
* defined by an annotated superclass. Thus, subclasses have the option of
* defined by annotated superclasses. Thus, subclasses have the option of
* <em>extending</em> the list of resource locations or configuration
* classes.
*
* <p>If <code>inheritLocations</code> is set to <code>false</code>, the
* resource locations or configuration classes for the annotated class
* will <em>shadow</em> and effectively replace any resource locations
* or configuration classes defined by a superclass.
* or configuration classes defined by superclasses.
*
* <p>In the following example that uses path-based resource locations, the
* {@link org.springframework.context.ApplicationContext ApplicationContext}

View File

@@ -152,10 +152,10 @@ public abstract class AbstractContextLoader implements SmartContextLoader {
/**
* Generate a modified version of the supplied locations array and return it.
* <p>A plain path &mdash; for example, &quot;context.xml&quot; &mdash;
* will be treated as a classpath resource from the same package in which
* <p>A plain path &mdash; for example, &quot;context.xml&quot; &mdash; will
* be treated as a classpath resource that is relative to the package in which
* the specified class is defined. A path starting with a slash is treated
* as a fully qualified classpath location, for example:
* as an absolute classpath location, for example:
* &quot;/org/springframework/whatever/foo.xml&quot;. A path which
* references a URL (e.g., a path prefixed with
* {@link ResourceUtils#CLASSPATH_URL_PREFIX classpath:},