parent
50c11028d5
commit
44e652f99e
|
|
@ -26,7 +26,7 @@ import org.aopalliance.aop.Advice;
|
||||||
* in) joinpoints. Runtime joinpoints can be invocations, field
|
* in) joinpoints. Runtime joinpoints can be invocations, field
|
||||||
* access, exceptions...
|
* access, exceptions...
|
||||||
*
|
*
|
||||||
* <p>This interface is not used directly. Use the the sub-interfaces
|
* <p>This interface is not used directly. Use the sub-interfaces
|
||||||
* to intercept specific events. For instance, the following class
|
* to intercept specific events. For instance, the following class
|
||||||
* implements some specific interceptors in order to implement a
|
* implements some specific interceptors in order to implement a
|
||||||
* debugger:
|
* debugger:
|
||||||
|
|
|
||||||
|
|
@ -65,7 +65,7 @@ public class DeclareParentsAdvisor implements IntroductionAdvisor {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Private constructor to share common code between impl-based delegate and reference-based delegate
|
* Private constructor to share common code between impl-based delegate and reference-based delegate
|
||||||
* (cannot use method such as init() to share common code, due the the use of final fields)
|
* (cannot use method such as init() to share common code, due the use of final fields)
|
||||||
* @param interfaceType static field defining the introduction
|
* @param interfaceType static field defining the introduction
|
||||||
* @param typePattern type pattern the introduction is restricted to
|
* @param typePattern type pattern the introduction is restricted to
|
||||||
* @param implementationClass implementation class
|
* @param implementationClass implementation class
|
||||||
|
|
|
||||||
|
|
@ -35,7 +35,7 @@ public abstract class AutoProxyUtils {
|
||||||
* to be proxied with its target class (in case of it getting proxied in the first
|
* to be proxied with its target class (in case of it getting proxied in the first
|
||||||
* place). The value is {@code Boolean.TRUE} or {@code Boolean.FALSE}.
|
* place). The value is {@code Boolean.TRUE} or {@code Boolean.FALSE}.
|
||||||
* <p>Proxy factories can set this attribute if they built a target class proxy
|
* <p>Proxy factories can set this attribute if they built a target class proxy
|
||||||
* for a specific bean, and want to enforce that that bean can always be cast
|
* for a specific bean, and want to enforce that bean can always be cast
|
||||||
* to its target class (even if AOP advices get applied through auto-proxying).
|
* to its target class (even if AOP advices get applied through auto-proxying).
|
||||||
* @see #shouldProxyTargetClass
|
* @see #shouldProxyTargetClass
|
||||||
*/
|
*/
|
||||||
|
|
|
||||||
|
|
@ -800,7 +800,7 @@ public abstract class AbstractNestablePropertyAccessor extends AbstractPropertyA
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Recursively navigate to return a property accessor for the nested property path.
|
* Recursively navigate to return a property accessor for the nested property path.
|
||||||
* @param propertyPath property property path, which may be nested
|
* @param propertyPath property path, which may be nested
|
||||||
* @return a property accessor for the target bean
|
* @return a property accessor for the target bean
|
||||||
*/
|
*/
|
||||||
@SuppressWarnings("unchecked") // avoid nested generic
|
@SuppressWarnings("unchecked") // avoid nested generic
|
||||||
|
|
|
||||||
|
|
@ -110,7 +110,7 @@ public abstract class BeanUtils {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Instantiate a class using its no-arg constructor and return the new instance
|
* Instantiate a class using its no-arg constructor and return the new instance
|
||||||
* as the the specified assignable type.
|
* as the specified assignable type.
|
||||||
* <p>Useful in cases where
|
* <p>Useful in cases where
|
||||||
* the type of the class to instantiate (clazz) is not available, but the type
|
* the type of the class to instantiate (clazz) is not available, but the type
|
||||||
* desired (assignableTo) is known.
|
* desired (assignableTo) is known.
|
||||||
|
|
|
||||||
|
|
@ -88,7 +88,7 @@ import org.springframework.core.io.support.ResourcePatternUtils;
|
||||||
* use object from a BeanFactory/ApplicationContext. One solutions is to make the
|
* use object from a BeanFactory/ApplicationContext. One solutions is to make the
|
||||||
* class created by the third party code be just a stub or proxy, which gets the
|
* class created by the third party code be just a stub or proxy, which gets the
|
||||||
* real object from a BeanFactory/ApplicationContext, and delegates to it. However,
|
* real object from a BeanFactory/ApplicationContext, and delegates to it. However,
|
||||||
* it is is not normally workable for the stub to create the BeanFactory on each
|
* it is not normally workable for the stub to create the BeanFactory on each
|
||||||
* use, as depending on what is inside it, that can be an expensive operation.
|
* use, as depending on what is inside it, that can be an expensive operation.
|
||||||
* Additionally, there is a fairly tight coupling between the stub and the name of
|
* Additionally, there is a fairly tight coupling between the stub and the name of
|
||||||
* the definition resource for the BeanFactory/ApplicationContext. This is where
|
* the definition resource for the BeanFactory/ApplicationContext. This is where
|
||||||
|
|
@ -291,7 +291,7 @@ public class SingletonBeanFactoryLocator implements BeanFactoryLocator {
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Returns an instance which uses the the specified selector, as the name of the
|
* Returns an instance which uses the specified selector, as the name of the
|
||||||
* definition file(s). In the case of a name with a Spring 'classpath*:' prefix,
|
* definition file(s). In the case of a name with a Spring 'classpath*:' prefix,
|
||||||
* or with no prefix, which is treated the same, the current thread context
|
* or with no prefix, which is treated the same, the current thread context
|
||||||
* ClassLoader's {@code getResources} method will be called with this value
|
* ClassLoader's {@code getResources} method will be called with this value
|
||||||
|
|
@ -341,7 +341,7 @@ public class SingletonBeanFactoryLocator implements BeanFactoryLocator {
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Constructor which uses the the specified name as the resource name
|
* Constructor which uses the specified name as the resource name
|
||||||
* of the definition file(s).
|
* of the definition file(s).
|
||||||
* @param resourceLocation the Spring resource location to use
|
* @param resourceLocation the Spring resource location to use
|
||||||
* (either a URL or a "classpath:" / "classpath*:" pseudo URL)
|
* (either a URL or a "classpath:" / "classpath*:" pseudo URL)
|
||||||
|
|
|
||||||
|
|
@ -96,7 +96,7 @@ public interface InstantiationAwareBeanPostProcessor extends BeanPostProcessor {
|
||||||
* dependency types - which the factory handles specifically - already filtered out)
|
* dependency types - which the factory handles specifically - already filtered out)
|
||||||
* @param bean the bean instance created, but whose properties have not yet been set
|
* @param bean the bean instance created, but whose properties have not yet been set
|
||||||
* @param beanName the name of the bean
|
* @param beanName the name of the bean
|
||||||
* @return the actual property values to apply to to the given bean
|
* @return the actual property values to apply to the given bean
|
||||||
* (can be the passed-in PropertyValues instance), or {@code null}
|
* (can be the passed-in PropertyValues instance), or {@code null}
|
||||||
* to skip property population
|
* to skip property population
|
||||||
* @throws org.springframework.beans.BeansException in case of errors
|
* @throws org.springframework.beans.BeansException in case of errors
|
||||||
|
|
|
||||||
|
|
@ -100,7 +100,7 @@ public interface Scope {
|
||||||
* at the appropriate time. If such a callback is not supported by the
|
* at the appropriate time. If such a callback is not supported by the
|
||||||
* underlying runtime environment at all, the callback <i>must be
|
* underlying runtime environment at all, the callback <i>must be
|
||||||
* ignored and a corresponding warning should be logged</i>.
|
* ignored and a corresponding warning should be logged</i>.
|
||||||
* <p>Note that 'destruction' refers to to automatic destruction of
|
* <p>Note that 'destruction' refers to automatic destruction of
|
||||||
* the object as part of the scope's own lifecycle, not to the individual
|
* the object as part of the scope's own lifecycle, not to the individual
|
||||||
* scoped object having been explicitly removed by the application.
|
* scoped object having been explicitly removed by the application.
|
||||||
* If a scoped object gets removed via this facade's {@link #remove(String)}
|
* If a scoped object gets removed via this facade's {@link #remove(String)}
|
||||||
|
|
|
||||||
|
|
@ -68,7 +68,7 @@ public abstract class AbstractBeanDefinitionReader implements EnvironmentCapable
|
||||||
* {@link org.springframework.context.ApplicationContext} implementations.
|
* {@link org.springframework.context.ApplicationContext} implementations.
|
||||||
* <p>If given a plain BeanDefinitionRegistry, the default ResourceLoader will be a
|
* <p>If given a plain BeanDefinitionRegistry, the default ResourceLoader will be a
|
||||||
* {@link org.springframework.core.io.support.PathMatchingResourcePatternResolver}.
|
* {@link org.springframework.core.io.support.PathMatchingResourcePatternResolver}.
|
||||||
* <p>If the the passed-in bean factory also implements {@link EnvironmentCapable} its
|
* <p>If the passed-in bean factory also implements {@link EnvironmentCapable} its
|
||||||
* environment will be used by this reader. Otherwise, the reader will initialize and
|
* environment will be used by this reader. Otherwise, the reader will initialize and
|
||||||
* use a {@link StandardEnvironment}. All ApplicationContext implementations are
|
* use a {@link StandardEnvironment}. All ApplicationContext implementations are
|
||||||
* EnvironmentCapable, while normal BeanFactory implementations are not.
|
* EnvironmentCapable, while normal BeanFactory implementations are not.
|
||||||
|
|
|
||||||
|
|
@ -84,7 +84,7 @@ public class StringArrayPropertyEditor extends PropertyEditorSupport {
|
||||||
* @param emptyArrayAsNull {@code true} if an empty String array
|
* @param emptyArrayAsNull {@code true} if an empty String array
|
||||||
* is to be transformed into {@code null}
|
* is to be transformed into {@code null}
|
||||||
* @param trimValues {@code true} if the values in the parsed arrays
|
* @param trimValues {@code true} if the values in the parsed arrays
|
||||||
* are to be be trimmed of whitespace (default is true).
|
* are to be trimmed of whitespace (default is true).
|
||||||
*/
|
*/
|
||||||
public StringArrayPropertyEditor(String separator, boolean emptyArrayAsNull, boolean trimValues) {
|
public StringArrayPropertyEditor(String separator, boolean emptyArrayAsNull, boolean trimValues) {
|
||||||
this(separator, null, emptyArrayAsNull, trimValues);
|
this(separator, null, emptyArrayAsNull, trimValues);
|
||||||
|
|
@ -112,7 +112,7 @@ public class StringArrayPropertyEditor extends PropertyEditorSupport {
|
||||||
* @param emptyArrayAsNull {@code true} if an empty String array
|
* @param emptyArrayAsNull {@code true} if an empty String array
|
||||||
* is to be transformed into {@code null}
|
* is to be transformed into {@code null}
|
||||||
* @param trimValues {@code true} if the values in the parsed arrays
|
* @param trimValues {@code true} if the values in the parsed arrays
|
||||||
* are to be be trimmed of whitespace (default is true).
|
* are to be trimmed of whitespace (default is true).
|
||||||
*/
|
*/
|
||||||
public StringArrayPropertyEditor(String separator, String charsToDelete, boolean emptyArrayAsNull, boolean trimValues) {
|
public StringArrayPropertyEditor(String separator, String charsToDelete, boolean emptyArrayAsNull, boolean trimValues) {
|
||||||
this.separator = separator;
|
this.separator = separator;
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
/**
|
/**
|
||||||
* Transaction-aware decorators for the the org.springframework.cache package.
|
* Transaction-aware decorators for the org.springframework.cache package.
|
||||||
* Provides synchronization of put operations with Spring-managed transactions.
|
* Provides synchronization of put operations with Spring-managed transactions.
|
||||||
*/
|
*/
|
||||||
package org.springframework.cache.transaction;
|
package org.springframework.cache.transaction;
|
||||||
|
|
|
||||||
|
|
@ -358,12 +358,12 @@ public class FreeMarkerConfigurationFactory {
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* To be overridden by subclasses that want to to register custom
|
* To be overridden by subclasses that want to register custom
|
||||||
* TemplateLoader instances after this factory created its default
|
* TemplateLoader instances after this factory created its default
|
||||||
* template loaders.
|
* template loaders.
|
||||||
* <p>Called by {@code createConfiguration()}. Note that specified
|
* <p>Called by {@code createConfiguration()}. Note that specified
|
||||||
* "postTemplateLoaders" will be registered <i>after</i> any loaders
|
* "postTemplateLoaders" will be registered <i>after</i> any loaders
|
||||||
* registered by this callback; as a consequence, they are are <i>not</i>
|
* registered by this callback; as a consequence, they are <i>not</i>
|
||||||
* included in the given List.
|
* included in the given List.
|
||||||
* @param templateLoaders the current List of TemplateLoader instances,
|
* @param templateLoaders the current List of TemplateLoader instances,
|
||||||
* to be modified by a subclass
|
* to be modified by a subclass
|
||||||
|
|
@ -395,7 +395,7 @@ public class FreeMarkerConfigurationFactory {
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* To be overridden by subclasses that want to to perform custom
|
* To be overridden by subclasses that want to perform custom
|
||||||
* post-processing of the Configuration object after this factory
|
* post-processing of the Configuration object after this factory
|
||||||
* performed its default initialization.
|
* performed its default initialization.
|
||||||
* <p>Called by {@code createConfiguration()}.
|
* <p>Called by {@code createConfiguration()}.
|
||||||
|
|
|
||||||
|
|
@ -340,7 +340,7 @@ public class VelocityEngineFactory {
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* To be implemented by subclasses that want to to perform custom
|
* To be implemented by subclasses that want to perform custom
|
||||||
* post-processing of the VelocityEngine after this FactoryBean
|
* post-processing of the VelocityEngine after this FactoryBean
|
||||||
* performed its default configuration (but before VelocityEngine.init).
|
* performed its default configuration (but before VelocityEngine.init).
|
||||||
* <p>Called by {@code createVelocityEngine()}.
|
* <p>Called by {@code createVelocityEngine()}.
|
||||||
|
|
|
||||||
|
|
@ -37,7 +37,7 @@ public interface Cache {
|
||||||
String getName();
|
String getName();
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Return the the underlying native cache provider.
|
* Return the underlying native cache provider.
|
||||||
*/
|
*/
|
||||||
Object getNativeCache();
|
Object getNativeCache();
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -99,7 +99,7 @@ import org.springframework.core.Ordered;
|
||||||
* <p>For those that wish to establish a more direct relationship between
|
* <p>For those that wish to establish a more direct relationship between
|
||||||
* {@code @EnableCaching} and the exact cache manager bean to be used,
|
* {@code @EnableCaching} and the exact cache manager bean to be used,
|
||||||
* the {@link CachingConfigurer} callback interface may be implemented.
|
* the {@link CachingConfigurer} callback interface may be implemented.
|
||||||
* Notice the the {@code @Override}-annotated methods below:
|
* Notice the {@code @Override}-annotated methods below:
|
||||||
*
|
*
|
||||||
* <pre class="code">
|
* <pre class="code">
|
||||||
* @Configuration
|
* @Configuration
|
||||||
|
|
|
||||||
|
|
@ -221,7 +221,7 @@ class CacheAdviceParser extends AbstractSingleBeanDefinitionParser {
|
||||||
}
|
}
|
||||||
else {
|
else {
|
||||||
if (this.caches == null) {
|
if (this.caches == null) {
|
||||||
readerCtx.error("No cache specified specified for " + element.getNodeName(), element);
|
readerCtx.error("No cache specified for " + element.getNodeName(), element);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
builder.setCacheNames(localCaches);
|
builder.setCacheNames(localCaches);
|
||||||
|
|
|
||||||
|
|
@ -274,7 +274,7 @@ public abstract class CacheAspectSupport extends AbstractCacheInvoker
|
||||||
* Return a bean with the specified name and type. Used to resolve services that
|
* Return a bean with the specified name and type. Used to resolve services that
|
||||||
* are referenced by name in a {@link CacheOperation}.
|
* are referenced by name in a {@link CacheOperation}.
|
||||||
* @param beanName the name of the bean, as defined by the operation
|
* @param beanName the name of the bean, as defined by the operation
|
||||||
* @param expectedType type type for the bean
|
* @param expectedType type for the bean
|
||||||
* @return the bean matching that name
|
* @return the bean matching that name
|
||||||
* @throws org.springframework.beans.factory.NoSuchBeanDefinitionException if such bean does not exist
|
* @throws org.springframework.beans.factory.NoSuchBeanDefinitionException if such bean does not exist
|
||||||
* @see CacheOperation#keyGenerator
|
* @see CacheOperation#keyGenerator
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
/**
|
/**
|
||||||
* Support classes for the the org.springframework.cache package.
|
* Support classes for the org.springframework.cache package.
|
||||||
* Provides abstract classes for cache managers and caches.
|
* Provides abstract classes for cache managers and caches.
|
||||||
*/
|
*/
|
||||||
package org.springframework.cache.support;
|
package org.springframework.cache.support;
|
||||||
|
|
|
||||||
|
|
@ -70,7 +70,7 @@ public class ContextSingletonBeanFactoryLocator extends SingletonBeanFactoryLoca
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Returns an instance which uses the the specified selector, as the name of the
|
* Returns an instance which uses the specified selector, as the name of the
|
||||||
* definition file(s). In the case of a name with a Spring "classpath*:" prefix,
|
* definition file(s). In the case of a name with a Spring "classpath*:" prefix,
|
||||||
* or with no prefix, which is treated the same, the current thread's context class
|
* or with no prefix, which is treated the same, the current thread's context class
|
||||||
* loader's {@code getResources} method will be called with this value to get
|
* loader's {@code getResources} method will be called with this value to get
|
||||||
|
|
@ -112,7 +112,7 @@ public class ContextSingletonBeanFactoryLocator extends SingletonBeanFactoryLoca
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Constructor which uses the the specified name as the resource name
|
* Constructor which uses the specified name as the resource name
|
||||||
* of the definition file(s).
|
* of the definition file(s).
|
||||||
* @param resourceLocation the Spring resource location to use
|
* @param resourceLocation the Spring resource location to use
|
||||||
* (either a URL or a "classpath:" / "classpath*:" pseudo URL)
|
* (either a URL or a "classpath:" / "classpath*:" pseudo URL)
|
||||||
|
|
|
||||||
|
|
@ -92,7 +92,7 @@ public class ClassPathBeanDefinitionScanner extends ClassPathScanningCandidateCo
|
||||||
* implementations.
|
* implementations.
|
||||||
* <p>If given a plain {@code BeanDefinitionRegistry}, the default {@code ResourceLoader}
|
* <p>If given a plain {@code BeanDefinitionRegistry}, the default {@code ResourceLoader}
|
||||||
* will be a {@link org.springframework.core.io.support.PathMatchingResourcePatternResolver}.
|
* will be a {@link org.springframework.core.io.support.PathMatchingResourcePatternResolver}.
|
||||||
* <p>If the the passed-in bean factory also implements {@link EnvironmentCapable} its
|
* <p>If the passed-in bean factory also implements {@link EnvironmentCapable} its
|
||||||
* environment will be used by this reader. Otherwise, the reader will initialize and
|
* environment will be used by this reader. Otherwise, the reader will initialize and
|
||||||
* use a {@link org.springframework.core.env.StandardEnvironment}. All
|
* use a {@link org.springframework.core.env.StandardEnvironment}. All
|
||||||
* {@code ApplicationContext} implementations are {@code EnvironmentCapable}, while
|
* {@code ApplicationContext} implementations are {@code EnvironmentCapable}, while
|
||||||
|
|
|
||||||
|
|
@ -292,7 +292,7 @@ public class DefaultLifecycleProcessor implements LifecycleProcessor, BeanFactor
|
||||||
* <p>The default implementation checks for the {@link Phased} interface.
|
* <p>The default implementation checks for the {@link Phased} interface.
|
||||||
* Can be overridden to apply other/further policies.
|
* Can be overridden to apply other/further policies.
|
||||||
* @param bean the bean to introspect
|
* @param bean the bean to introspect
|
||||||
* @return the phase an an integer value. The suggested default is 0.
|
* @return the phase an integer value. The suggested default is 0.
|
||||||
* @see Phased
|
* @see Phased
|
||||||
* @see SmartLifecycle
|
* @see SmartLifecycle
|
||||||
*/
|
*/
|
||||||
|
|
|
||||||
|
|
@ -570,7 +570,7 @@ public class MBeanExporter extends MBeanRegistrationSupport implements MBeanExpo
|
||||||
* should be exposed to the {@code MBeanServer}. Specifically, if the
|
* should be exposed to the {@code MBeanServer}. Specifically, if the
|
||||||
* supplied {@code mapValue} is the name of a bean that is configured
|
* supplied {@code mapValue} is the name of a bean that is configured
|
||||||
* for lazy initialization, then a proxy to the resource is registered with
|
* for lazy initialization, then a proxy to the resource is registered with
|
||||||
* the {@code MBeanServer} so that the the lazy load behavior is
|
* the {@code MBeanServer} so that the lazy load behavior is
|
||||||
* honored. If the bean is already an MBean then it will be registered
|
* honored. If the bean is already an MBean then it will be registered
|
||||||
* directly with the {@code MBeanServer} without any intervention. For
|
* directly with the {@code MBeanServer} without any intervention. For
|
||||||
* all other beans or bean names, the resource itself is registered with
|
* all other beans or bean names, the resource itself is registered with
|
||||||
|
|
|
||||||
|
|
@ -26,7 +26,7 @@ import org.springframework.util.ObjectUtils;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* An implementation of the {@code ObjectNamingStrategy} interface that
|
* An implementation of the {@code ObjectNamingStrategy} interface that
|
||||||
* creates a name based on the the identity of a given instance.
|
* creates a name based on the identity of a given instance.
|
||||||
*
|
*
|
||||||
* <p>The resulting {@code ObjectName} will be in the form
|
* <p>The resulting {@code ObjectName} will be in the form
|
||||||
* <i>package</i>:class=<i>class name</i>,hashCode=<i>identity hash (in hex)</i>
|
* <i>package</i>:class=<i>class name</i>,hashCode=<i>identity hash (in hex)</i>
|
||||||
|
|
|
||||||
|
|
@ -70,7 +70,7 @@ public class KeyNamingStrategy implements ObjectNamingStrategy, InitializingBean
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Stores the result of merging the {@code mappings} {@code Properties}
|
* Stores the result of merging the {@code mappings} {@code Properties}
|
||||||
* with the the properties stored in the resources defined by {@code mappingLocations}.
|
* with the properties stored in the resources defined by {@code mappingLocations}.
|
||||||
*/
|
*/
|
||||||
private Properties mergedMappings;
|
private Properties mergedMappings;
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -219,7 +219,7 @@ public class JndiObjectFactoryBean extends JndiObjectLocator
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Lookup variant that that returns the specified "defaultObject"
|
* Lookup variant that returns the specified "defaultObject"
|
||||||
* (if any) in case of lookup failure.
|
* (if any) in case of lookup failure.
|
||||||
* @return the located object, or the "defaultObject" as fallback
|
* @return the located object, or the "defaultObject" as fallback
|
||||||
* @throws NamingException in case of lookup failure without fallback
|
* @throws NamingException in case of lookup failure without fallback
|
||||||
|
|
|
||||||
|
|
@ -381,7 +381,7 @@ public class ScriptFactoryPostProcessor extends InstantiationAwareBeanPostProces
|
||||||
* If the {@link BeanDefinition} has a
|
* If the {@link BeanDefinition} has a
|
||||||
* {@link org.springframework.core.AttributeAccessor metadata attribute}
|
* {@link org.springframework.core.AttributeAccessor metadata attribute}
|
||||||
* under the key {@link #REFRESH_CHECK_DELAY_ATTRIBUTE} which is a valid {@link Number}
|
* under the key {@link #REFRESH_CHECK_DELAY_ATTRIBUTE} which is a valid {@link Number}
|
||||||
* type, then this value is used. Otherwise, the the {@link #defaultRefreshCheckDelay}
|
* type, then this value is used. Otherwise, the {@link #defaultRefreshCheckDelay}
|
||||||
* value is used.
|
* value is used.
|
||||||
* @param beanDefinition the BeanDefinition to check
|
* @param beanDefinition the BeanDefinition to check
|
||||||
* @return the refresh check delay
|
* @return the refresh check delay
|
||||||
|
|
|
||||||
|
|
@ -36,7 +36,7 @@ final class _TestTypes { }
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Aspect used as part of before before advice binding tests and
|
* Aspect used as part of before advice binding tests and
|
||||||
* serves as base class for a number of more specialized test aspects.
|
* serves as base class for a number of more specialized test aspects.
|
||||||
*
|
*
|
||||||
* @author Adrian Colyer
|
* @author Adrian Colyer
|
||||||
|
|
|
||||||
|
|
@ -163,7 +163,7 @@ final class Frame {
|
||||||
private static final int LOCAL = 0x2000000;
|
private static final int LOCAL = 0x2000000;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Kind of the the types that are relative to the stack of an input stack
|
* Kind of the types that are relative to the stack of an input stack
|
||||||
* map frame. The value of such types is a position relatively to the top of
|
* map frame. The value of such types is a position relatively to the top of
|
||||||
* this stack.
|
* this stack.
|
||||||
*/
|
*/
|
||||||
|
|
|
||||||
|
|
@ -53,7 +53,7 @@ public class FastByteArrayOutputStream extends OutputStream {
|
||||||
// The size, in bytes, to use when allocating the first byte[]
|
// The size, in bytes, to use when allocating the first byte[]
|
||||||
private final int initialBlockSize;
|
private final int initialBlockSize;
|
||||||
|
|
||||||
// The size, in bytes, to use when allocating the next next byte[]
|
// The size, in bytes, to use when allocating the next byte[]
|
||||||
private int nextBlockSize = 0;
|
private int nextBlockSize = 0;
|
||||||
|
|
||||||
// The number of bytes in previous buffers.
|
// The number of bytes in previous buffers.
|
||||||
|
|
|
||||||
|
|
@ -23,7 +23,7 @@ import java.io.ByteArrayOutputStream;
|
||||||
* <ul>
|
* <ul>
|
||||||
* <li>has public {@link org.springframework.util.ResizableByteArrayOutputStream#grow(int)}
|
* <li>has public {@link org.springframework.util.ResizableByteArrayOutputStream#grow(int)}
|
||||||
* and {@link org.springframework.util.ResizableByteArrayOutputStream#resize(int)} methods
|
* and {@link org.springframework.util.ResizableByteArrayOutputStream#resize(int)} methods
|
||||||
* to get more control over the the size of the internal buffer</li>
|
* to get more control over the size of the internal buffer</li>
|
||||||
* <li>has a higher initial capacity (256) by default</li>
|
* <li>has a higher initial capacity (256) by default</li>
|
||||||
* </ul>
|
* </ul>
|
||||||
*
|
*
|
||||||
|
|
|
||||||
|
|
@ -24,7 +24,7 @@ import java.util.List;
|
||||||
import org.springframework.util.Assert;
|
import org.springframework.util.Assert;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* A comparator that chains a sequence of one or more more Comparators.
|
* A comparator that chains a sequence of one or more Comparators.
|
||||||
*
|
*
|
||||||
* <p>A compound comparator calls each Comparator in sequence until a single
|
* <p>A compound comparator calls each Comparator in sequence until a single
|
||||||
* Comparator returns a non-zero result, or the comparators are exhausted and
|
* Comparator returns a non-zero result, or the comparators are exhausted and
|
||||||
|
|
|
||||||
|
|
@ -43,7 +43,7 @@ public class InstanceComparator<T> implements Comparator<T> {
|
||||||
/**
|
/**
|
||||||
* Create a new {@link InstanceComparator} instance.
|
* Create a new {@link InstanceComparator} instance.
|
||||||
* @param instanceOrder the ordered list of classes that should be used when comparing
|
* @param instanceOrder the ordered list of classes that should be used when comparing
|
||||||
* objects. Classes earlier in the list will be be given a higher priority.
|
* objects. Classes earlier in the list will be given a higher priority.
|
||||||
*/
|
*/
|
||||||
public InstanceComparator(Class<?>... instanceOrder) {
|
public InstanceComparator(Class<?>... instanceOrder) {
|
||||||
Assert.notNull(instanceOrder, "'instanceOrder' must not be null");
|
Assert.notNull(instanceOrder, "'instanceOrder' must not be null");
|
||||||
|
|
|
||||||
|
|
@ -120,7 +120,7 @@ public class XmlValidationModeDetector {
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Does the content contain the the DTD DOCTYPE declaration?
|
* Does the content contain the DTD DOCTYPE declaration?
|
||||||
*/
|
*/
|
||||||
private boolean hasDoctype(String content) {
|
private boolean hasDoctype(String content) {
|
||||||
return content.contains(DOCTYPE);
|
return content.contains(DOCTYPE);
|
||||||
|
|
|
||||||
|
|
@ -47,7 +47,7 @@ import static org.junit.Assert.*;
|
||||||
* <li>Some basic type converters are included
|
* <li>Some basic type converters are included
|
||||||
* <li>properties/methods/constructors are discovered and invoked using reflection
|
* <li>properties/methods/constructors are discovered and invoked using reflection
|
||||||
* </ul>
|
* </ul>
|
||||||
* The scenarios after that then how how to plug in extensions:<br>
|
* The scenarios after that then how to plug in extensions:<br>
|
||||||
* <ul>
|
* <ul>
|
||||||
* <li>Adding entries to the classpath that will be used to load types and define well known 'imports'
|
* <li>Adding entries to the classpath that will be used to load types and define well known 'imports'
|
||||||
* <li>Defining variables that are then accessible in the expression
|
* <li>Defining variables that are then accessible in the expression
|
||||||
|
|
|
||||||
|
|
@ -189,7 +189,7 @@ public class StoredProcedureTests {
|
||||||
TestJdbcTemplate t = new TestJdbcTemplate();
|
TestJdbcTemplate t = new TestJdbcTemplate();
|
||||||
t.setDataSource(dataSource);
|
t.setDataSource(dataSource);
|
||||||
// Will fail without the following, because we're not able to get a connection
|
// Will fail without the following, because we're not able to get a connection
|
||||||
// from the DataSource here if we need to to create an ExceptionTranslator
|
// from the DataSource here if we need to create an ExceptionTranslator
|
||||||
t.setExceptionTranslator(new SQLStateSQLExceptionTranslator());
|
t.setExceptionTranslator(new SQLStateSQLExceptionTranslator());
|
||||||
StoredProcedureConfiguredViaJdbcTemplate sp = new StoredProcedureConfiguredViaJdbcTemplate(t);
|
StoredProcedureConfiguredViaJdbcTemplate sp = new StoredProcedureConfiguredViaJdbcTemplate(t);
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -108,7 +108,7 @@ import org.springframework.context.annotation.Import;
|
||||||
* <p>Annotated methods can use flexible signature; in particular, it is possible to use
|
* <p>Annotated methods can use flexible signature; in particular, it is possible to use
|
||||||
* the {@link org.springframework.messaging.Message Message} abstraction and related annotations,
|
* the {@link org.springframework.messaging.Message Message} abstraction and related annotations,
|
||||||
* see {@link JmsListener} Javadoc for more details. For instance, the following would
|
* see {@link JmsListener} Javadoc for more details. For instance, the following would
|
||||||
* inject the content of the message and a a custom "myCounter" JMS header:
|
* inject the content of the message and a custom "myCounter" JMS header:
|
||||||
*
|
*
|
||||||
* <pre class="code">
|
* <pre class="code">
|
||||||
* @JmsListener(containerFactory = "myJmsListenerContainerFactory", destination="myQueue")
|
* @JmsListener(containerFactory = "myJmsListenerContainerFactory", destination="myQueue")
|
||||||
|
|
|
||||||
|
|
@ -20,7 +20,7 @@ import javax.jms.Session;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Subinterface of {@link javax.jms.Session} to be implemented by
|
* Subinterface of {@link javax.jms.Session} to be implemented by
|
||||||
* Session proxies. Allows access to the the underlying target Session.
|
* Session proxies. Allows access to the underlying target Session.
|
||||||
*
|
*
|
||||||
* @author Juergen Hoeller
|
* @author Juergen Hoeller
|
||||||
* @since 2.0.4
|
* @since 2.0.4
|
||||||
|
|
|
||||||
|
|
@ -125,7 +125,7 @@ public abstract class JmsAccessor implements InitializingBean {
|
||||||
* {@link Session} to send a message.
|
* {@link Session} to send a message.
|
||||||
* <p>Default is {@link Session#AUTO_ACKNOWLEDGE}.
|
* <p>Default is {@link Session#AUTO_ACKNOWLEDGE}.
|
||||||
* <p>Vendor-specific extensions to the acknowledgment mode can be set here as well.
|
* <p>Vendor-specific extensions to the acknowledgment mode can be set here as well.
|
||||||
* <p>Note that that inside an EJB, the parameters to the
|
* <p>Note that inside an EJB, the parameters to the
|
||||||
* {@code create(Queue/Topic)Session(boolean transacted, int acknowledgeMode)} method
|
* {@code create(Queue/Topic)Session(boolean transacted, int acknowledgeMode)} method
|
||||||
* are not taken into account. Depending on the transaction context in the EJB,
|
* are not taken into account. Depending on the transaction context in the EJB,
|
||||||
* the container makes its own decisions on these values. See section 17.3.5
|
* the container makes its own decisions on these values. See section 17.3.5
|
||||||
|
|
|
||||||
|
|
@ -52,7 +52,7 @@ public class TaskExecutorRegistration {
|
||||||
* in {@link java.util.concurrent.ThreadPoolExecutor ThreadPoolExecutor}. When
|
* in {@link java.util.concurrent.ThreadPoolExecutor ThreadPoolExecutor}. When
|
||||||
* this strategy is used, the {@link #maxPoolSize(int) maxPoolSize} is ignored.
|
* this strategy is used, the {@link #maxPoolSize(int) maxPoolSize} is ignored.
|
||||||
* <p>By default this is set to twice the value of
|
* <p>By default this is set to twice the value of
|
||||||
* {@link Runtime#availableProcessors()}. In an an application where tasks do not
|
* {@link Runtime#availableProcessors()}. In an application where tasks do not
|
||||||
* block frequently, the number should be closer to or equal to the number of
|
* block frequently, the number should be closer to or equal to the number of
|
||||||
* available CPUs/cores.
|
* available CPUs/cores.
|
||||||
*/
|
*/
|
||||||
|
|
|
||||||
|
|
@ -60,7 +60,7 @@ import org.springframework.util.concurrent.ListenableFutureTask;
|
||||||
*
|
*
|
||||||
* <p>This class also automatically opens a default "system" TCP connection to the message
|
* <p>This class also automatically opens a default "system" TCP connection to the message
|
||||||
* broker that is used for sending messages that originate from the server application (as
|
* broker that is used for sending messages that originate from the server application (as
|
||||||
* opposed to from a client). Such messages are are not associated with any client and
|
* opposed to from a client). Such messages are not associated with any client and
|
||||||
* therefore do not have a session id header. The "system" connection is effectively
|
* therefore do not have a session id header. The "system" connection is effectively
|
||||||
* shared and cannot be used to receive messages. Several properties are provided to
|
* shared and cannot be used to receive messages. Several properties are provided to
|
||||||
* configure the "system" connection including:
|
* configure the "system" connection including:
|
||||||
|
|
|
||||||
|
|
@ -39,14 +39,14 @@ public interface TcpConnection<P> extends Closeable {
|
||||||
ListenableFuture<Void> send(Message<P> message);
|
ListenableFuture<Void> send(Message<P> message);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Register a task to invoke after a period of of read inactivity.
|
* Register a task to invoke after a period of read inactivity.
|
||||||
* @param runnable the task to invoke
|
* @param runnable the task to invoke
|
||||||
* @param duration the amount of inactive time in milliseconds
|
* @param duration the amount of inactive time in milliseconds
|
||||||
*/
|
*/
|
||||||
void onReadInactivity(Runnable runnable, long duration);
|
void onReadInactivity(Runnable runnable, long duration);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Register a task to invoke after a period of of write inactivity.
|
* Register a task to invoke after a period of write inactivity.
|
||||||
* @param runnable the task to invoke
|
* @param runnable the task to invoke
|
||||||
* @param duration the amount of inactive time in milliseconds
|
* @param duration the amount of inactive time in milliseconds
|
||||||
*/
|
*/
|
||||||
|
|
|
||||||
|
|
@ -521,7 +521,7 @@ public class LocalSessionFactoryBean extends AbstractSessionFactoryBean implemen
|
||||||
}
|
}
|
||||||
if (this.lobHandler != null) {
|
if (this.lobHandler != null) {
|
||||||
// Make given LobHandler available for SessionFactory configuration.
|
// Make given LobHandler available for SessionFactory configuration.
|
||||||
// Do early because because mapping resource might refer to custom types.
|
// Do early because mapping resource might refer to custom types.
|
||||||
configTimeLobHandlerHolder.set(this.lobHandler);
|
configTimeLobHandlerHolder.set(this.lobHandler);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
@ -754,7 +754,7 @@ public class LocalSessionFactoryBean extends AbstractSessionFactoryBean implemen
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* To be implemented by subclasses that want to to register further mappings
|
* To be implemented by subclasses that want to register further mappings
|
||||||
* on the Configuration object after this FactoryBean registered its specified
|
* on the Configuration object after this FactoryBean registered its specified
|
||||||
* mappings.
|
* mappings.
|
||||||
* <p>Invoked <i>before</i> the {@code Configuration.buildMappings()} call,
|
* <p>Invoked <i>before</i> the {@code Configuration.buildMappings()} call,
|
||||||
|
|
@ -767,7 +767,7 @@ public class LocalSessionFactoryBean extends AbstractSessionFactoryBean implemen
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* To be implemented by subclasses that want to to perform custom
|
* To be implemented by subclasses that want to perform custom
|
||||||
* post-processing of the Configuration object after this FactoryBean
|
* post-processing of the Configuration object after this FactoryBean
|
||||||
* performed its default initialization.
|
* performed its default initialization.
|
||||||
* <p>Invoked <i>after</i> the {@code Configuration.buildMappings()} call,
|
* <p>Invoked <i>after</i> the {@code Configuration.buildMappings()} call,
|
||||||
|
|
|
||||||
|
|
@ -52,7 +52,7 @@ public interface JpaVendorAdapter {
|
||||||
* <p>Note that there might be further JPA properties defined on
|
* <p>Note that there might be further JPA properties defined on
|
||||||
* the EntityManagerFactory bean, which might potentially override
|
* the EntityManagerFactory bean, which might potentially override
|
||||||
* individual JPA property values specified here.
|
* individual JPA property values specified here.
|
||||||
* @return a Map of JPA properties, as as accepted by the standard
|
* @return a Map of JPA properties, as accepted by the standard
|
||||||
* JPA bootstrap facilities, or {@code null} or an empty Map
|
* JPA bootstrap facilities, or {@code null} or an empty Map
|
||||||
* if there are no such properties to expose
|
* if there are no such properties to expose
|
||||||
* @see javax.persistence.Persistence#createEntityManagerFactory(String, java.util.Map)
|
* @see javax.persistence.Persistence#createEntityManagerFactory(String, java.util.Map)
|
||||||
|
|
|
||||||
|
|
@ -173,7 +173,7 @@ public class ServletTestExecutionListenerTests {
|
||||||
}
|
}
|
||||||
|
|
||||||
private void assertRequestAttributesDoNotExist() {
|
private void assertRequestAttributesDoNotExist() {
|
||||||
assertNull("request attributes should not not exist", RequestContextHolder.getRequestAttributes());
|
assertNull("request attributes should not exist", RequestContextHolder.getRequestAttributes());
|
||||||
}
|
}
|
||||||
|
|
||||||
private void assertSetUpOutsideOfStelAttributeExists() {
|
private void assertSetUpOutsideOfStelAttributeExists() {
|
||||||
|
|
|
||||||
|
|
@ -58,7 +58,7 @@ public abstract class AbstractMessageEndpointFactory implements MessageEndpointF
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Set the the XA transaction manager to use for wrapping endpoint
|
* Set the XA transaction manager to use for wrapping endpoint
|
||||||
* invocations, enlisting the endpoint resource in each such transaction.
|
* invocations, enlisting the endpoint resource in each such transaction.
|
||||||
* <p>The passed-in object may be a transaction manager which implements
|
* <p>The passed-in object may be a transaction manager which implements
|
||||||
* Spring's {@link org.springframework.transaction.jta.TransactionFactory}
|
* Spring's {@link org.springframework.transaction.jta.TransactionFactory}
|
||||||
|
|
|
||||||
|
|
@ -57,7 +57,7 @@ public class DefaultTransactionAttribute extends DefaultTransactionDefinition im
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Create a new DefaultTransactionAttribute with the the given
|
* Create a new DefaultTransactionAttribute with the given
|
||||||
* propagation behavior. Can be modified through bean property setters.
|
* propagation behavior. Can be modified through bean property setters.
|
||||||
* @param propagationBehavior one of the propagation constants in the
|
* @param propagationBehavior one of the propagation constants in the
|
||||||
* TransactionDefinition interface
|
* TransactionDefinition interface
|
||||||
|
|
|
||||||
|
|
@ -82,7 +82,7 @@ public class RuleBasedTransactionAttribute extends DefaultTransactionAttribute i
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Create a new DefaultTransactionAttribute with the the given
|
* Create a new DefaultTransactionAttribute with the given
|
||||||
* propagation behavior. Can be modified through bean property setters.
|
* propagation behavior. Can be modified through bean property setters.
|
||||||
* @param propagationBehavior one of the propagation constants in the
|
* @param propagationBehavior one of the propagation constants in the
|
||||||
* TransactionDefinition interface
|
* TransactionDefinition interface
|
||||||
|
|
|
||||||
|
|
@ -91,7 +91,7 @@ public class DefaultTransactionDefinition implements TransactionDefinition, Seri
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Create a new DefaultTransactionDefinition with the the given
|
* Create a new DefaultTransactionDefinition with the given
|
||||||
* propagation behavior. Can be modified through bean property setters.
|
* propagation behavior. Can be modified through bean property setters.
|
||||||
* @param propagationBehavior one of the propagation constants in the
|
* @param propagationBehavior one of the propagation constants in the
|
||||||
* TransactionDefinition interface
|
* TransactionDefinition interface
|
||||||
|
|
|
||||||
|
|
@ -51,7 +51,7 @@ import org.springframework.util.ClassUtils;
|
||||||
* HttpMessageConverter} that can read and write XML using JAXB2.
|
* HttpMessageConverter} that can read and write XML using JAXB2.
|
||||||
*
|
*
|
||||||
* <p>This converter can read classes annotated with {@link XmlRootElement} and
|
* <p>This converter can read classes annotated with {@link XmlRootElement} and
|
||||||
* {@link XmlType}, and write classes annotated with with {@link XmlRootElement},
|
* {@link XmlType}, and write classes annotated with {@link XmlRootElement},
|
||||||
* or subclasses thereof.
|
* or subclasses thereof.
|
||||||
*
|
*
|
||||||
* <p>Note that if using Spring's Marshaller/Unmarshaller abstractions from the
|
* <p>Note that if using Spring's Marshaller/Unmarshaller abstractions from the
|
||||||
|
|
|
||||||
|
|
@ -29,7 +29,7 @@ import org.springframework.core.annotation.AliasFor;
|
||||||
*
|
*
|
||||||
* <p>By default, all origins and headers are permitted.
|
* <p>By default, all origins and headers are permitted.
|
||||||
*
|
*
|
||||||
* <p><b>NOTE:</b> {@code @CrossOrigin} will only be processed if an an appropriate
|
* <p><b>NOTE:</b> {@code @CrossOrigin} will only be processed if an appropriate
|
||||||
* {@code HandlerMapping}-{@code HandlerAdapter} pair is configured such as the
|
* {@code HandlerMapping}-{@code HandlerAdapter} pair is configured such as the
|
||||||
* {@code RequestMappingHandlerMapping}-{@code RequestMappingHandlerAdapter} pair
|
* {@code RequestMappingHandlerMapping}-{@code RequestMappingHandlerAdapter} pair
|
||||||
* which are the default in the MVC Java config and the MVC namespace.
|
* which are the default in the MVC Java config and the MVC namespace.
|
||||||
|
|
|
||||||
|
|
@ -25,7 +25,7 @@ import org.springframework.web.context.request.NativeWebRequest;
|
||||||
*
|
*
|
||||||
* <p>A {@code DeferredResultProcessingInterceptor} is invoked before the start
|
* <p>A {@code DeferredResultProcessingInterceptor} is invoked before the start
|
||||||
* of async processing, after the {@code DeferredResult} is set as well as on
|
* of async processing, after the {@code DeferredResult} is set as well as on
|
||||||
* timeout, or or after completing for any reason including a timeout or network
|
* timeout, or after completing for any reason including a timeout or network
|
||||||
* error.
|
* error.
|
||||||
*
|
*
|
||||||
* <p>As a general rule exceptions raised by interceptor methods will cause
|
* <p>As a general rule exceptions raised by interceptor methods will cause
|
||||||
|
|
|
||||||
|
|
@ -82,7 +82,7 @@ public class RequestParamMethodArgumentResolver extends AbstractNamedValueMethod
|
||||||
/**
|
/**
|
||||||
* @param useDefaultResolution in default resolution mode a method argument
|
* @param useDefaultResolution in default resolution mode a method argument
|
||||||
* that is a simple type, as defined in {@link BeanUtils#isSimpleProperty},
|
* that is a simple type, as defined in {@link BeanUtils#isSimpleProperty},
|
||||||
* is treated as a request parameter even if it it isn't annotated, the
|
* is treated as a request parameter even if it isn't annotated, the
|
||||||
* request parameter name is derived from the method parameter name.
|
* request parameter name is derived from the method parameter name.
|
||||||
*/
|
*/
|
||||||
public RequestParamMethodArgumentResolver(boolean useDefaultResolution) {
|
public RequestParamMethodArgumentResolver(boolean useDefaultResolution) {
|
||||||
|
|
@ -95,7 +95,7 @@ public class RequestParamMethodArgumentResolver extends AbstractNamedValueMethod
|
||||||
* values are not expected to contain expressions
|
* values are not expected to contain expressions
|
||||||
* @param useDefaultResolution in default resolution mode a method argument
|
* @param useDefaultResolution in default resolution mode a method argument
|
||||||
* that is a simple type, as defined in {@link BeanUtils#isSimpleProperty},
|
* that is a simple type, as defined in {@link BeanUtils#isSimpleProperty},
|
||||||
* is treated as a request parameter even if it it isn't annotated, the
|
* is treated as a request parameter even if it isn't annotated, the
|
||||||
* request parameter name is derived from the method parameter name.
|
* request parameter name is derived from the method parameter name.
|
||||||
*/
|
*/
|
||||||
public RequestParamMethodArgumentResolver(ConfigurableBeanFactory beanFactory, boolean useDefaultResolution) {
|
public RequestParamMethodArgumentResolver(ConfigurableBeanFactory beanFactory, boolean useDefaultResolution) {
|
||||||
|
|
|
||||||
|
|
@ -182,7 +182,7 @@ public class ModelAndViewContainer {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Provide a separate model instance to use in a redirect scenario.
|
* Provide a separate model instance to use in a redirect scenario.
|
||||||
* The provided additional model however is not used used unless
|
* The provided additional model however is not used unless
|
||||||
* {@link #setRedirectModelScenario(boolean)} gets set to {@code true} to signal
|
* {@link #setRedirectModelScenario(boolean)} gets set to {@code true} to signal
|
||||||
* a redirect scenario.
|
* a redirect scenario.
|
||||||
*/
|
*/
|
||||||
|
|
|
||||||
|
|
@ -100,7 +100,7 @@ public class PortletRequestHandledEvent extends RequestHandledEvent {
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Return the the type of Portlet Request ('action' or 'render').
|
* Return the type of Portlet Request ('action' or 'render').
|
||||||
*/
|
*/
|
||||||
public String getRequestType() {
|
public String getRequestType() {
|
||||||
return this.requestType;
|
return this.requestType;
|
||||||
|
|
|
||||||
|
|
@ -153,7 +153,7 @@ public class ServletWrappingController extends AbstractController
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Invoke the the wrapped Servlet instance.
|
* Invoke the wrapped Servlet instance.
|
||||||
* @see javax.servlet.Servlet#service(javax.servlet.ServletRequest, javax.servlet.ServletResponse)
|
* @see javax.servlet.Servlet#service(javax.servlet.ServletRequest, javax.servlet.ServletResponse)
|
||||||
*/
|
*/
|
||||||
@Override
|
@Override
|
||||||
|
|
|
||||||
|
|
@ -304,7 +304,7 @@ public class MvcUriComponentsBuilder {
|
||||||
* <p>Note that it's not necessary to specify all arguments. Only the ones
|
* <p>Note that it's not necessary to specify all arguments. Only the ones
|
||||||
* required to prepare the URL, mainly {@code @RequestParam} and {@code @PathVariable}).
|
* required to prepare the URL, mainly {@code @RequestParam} and {@code @PathVariable}).
|
||||||
* @param mappingName the mapping name
|
* @param mappingName the mapping name
|
||||||
* @return a builder to to prepare the URI String
|
* @return a builder to prepare the URI String
|
||||||
* @throws IllegalArgumentException if the mapping name is not found or
|
* @throws IllegalArgumentException if the mapping name is not found or
|
||||||
* if there is no unique match
|
* if there is no unique match
|
||||||
* @since 4.1
|
* @since 4.1
|
||||||
|
|
@ -321,7 +321,7 @@ public class MvcUriComponentsBuilder {
|
||||||
* @param builder the builder for the base URL; the builder will be cloned
|
* @param builder the builder for the base URL; the builder will be cloned
|
||||||
* and therefore not modified and may be re-used for further calls.
|
* and therefore not modified and may be re-used for further calls.
|
||||||
* @param name the mapping name
|
* @param name the mapping name
|
||||||
* @return a builder to to prepare the URI String
|
* @return a builder to prepare the URI String
|
||||||
* @throws IllegalArgumentException if the mapping name is not found or
|
* @throws IllegalArgumentException if the mapping name is not found or
|
||||||
* if there is no unique match
|
* if there is no unique match
|
||||||
* @since 4.2
|
* @since 4.2
|
||||||
|
|
|
||||||
|
|
@ -198,7 +198,7 @@ public abstract class RequestContextUtils {
|
||||||
* <p>Consider using {@link org.springframework.context.i18n.LocaleContextHolder#getTimeZone()}
|
* <p>Consider using {@link org.springframework.context.i18n.LocaleContextHolder#getTimeZone()}
|
||||||
* which will normally be populated with the same TimeZone: That method only
|
* which will normally be populated with the same TimeZone: That method only
|
||||||
* differs in terms of its fallback to the system time zone if the LocaleResolver
|
* differs in terms of its fallback to the system time zone if the LocaleResolver
|
||||||
* hasn't provided provided a specific time zone (instead of this method's {@code null}).
|
* hasn't provided a specific time zone (instead of this method's {@code null}).
|
||||||
* @param request current HTTP request
|
* @param request current HTTP request
|
||||||
* @return the current time zone for the given request, either from the
|
* @return the current time zone for the given request, either from the
|
||||||
* TimeZoneAwareLocaleResolver or {@code null} if none associated
|
* TimeZoneAwareLocaleResolver or {@code null} if none associated
|
||||||
|
|
|
||||||
|
|
@ -38,7 +38,7 @@ import org.springframework.web.bind.WebDataBinder;
|
||||||
* the bound {@link Collection}.
|
* the bound {@link Collection}.
|
||||||
* <h3>Approach Three</h3>
|
* <h3>Approach Three</h3>
|
||||||
* For any other bound value type, the '{@code input(checkbox)}' is marked as 'checked'
|
* For any other bound value type, the '{@code input(checkbox)}' is marked as 'checked'
|
||||||
* if the the configured {@link #setValue(Object) value} is equal to the bound value.
|
* if the configured {@link #setValue(Object) value} is equal to the bound value.
|
||||||
*
|
*
|
||||||
* @author Rob Harrop
|
* @author Rob Harrop
|
||||||
* @author Juergen Hoeller
|
* @author Juergen Hoeller
|
||||||
|
|
|
||||||
|
|
@ -54,7 +54,7 @@ public class GroovyMarkupView extends AbstractTemplateView {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Set the MarkupTemplateEngine to use in this view.
|
* Set the MarkupTemplateEngine to use in this view.
|
||||||
* <p>If not set, the engine is auto-detected by looking up up a single
|
* <p>If not set, the engine is auto-detected by looking up a single
|
||||||
* {@link GroovyMarkupConfig} bean in the web application context and using
|
* {@link GroovyMarkupConfig} bean in the web application context and using
|
||||||
* it to obtain the configured {@code MarkupTemplateEngine} instance.
|
* it to obtain the configured {@code MarkupTemplateEngine} instance.
|
||||||
* @see GroovyMarkupConfig
|
* @see GroovyMarkupConfig
|
||||||
|
|
|
||||||
|
|
@ -170,7 +170,7 @@ public class JasperReportsMultiFormatView extends AbstractJasperReportsView {
|
||||||
|
|
||||||
String format = (String) model.get(this.formatKey);
|
String format = (String) model.get(this.formatKey);
|
||||||
if (format == null) {
|
if (format == null) {
|
||||||
throw new IllegalArgumentException("No format format found in model");
|
throw new IllegalArgumentException("No format found in model");
|
||||||
}
|
}
|
||||||
|
|
||||||
if (logger.isDebugEnabled()) {
|
if (logger.isDebugEnabled()) {
|
||||||
|
|
|
||||||
|
|
@ -55,7 +55,7 @@ import org.springframework.web.servlet.view.AbstractUrlBasedView;
|
||||||
* An {@link AbstractUrlBasedView} subclass designed to run any template library
|
* An {@link AbstractUrlBasedView} subclass designed to run any template library
|
||||||
* based on a JSR-223 script engine.
|
* based on a JSR-223 script engine.
|
||||||
*
|
*
|
||||||
* <p>If not set, each property is auto-detected by looking up up a single
|
* <p>If not set, each property is auto-detected by looking up a single
|
||||||
* {@link ScriptTemplateConfig} bean in the web application context and using
|
* {@link ScriptTemplateConfig} bean in the web application context and using
|
||||||
* it to obtain the configured properties.
|
* it to obtain the configured properties.
|
||||||
*
|
*
|
||||||
|
|
|
||||||
|
|
@ -126,7 +126,7 @@ public class PathMatchingUrlHandlerMappingTests {
|
||||||
hec = getHandler(req);
|
hec = getHandler(req);
|
||||||
assertTrue("Handler is correct bean", hec != null && hec.getHandler() == bean);
|
assertTrue("Handler is correct bean", hec != null && hec.getHandler() == bean);
|
||||||
|
|
||||||
// should match because because exact pattern is there
|
// should match because exact pattern is there
|
||||||
req = new MockHttpServletRequest("GET", "/administrator/another/bla.xml");
|
req = new MockHttpServletRequest("GET", "/administrator/another/bla.xml");
|
||||||
hec = getHandler(req);
|
hec = getHandler(req);
|
||||||
assertTrue("Handler is correct bean", hec != null && hec.getHandler() == bean);
|
assertTrue("Handler is correct bean", hec != null && hec.getHandler() == bean);
|
||||||
|
|
|
||||||
|
|
@ -133,7 +133,7 @@ public class ServletInvocableHandlerMethodTests {
|
||||||
ServletInvocableHandlerMethod handlerMethod = getHandlerMethod(new Handler(), "responseStatusWithReason");
|
ServletInvocableHandlerMethod handlerMethod = getHandlerMethod(new Handler(), "responseStatusWithReason");
|
||||||
handlerMethod.invokeAndHandle(this.webRequest, this.mavContainer);
|
handlerMethod.invokeAndHandle(this.webRequest, this.mavContainer);
|
||||||
|
|
||||||
assertTrue("When a status reason w/ used, the the request is handled", this.mavContainer.isRequestHandled());
|
assertTrue("When a status reason w/ used, the request is handled", this.mavContainer.isRequestHandled());
|
||||||
assertEquals(HttpStatus.BAD_REQUEST.value(), this.response.getStatus());
|
assertEquals(HttpStatus.BAD_REQUEST.value(), this.response.getStatus());
|
||||||
assertEquals("400 Bad Request", this.response.getErrorMessage());
|
assertEquals("400 Bad Request", this.response.getErrorMessage());
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -36,7 +36,7 @@ import org.springframework.web.socket.sockjs.transport.handler.WebSocketTranspor
|
||||||
import java.util.ArrayList;
|
import java.util.ArrayList;
|
||||||
import java.util.List;
|
import java.util.List;
|
||||||
/**
|
/**
|
||||||
* An abstract base class class for configuring STOMP over WebSocket/SockJS endpoints.
|
* An abstract base class for configuring STOMP over WebSocket/SockJS endpoints.
|
||||||
*
|
*
|
||||||
* @author Rossen Stoyanchev
|
* @author Rossen Stoyanchev
|
||||||
* @since 4.0
|
* @since 4.0
|
||||||
|
|
|
||||||
|
|
@ -25,7 +25,7 @@ import org.springframework.messaging.Message;
|
||||||
* (e.g. STOMP) as the WebSocket sub-protocol issues a connect request.
|
* (e.g. STOMP) as the WebSocket sub-protocol issues a connect request.
|
||||||
*
|
*
|
||||||
* <p>Note that this is not the same as the WebSocket session getting established
|
* <p>Note that this is not the same as the WebSocket session getting established
|
||||||
* but rather the client's first attempt to connect within the the sub-protocol,
|
* but rather the client's first attempt to connect within the sub-protocol,
|
||||||
* for example sending the STOMP CONNECT frame.
|
* for example sending the STOMP CONNECT frame.
|
||||||
*
|
*
|
||||||
* @author Rossen Stoyanchev
|
* @author Rossen Stoyanchev
|
||||||
|
|
|
||||||
|
|
@ -349,7 +349,7 @@
|
||||||
This is essentially the "Unbounded queues" strategy as explained in java.util.concurrent.ThreadPoolExecutor.
|
This is essentially the "Unbounded queues" strategy as explained in java.util.concurrent.ThreadPoolExecutor.
|
||||||
When this strategy is used, the max pool size is effectively ignored.
|
When this strategy is used, the max pool size is effectively ignored.
|
||||||
By default this is set to twice the value of Runtime.availableProcessors().
|
By default this is set to twice the value of Runtime.availableProcessors().
|
||||||
In an an application where tasks do not block frequently,
|
In an application where tasks do not block frequently,
|
||||||
the number should be closer to or equal to the number of available CPUs/cores.
|
the number should be closer to or equal to the number of available CPUs/cores.
|
||||||
]]></xsd:documentation>
|
]]></xsd:documentation>
|
||||||
</xsd:annotation>
|
</xsd:annotation>
|
||||||
|
|
|
||||||
|
|
@ -367,7 +367,7 @@
|
||||||
This is essentially the "Unbounded queues" strategy as explained in java.util.concurrent.ThreadPoolExecutor.
|
This is essentially the "Unbounded queues" strategy as explained in java.util.concurrent.ThreadPoolExecutor.
|
||||||
When this strategy is used, the max pool size is effectively ignored.
|
When this strategy is used, the max pool size is effectively ignored.
|
||||||
By default this is set to twice the value of Runtime.availableProcessors().
|
By default this is set to twice the value of Runtime.availableProcessors().
|
||||||
In an an application where tasks do not block frequently,
|
In an application where tasks do not block frequently,
|
||||||
the number should be closer to or equal to the number of available CPUs/cores.
|
the number should be closer to or equal to the number of available CPUs/cores.
|
||||||
]]></xsd:documentation>
|
]]></xsd:documentation>
|
||||||
</xsd:annotation>
|
</xsd:annotation>
|
||||||
|
|
|
||||||
|
|
@ -407,7 +407,7 @@
|
||||||
This is essentially the "Unbounded queues" strategy as explained in java.util.concurrent.ThreadPoolExecutor.
|
This is essentially the "Unbounded queues" strategy as explained in java.util.concurrent.ThreadPoolExecutor.
|
||||||
When this strategy is used, the max pool size is effectively ignored.
|
When this strategy is used, the max pool size is effectively ignored.
|
||||||
By default this is set to twice the value of Runtime.availableProcessors().
|
By default this is set to twice the value of Runtime.availableProcessors().
|
||||||
In an an application where tasks do not block frequently,
|
In an application where tasks do not block frequently,
|
||||||
the number should be closer to or equal to the number of available CPUs/cores.
|
the number should be closer to or equal to the number of available CPUs/cores.
|
||||||
]]></xsd:documentation>
|
]]></xsd:documentation>
|
||||||
</xsd:annotation>
|
</xsd:annotation>
|
||||||
|
|
|
||||||
|
|
@ -407,7 +407,7 @@
|
||||||
This is essentially the "Unbounded queues" strategy as explained in java.util.concurrent.ThreadPoolExecutor.
|
This is essentially the "Unbounded queues" strategy as explained in java.util.concurrent.ThreadPoolExecutor.
|
||||||
When this strategy is used, the max pool size is effectively ignored.
|
When this strategy is used, the max pool size is effectively ignored.
|
||||||
By default this is set to twice the value of Runtime.availableProcessors().
|
By default this is set to twice the value of Runtime.availableProcessors().
|
||||||
In an an application where tasks do not block frequently,
|
In an application where tasks do not block frequently,
|
||||||
the number should be closer to or equal to the number of available CPUs/cores.
|
the number should be closer to or equal to the number of available CPUs/cores.
|
||||||
]]></xsd:documentation>
|
]]></xsd:documentation>
|
||||||
</xsd:annotation>
|
</xsd:annotation>
|
||||||
|
|
|
||||||
|
|
@ -1317,7 +1317,7 @@ See <<mvc-config-conversion>> in the Spring MVC chapter.
|
||||||
[[format-configuring-formatting-globaldatetimeformat]]
|
[[format-configuring-formatting-globaldatetimeformat]]
|
||||||
== Configuring a global date & time format
|
== Configuring a global date & time format
|
||||||
By default, date and time fields that are not annotated with `@DateTimeFormat` are
|
By default, date and time fields that are not annotated with `@DateTimeFormat` are
|
||||||
converted from strings using the the `DateFormat.SHORT` style. If you prefer, you can
|
converted from strings using the `DateFormat.SHORT` style. If you prefer, you can
|
||||||
change this by defining your own global format.
|
change this by defining your own global format.
|
||||||
|
|
||||||
You will need to ensure that Spring does not register default formatters, and instead
|
You will need to ensure that Spring does not register default formatters, and instead
|
||||||
|
|
|
||||||
|
|
@ -3435,7 +3435,7 @@ The batch update methods for this call returns an array of int arrays containing
|
||||||
entry for each batch with an array of the number of affected rows for each update. The top
|
entry for each batch with an array of the number of affected rows for each update. The top
|
||||||
level array's length indicates the number of batches executed and the second level array's
|
level array's length indicates the number of batches executed and the second level array's
|
||||||
length indicates the number of updates in that batch. The number of updates in each batch
|
length indicates the number of updates in that batch. The number of updates in each batch
|
||||||
should be the the batch size provided for all batches except for the last one that might
|
should be the batch size provided for all batches except for the last one that might
|
||||||
be less, depending on the total number of update objects provided. The update count for
|
be less, depending on the total number of update objects provided. The update count for
|
||||||
each update statement is the one reported by the JDBC driver. If the count is not
|
each update statement is the one reported by the JDBC driver. If the count is not
|
||||||
available, the JDBC driver returns a -2 value.
|
available, the JDBC driver returns a -2 value.
|
||||||
|
|
|
||||||
|
|
@ -260,7 +260,7 @@ container-managed transactions. All your custom business logic can be implemente
|
||||||
simple POJOs and managed by Spring's IoC container. Additional services include support
|
simple POJOs and managed by Spring's IoC container. Additional services include support
|
||||||
for sending email and validation that is independent of the web layer, which lets you
|
for sending email and validation that is independent of the web layer, which lets you
|
||||||
choose where to execute validation rules. Spring's ORM support is integrated with JPA,
|
choose where to execute validation rules. Spring's ORM support is integrated with JPA,
|
||||||
Hibernate and and JDO; for example, when using Hibernate, you can continue to use
|
Hibernate and JDO; for example, when using Hibernate, you can continue to use
|
||||||
your existing mapping files and standard Hibernate `SessionFactory` configuration. Form
|
your existing mapping files and standard Hibernate `SessionFactory` configuration. Form
|
||||||
controllers seamlessly integrate the web-layer with the domain model, removing the need
|
controllers seamlessly integrate the web-layer with the domain model, removing the need
|
||||||
for `ActionForms` or other classes that transform HTTP parameters to values for your
|
for `ActionForms` or other classes that transform HTTP parameters to values for your
|
||||||
|
|
|
||||||
|
|
@ -3592,7 +3592,7 @@ manual, the javadocs for `@SqlConfig` and `SqlScriptsTestExecutionListener` prov
|
||||||
detailed information, and the following example demonstrates a typical testing scenario
|
detailed information, and the following example demonstrates a typical testing scenario
|
||||||
using JUnit and transactional tests with `@Sql`. Note that there is no need to clean up
|
using JUnit and transactional tests with `@Sql`. Note that there is no need to clean up
|
||||||
the database after the `usersTest()` method is executed since any changes made to the
|
the database after the `usersTest()` method is executed since any changes made to the
|
||||||
database (either within the the test method or within the `/test-data.sql` script) will
|
database (either within the test method or within the `/test-data.sql` script) will
|
||||||
be automatically rolled back by the `TransactionalTestExecutionListener` (see
|
be automatically rolled back by the `TransactionalTestExecutionListener` (see
|
||||||
<<testcontext-tx,transaction management>> for details).
|
<<testcontext-tx,transaction management>> for details).
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1300,7 +1300,7 @@ multiple requests are allowed to access a session concurrently.
|
||||||
methods and/or the HandlerAdapter configuration. See the `webBindingInitializer`
|
methods and/or the HandlerAdapter configuration. See the `webBindingInitializer`
|
||||||
property on `RequestMappingHandlerAdapter`. Such command objects along with their
|
property on `RequestMappingHandlerAdapter`. Such command objects along with their
|
||||||
validation results will be exposed as model attributes by default, using the command
|
validation results will be exposed as model attributes by default, using the command
|
||||||
class class name - e.g. model attribute "orderAddress" for a command object of type
|
class name - e.g. model attribute "orderAddress" for a command object of type
|
||||||
"some.package.OrderAddress". The `ModelAttribute` annotation can be used on a method
|
"some.package.OrderAddress". The `ModelAttribute` annotation can be used on a method
|
||||||
argument to customize the model attribute name used.
|
argument to customize the model attribute name used.
|
||||||
* `org.springframework.validation.Errors` /
|
* `org.springframework.validation.Errors` /
|
||||||
|
|
@ -1685,7 +1685,7 @@ Given the above example where can the Pet instance come from? There are several
|
||||||
more detail below).
|
more detail below).
|
||||||
* It may be instantiated using its default constructor.
|
* It may be instantiated using its default constructor.
|
||||||
|
|
||||||
An `@ModelAttribute` method is a common way to to retrieve an attribute from the
|
An `@ModelAttribute` method is a common way to retrieve an attribute from the
|
||||||
database, which may optionally be stored between requests through the use of
|
database, which may optionally be stored between requests through the use of
|
||||||
`@SessionAttributes`. In some cases it may be convenient to retrieve the attribute by
|
`@SessionAttributes`. In some cases it may be convenient to retrieve the attribute by
|
||||||
using an URI template variable and a type converter. Here is an example:
|
using an URI template variable and a type converter. Here is an example:
|
||||||
|
|
@ -3929,7 +3929,7 @@ raised the status code may indicate a client error (4xx) or a server error (5xx)
|
||||||
|
|
||||||
The `DefaultHandlerExceptionResolver` translates Spring MVC exceptions to specific error
|
The `DefaultHandlerExceptionResolver` translates Spring MVC exceptions to specific error
|
||||||
status codes. It is registered by default with the MVC namespace, the MVC Java config,
|
status codes. It is registered by default with the MVC namespace, the MVC Java config,
|
||||||
and also by the the `DispatcherServlet` (i.e. when not using the MVC namespace or Java
|
and also by the `DispatcherServlet` (i.e. when not using the MVC namespace or Java
|
||||||
config). Listed below are some of the exceptions handled by this resolver and the
|
config). Listed below are some of the exceptions handled by this resolver and the
|
||||||
corresponding status codes:
|
corresponding status codes:
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -34,7 +34,7 @@ is another view technology, supported by Spring. This template engine is a templ
|
||||||
aimed at generating XML-like markup (XML, XHTML, HTML5, ...), but that can be used to generate any
|
aimed at generating XML-like markup (XML, XHTML, HTML5, ...), but that can be used to generate any
|
||||||
text based content.
|
text based content.
|
||||||
|
|
||||||
This requires Groovy 2.3.1+ on the the classpath.
|
This requires Groovy 2.3.1+ on the classpath.
|
||||||
|
|
||||||
[[view-groovymarkup-configuration]]
|
[[view-groovymarkup-configuration]]
|
||||||
=== Configuration
|
=== Configuration
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue