org.springframework.web.context.support Documentation Differences

This file contains all the changes in documentation in the package org.springframework.web.context.support as colored differences. Deletions are shown like this, and additions are shown like this.

If no deletions or additions are shown in an entry, the HTML tags will be what has changed. The new HTML tags are shown in the differences. If no documentation existed, and then some was added in a later version, this change is noted in the appropriate class pages of differences, but the change is not shown on this page. Only changes in existing text are shown here. Similarly, documentation which was inherited from another class or interface is not shown here.

Note that an HTML error in the new documentation may cause the display of other documentation changes to be presented incorrectly. For instance, failure to close a <code> tag will cause all subsequent paragraphs to be displayed differently.

Create and return a new StandardServletEnvironment. Subclasses may override in order to configure the environment or specialize the environment type returned.

Register a org.springframework.beans.factory.config.BeanDefinition for any classes specified by .register(Class...) and scan any packages specified by .scan(String...).

For any values specified by .setConfigLocation(String) or .setConfigLocations(String[]), attempt first to load each location as a class, registering a {@code BeanDefinition} if class loading is successful, and if class loading fails (i.e. a {@code ClassNotFoundException} is raised), assume the value is a package and attempt to scan it for annotated classes.

Enables the default set of annotation configuration post processors, such that {@code @Autowired}, {@code @Required}, and associated annotations can be used.

Configuration class bean definitions are registered with generated bean definition names unless the {@code value} attribute is provided to the stereotype annotation. @see #register(Class...) @see #scan(String...) @see #setConfigLocation(String) @see #setConfigLocations(String[]) @see AnnotatedBeanDefinitionReader @see ClassPathBeanDefinitionScanner

Register one or more annotated classes to be processed. Note that .refresh() must be called in order for the context to fully process the new class.

Calls to .register are idempotent; adding the same annotated class more than once has no additional effect. @param annotatedClasses one or more annotated classes, e.g. @Configuration classes @see #scan(String...) @see #loadBeanDefinitions(DefaultListableBeanFactory) @see #setConfigLocation(String) @see #refresh()

Set the ScopeMetadataResolver to use for detected bean classes.

The default is an org.springframework.context.annotation.AnnotationScopeMetadataResolver.

Customize the set of property sources with those contributed by superclasses as well as those appropriate for standard servlet-based environments:

• {@value #SERVLET_CONFIG_PROPERTY_SOURCE_NAME}
• {@value #SERVLET_CONTEXT_PROPERTY_SOURCE_NAME}
• {@value #JNDI_PROPERTY_SOURCE_NAME}

Properties present in {@value #SERVLET_CONFIG_PROPERTY_SOURCE_NAME} will take precedence over those in {@value #SERVLET_CONTEXT_PROPERTY_SOURCE_NAME}, and properties found in either of the above take precedence over those found in {@value #JNDI_PROPERTY_SOURCE_NAME}.

Properties in any of the above will take precedence over system properties and environment variables contributed by the StandardEnvironment superclass.

The {@code Servlet}-related property sources are added as stubs at this stage, and will be #initPropertySources(ServletContext, ServletConfig) fully initialized once the actual ServletContext object becomes available. @see StandardEnvironment#customizePropertySources @see org.springframework.core.env.AbstractEnvironment#customizePropertySources @see ServletConfigPropertySource @see ServletContextPropertySource @see org.springframework.jndi.JndiPropertySource @see org.springframework.context.support.AbstractApplicationContext#initPropertySources @see #initPropertySources(ServletContext, ServletConfig)

ReplaceConvenient {@code Servlet}-based stubvariant propertyof sources with actual.initServletPropertySources(MutablePropertySources, instances ServletContext, populatedServletConfig) with the giventhat always provides context{@code object. null} @seefor org.springframework.core.env.PropertySource.StubPropertySource the @seeServletConfig org.springframework.coreparameter.env.ConfigurableEnvironment#getPropertySources() @see org.springframework.web.context.support.WebApplicationContextUtils#initServletPropertySources(MutablePropertySources, ServletContext, ServletConfig)

Replace {@code Servlet}-based stub property sources withwith actual instances instances populated with the given context{@code andservletContext} configand {@code servletConfig} objects.

This method is idempotent with respect to the fact it may be called any number of times but will perform replacement of stub property sources with their corresponding actual property sources once and only once. @param propertySources the MutablePropertySources to initialize (must not be {@code null}) @param servletContext the current ServletContext (ignored if {@code null} or if the servlet context property source has already been initialized) @param servletConfig the current ServletConfig (ignored if {@code null} or if the servlet config property source has already been initialized) @see org.springframework.core.env.PropertySource.StubPropertySource @see org.springframework.web.context.support.WebApplicationContextUtils#initServletPropertySources(MutablePropertySources, ServletContext) @see org.springframework.core.env.ConfigurableEnvironment#getPropertySources()