diff --git a/spring-aop/src/main/java/org/springframework/aop/interceptor/AsyncExecutionInterceptor.java b/spring-aop/src/main/java/org/springframework/aop/interceptor/AsyncExecutionInterceptor.java index 6039ce304cd..1cc6f8e0221 100644 --- a/spring-aop/src/main/java/org/springframework/aop/interceptor/AsyncExecutionInterceptor.java +++ b/spring-aop/src/main/java/org/springframework/aop/interceptor/AsyncExecutionInterceptor.java @@ -32,7 +32,7 @@ import org.springframework.util.ReflectionUtils; /** * AOP Alliance MethodInterceptor that processes method invocations * asynchronously, using a given {@link org.springframework.core.task.AsyncTaskExecutor}. - * Typically used with the {@link org.springframework.context.task.Async} annotation. + * Typically used with the {@link org.springframework.scheduling.annotation.Async} annotation. * *

In terms of target method signatures, any parameter types are supported. * However, the return type is constrained to either void or diff --git a/spring-aop/src/main/java/org/springframework/aop/target/AbstractPrototypeBasedTargetSource.java b/spring-aop/src/main/java/org/springframework/aop/target/AbstractPrototypeBasedTargetSource.java index 83c8083e5b7..f2677afbc21 100644 --- a/spring-aop/src/main/java/org/springframework/aop/target/AbstractPrototypeBasedTargetSource.java +++ b/spring-aop/src/main/java/org/springframework/aop/target/AbstractPrototypeBasedTargetSource.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -28,8 +28,9 @@ import org.springframework.beans.factory.DisposableBean; import org.springframework.beans.factory.config.ConfigurableBeanFactory; /** - * Base class for dynamic {@link TargetSource} implementations that create new prototype - * bean instances to support a pooling or new-instance-per-invocation strategy. + * Base class for dynamic {@link org.springframework.aop.TargetSource} implementations + * that create new prototype bean instances to support a pooling or + * new-instance-per-invocation strategy. * *

Such TargetSources must run in a {@link BeanFactory}, as it needs to * call the getBean method to create a new prototype instance. diff --git a/spring-aspects/src/main/java/org/springframework/scheduling/aspectj/AspectJAsyncConfiguration.java b/spring-aspects/src/main/java/org/springframework/scheduling/aspectj/AspectJAsyncConfiguration.java index d9d677a5709..c2df8e984db 100644 --- a/spring-aspects/src/main/java/org/springframework/scheduling/aspectj/AspectJAsyncConfiguration.java +++ b/spring-aspects/src/main/java/org/springframework/scheduling/aspectj/AspectJAsyncConfiguration.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -31,7 +31,7 @@ import org.springframework.scheduling.annotation.EnableAsync; * @author Chris Beams * @since 3.1 * @see EnableAsync - * @see AsyncConfigurationSelector + * @see org.springframework.scheduling.annotation.AsyncConfigurationSelector */ @Configuration public class AspectJAsyncConfiguration extends AbstractAsyncConfiguration { diff --git a/spring-beans/src/main/java/org/springframework/beans/factory/annotation/Autowired.java b/spring-beans/src/main/java/org/springframework/beans/factory/annotation/Autowired.java index 2c815be9886..066dd11da52 100644 --- a/spring-beans/src/main/java/org/springframework/beans/factory/annotation/Autowired.java +++ b/spring-beans/src/main/java/org/springframework/beans/factory/annotation/Autowired.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -39,7 +39,7 @@ import java.lang.annotation.Target; * a special case of such a general config method. Such config methods * do not have to be public. * - *

In the case of multiple argument methods, the 'required' parameter is + *

In the case of multiple argument methods, the 'required' parameter is * applicable for all arguments. * *

In case of a {@link java.util.Collection} or {@link java.util.Map} @@ -52,8 +52,9 @@ import java.lang.annotation.Target; * BeanPostProcessor} which in turn means that you cannot * use {@code @Autowired} to inject references into * {@link org.springframework.beans.factory.config.BeanPostProcessor - * BeanPostProcessor} or {@link BeanFactoryPostProcessor} types. Please - * consult the javadoc for the {@link AutowiredAnnotationBeanPostProcessor} + * BeanPostProcessor} or + * {@link org.springframework.beans.factory.config.BeanFactoryPostProcessor BeanFactoryPostProcessor} + * types. Please consult the javadoc for the {@link AutowiredAnnotationBeanPostProcessor} * class (which, by default, checks for the presence of this annotation). * * @author Juergen Hoeller diff --git a/spring-beans/src/main/java/org/springframework/beans/factory/annotation/Value.java b/spring-beans/src/main/java/org/springframework/beans/factory/annotation/Value.java index 2136666cfbd..eb257fdfcb1 100644 --- a/spring-beans/src/main/java/org/springframework/beans/factory/annotation/Value.java +++ b/spring-beans/src/main/java/org/springframework/beans/factory/annotation/Value.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -37,8 +37,9 @@ import java.lang.annotation.Target; * BeanPostProcessor} which in turn means that you cannot use * {@code @Value} within * {@link org.springframework.beans.factory.config.BeanPostProcessor - * BeanPostProcessor} or {@link BeanFactoryPostProcessor} types. Please - * consult the javadoc for the {@link AutowiredAnnotationBeanPostProcessor} + * BeanPostProcessor} or + * {@link org.springframework.beans.factory.config.BeanFactoryPostProcessor BeanFactoryPostProcessor} + * types. Please consult the javadoc for the {@link AutowiredAnnotationBeanPostProcessor} * class (which, by default, checks for the presence of this annotation). * * @author Juergen Hoeller diff --git a/spring-beans/src/main/java/org/springframework/beans/factory/config/PlaceholderConfigurerSupport.java b/spring-beans/src/main/java/org/springframework/beans/factory/config/PlaceholderConfigurerSupport.java index ddf060283c4..2f6bd6865a1 100644 --- a/spring-beans/src/main/java/org/springframework/beans/factory/config/PlaceholderConfigurerSupport.java +++ b/spring-beans/src/main/java/org/springframework/beans/factory/config/PlaceholderConfigurerSupport.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -36,8 +36,8 @@ import org.springframework.util.StringValueResolver; * *

{@code
  *
- *    
- *    
+ *    
+ *    
  *
  *}
* @@ -76,7 +76,7 @@ import org.springframework.util.StringValueResolver; *

Example XML property with default value: * *

{@code
- *  
+ *  
  *}
* * @author Chris Beams diff --git a/spring-beans/src/main/java/org/springframework/beans/factory/xml/BeanDefinitionParserDelegate.java b/spring-beans/src/main/java/org/springframework/beans/factory/xml/BeanDefinitionParserDelegate.java index b63652e79ff..df22acc2f49 100644 --- a/spring-beans/src/main/java/org/springframework/beans/factory/xml/BeanDefinitionParserDelegate.java +++ b/spring-beans/src/main/java/org/springframework/beans/factory/xml/BeanDefinitionParserDelegate.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -353,7 +353,7 @@ public class BeanDefinitionParserDelegate { * parentDefaults in case the defaults are not explicitly set * locally. * @param defaults the defaults to populate - * @param defaults the parent BeanDefinitionParserDelegate (if any) defaults to fall back to + * @param parentDefaults the parent BeanDefinitionParserDelegate (if any) defaults to fall back to * @param root the root element of the current bean definition document (or nested beans element) */ protected void populateDefaults(DocumentDefaultsDefinition defaults, DocumentDefaultsDefinition parentDefaults, Element root) { diff --git a/spring-beans/src/main/java/org/springframework/beans/support/ResourceEditorRegistrar.java b/spring-beans/src/main/java/org/springframework/beans/support/ResourceEditorRegistrar.java index b1c537ed392..bcf6c8931c9 100644 --- a/spring-beans/src/main/java/org/springframework/beans/support/ResourceEditorRegistrar.java +++ b/spring-beans/src/main/java/org/springframework/beans/support/ResourceEditorRegistrar.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -34,7 +34,6 @@ import org.springframework.beans.propertyeditors.InputSourceEditor; import org.springframework.beans.propertyeditors.InputStreamEditor; import org.springframework.beans.propertyeditors.URIEditor; import org.springframework.beans.propertyeditors.URLEditor; -import org.springframework.core.env.Environment; import org.springframework.core.env.PropertyResolver; import org.springframework.core.env.StandardEnvironment; import org.springframework.core.io.ContextResource; @@ -71,7 +70,7 @@ public class ResourceEditorRegistrar implements PropertyEditorRegistrar { * @see org.springframework.core.io.support.ResourcePatternResolver * @see org.springframework.context.ApplicationContext * @deprecated as of Spring 3.1 in favor of - * {@link #ResourceEditorRegistrar(ResourceLoader, Environment)} + * {@link #ResourceEditorRegistrar(ResourceLoader, PropertyResolver)} */ @Deprecated public ResourceEditorRegistrar(ResourceLoader resourceLoader) { diff --git a/spring-context-support/src/main/java/org/springframework/scheduling/quartz/CronTriggerFactoryBean.java b/spring-context-support/src/main/java/org/springframework/scheduling/quartz/CronTriggerFactoryBean.java index a8294f05d41..eb2644c5f7f 100644 --- a/spring-context-support/src/main/java/org/springframework/scheduling/quartz/CronTriggerFactoryBean.java +++ b/spring-context-support/src/main/java/org/springframework/scheduling/quartz/CronTriggerFactoryBean.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -56,9 +56,7 @@ import org.springframework.util.ReflectionUtils; * @since 3.1 * @see #setName * @see #setGroup - * @see #setStartTime - * @see #setJobName - * @see #setJobGroup + * @see #setStartDelay * @see #setJobDetail * @see org.springframework.scheduling.quartz.SchedulerFactoryBean#setTriggers * @see org.springframework.scheduling.quartz.SchedulerFactoryBean#setJobDetails diff --git a/spring-context-support/src/main/java/org/springframework/scheduling/quartz/SimpleTriggerFactoryBean.java b/spring-context-support/src/main/java/org/springframework/scheduling/quartz/SimpleTriggerFactoryBean.java index c26b0d00424..9de19249487 100644 --- a/spring-context-support/src/main/java/org/springframework/scheduling/quartz/SimpleTriggerFactoryBean.java +++ b/spring-context-support/src/main/java/org/springframework/scheduling/quartz/SimpleTriggerFactoryBean.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -56,9 +56,7 @@ import org.springframework.util.ReflectionUtils; * @since 3.1 * @see #setName * @see #setGroup - * @see #setStartTime - * @see #setJobName - * @see #setJobGroup + * @see #setStartDelay * @see #setJobDetail * @see org.springframework.scheduling.quartz.SchedulerFactoryBean#setTriggers * @see org.springframework.scheduling.quartz.SchedulerFactoryBean#setJobDetails diff --git a/spring-context/src/main/java/org/springframework/cache/annotation/CacheAnnotationParser.java b/spring-context/src/main/java/org/springframework/cache/annotation/CacheAnnotationParser.java index f6757adb5ae..a1d8a79c808 100644 --- a/spring-context/src/main/java/org/springframework/cache/annotation/CacheAnnotationParser.java +++ b/spring-context/src/main/java/org/springframework/cache/annotation/CacheAnnotationParser.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -41,7 +41,7 @@ public interface CacheAnnotationParser { * @param ae the annotated method or class * @return CacheOperation the configured caching operation, * or {@code null} if none was found - * @see AnnotationCacheOperationSource#determineCacheOperation + * @see AnnotationCacheOperationSource#determineCacheOperations(AnnotatedElement) */ Collection parseCacheAnnotations(AnnotatedElement ae); } diff --git a/spring-context/src/main/java/org/springframework/cache/annotation/CachingConfigurationSelector.java b/spring-context/src/main/java/org/springframework/cache/annotation/CachingConfigurationSelector.java index df8be605cc1..33c4a120a76 100644 --- a/spring-context/src/main/java/org/springframework/cache/annotation/CachingConfigurationSelector.java +++ b/spring-context/src/main/java/org/springframework/cache/annotation/CachingConfigurationSelector.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -30,7 +30,7 @@ import org.springframework.context.annotation.AutoProxyRegistrar; * @since 3.1 * @see EnableCaching * @see ProxyCachingConfiguration - * @see AnnotationConfigUtils.CACHE_ASPECT_CONFIGURATION_CLASS_NAME + * @see AnnotationConfigUtils#CACHE_ASPECT_CONFIGURATION_CLASS_NAME */ public class CachingConfigurationSelector extends AdviceModeImportSelector { diff --git a/spring-context/src/main/java/org/springframework/cache/annotation/EnableCaching.java b/spring-context/src/main/java/org/springframework/cache/annotation/EnableCaching.java index a054afa6f7b..771487a56ff 100644 --- a/spring-context/src/main/java/org/springframework/cache/annotation/EnableCaching.java +++ b/spring-context/src/main/java/org/springframework/cache/annotation/EnableCaching.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -163,7 +163,7 @@ public @interface EnableCaching { /** * Indicate how caching advice should be applied. The default is - * {@link AdviceMode.PROXY}. + * {@link AdviceMode#PROXY}. * @see AdviceMode */ AdviceMode mode() default AdviceMode.PROXY; diff --git a/spring-context/src/main/java/org/springframework/cache/concurrent/ConcurrentMapCache.java b/spring-context/src/main/java/org/springframework/cache/concurrent/ConcurrentMapCache.java index 71e8561bec4..5c78b309203 100644 --- a/spring-context/src/main/java/org/springframework/cache/concurrent/ConcurrentMapCache.java +++ b/spring-context/src/main/java/org/springframework/cache/concurrent/ConcurrentMapCache.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -115,7 +115,7 @@ public class ConcurrentMapCache implements Cache { /** * Convert the given value from the internal store to a user value * returned from the get method (adapting null). - * @param userValue the store value + * @param storeValue the store value * @return the value to return to the user */ protected Object fromStoreValue(Object storeValue) { diff --git a/spring-context/src/main/java/org/springframework/cache/ehcache/EhCacheCacheManager.java b/spring-context/src/main/java/org/springframework/cache/ehcache/EhCacheCacheManager.java index 2fb21c7e637..a1588ac7dfc 100644 --- a/spring-context/src/main/java/org/springframework/cache/ehcache/EhCacheCacheManager.java +++ b/spring-context/src/main/java/org/springframework/cache/ehcache/EhCacheCacheManager.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -39,8 +39,8 @@ public class EhCacheCacheManager extends AbstractCacheManager { /** - * Returns the backing Ehcache {@link net.sf.ehcache.CacheManager}. - * @return + * Returns the backing EhCache {@link net.sf.ehcache.CacheManager}. + * @return the backing EhCache {@link net.sf.ehcache.CacheManager}. */ public net.sf.ehcache.CacheManager getCacheManager() { return cacheManager; diff --git a/spring-context/src/main/java/org/springframework/cache/interceptor/BeanFactoryCacheOperationSourceAdvisor.java b/spring-context/src/main/java/org/springframework/cache/interceptor/BeanFactoryCacheOperationSourceAdvisor.java index 97cb34d624b..a8d4a51e7b7 100644 --- a/spring-context/src/main/java/org/springframework/cache/interceptor/BeanFactoryCacheOperationSourceAdvisor.java +++ b/spring-context/src/main/java/org/springframework/cache/interceptor/BeanFactoryCacheOperationSourceAdvisor.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -44,7 +44,6 @@ public class BeanFactoryCacheOperationSourceAdvisor extends AbstractBeanFactoryP * Set the cache operation attribute source which is used to find cache * attributes. This should usually be identical to the source reference * set on the cache interceptor itself. - * @see CacheInterceptor#setCacheAttributeSource */ public void setCacheOperationSource(CacheOperationSource cacheOperationSource) { this.cacheOperationSource = cacheOperationSource; diff --git a/spring-context/src/main/java/org/springframework/cache/interceptor/CacheProxyFactoryBean.java b/spring-context/src/main/java/org/springframework/cache/interceptor/CacheProxyFactoryBean.java index d156a701cda..67a22e2b353 100644 --- a/spring-context/src/main/java/org/springframework/cache/interceptor/CacheProxyFactoryBean.java +++ b/spring-context/src/main/java/org/springframework/cache/interceptor/CacheProxyFactoryBean.java @@ -1,5 +1,5 @@ /* - * Copyright 2010-2011 the original author or authors. + * Copyright 2010-2012 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. @@ -24,7 +24,7 @@ import org.springframework.aop.support.DefaultPointcutAdvisor; * Proxy factory bean for simplified declarative caching handling. * This is a convenient alternative to a standard AOP * {@link org.springframework.aop.framework.ProxyFactoryBean} - * with a separate {@link CachingInterceptor} definition. + * with a separate {@link CacheInterceptor} definition. * *

This class is designed to facilitate declarative cache demarcation: namely, wrapping * a singleton target object with a caching proxy, proxying all the interfaces that the @@ -36,7 +36,7 @@ import org.springframework.aop.support.DefaultPointcutAdvisor; * * @author Costin Leau * @see org.springframework.aop.framework.ProxyFactoryBean - * @see CachingInterceptor + * @see CacheInterceptor */ @SuppressWarnings("serial") public class CacheProxyFactoryBean extends AbstractSingletonProxyFactoryBean { diff --git a/spring-context/src/main/java/org/springframework/cache/interceptor/NameMatchCacheOperationSource.java b/spring-context/src/main/java/org/springframework/cache/interceptor/NameMatchCacheOperationSource.java index 55d6f2a6c37..69f22ec49fa 100644 --- a/spring-context/src/main/java/org/springframework/cache/interceptor/NameMatchCacheOperationSource.java +++ b/spring-context/src/main/java/org/springframework/cache/interceptor/NameMatchCacheOperationSource.java @@ -50,7 +50,6 @@ public class NameMatchCacheOperationSource implements CacheOperationSource, Seri * (e.g. "myMethod") and CacheOperation instances * (or Strings to be converted to CacheOperation instances). * @see CacheOperation - * @see CacheOperationEditor */ public void setNameMap(Map> nameMap) { for (Map.Entry> entry : nameMap.entrySet()) { diff --git a/spring-context/src/main/java/org/springframework/context/annotation/Configuration.java b/spring-context/src/main/java/org/springframework/context/annotation/Configuration.java index 5d39ac635c8..b09623c29c0 100644 --- a/spring-context/src/main/java/org/springframework/context/annotation/Configuration.java +++ b/spring-context/src/main/java/org/springframework/context/annotation/Configuration.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -28,7 +28,7 @@ import org.springframework.beans.factory.annotation.Value; import org.springframework.stereotype.Component; /** - * Indicates that a class declares one or more @{@link Bean} methods and may be processed + * Indicates that a class declares one or more {@link Bean @Bean} methods and may be processed * by the Spring container to generate bean definitions and service requests for those * beans at runtime, for example: *

@@ -76,14 +76,14 @@ import org.springframework.stereotype.Component;
  * post processors that facilitate handling {@code @Configuration} classes.
  *
  * 

Via component scanning

- *

{@code @Configuration} is meta-annotated with @{@link Component}, therefore + *

{@code @Configuration} is meta-annotated with {@link Component @Component}, therefore * {@code @Configuration} classes are candidates for component scanning (typically using * Spring XML's {@code } element) and therefore may also take - * advantage of @{@link Autowired}/@{@link Inject} at the field and method level (but not - * at the constructor level). + * advantage of {@link Autowired @Autowired}/{@link javax.inject.Inject @Inject} + * at the field and method level (but not at the constructor level). *

{@code @Configuration} classes may not only be bootstrapped using * component scanning, but may also themselves configure component scanning using - * the @{@link ComponentScan} annotation: + * the {@link ComponentScan @ComponentScan} annotation: *

  * @Configuration
  * @ComponentScan("com.acme.app.services")
@@ -91,8 +91,8 @@ import org.springframework.stereotype.Component;
  *     // various @Bean definitions ...
  * }
* - * See @{@link ComponentScan} Javadoc for details. - * + * See {@link ComponentScan @ComponentScan} Javadoc for details. + * * *

Working with externalized values

*

Using the {@code Environment} API

@@ -115,7 +115,8 @@ import org.springframework.stereotype.Component; * * Properties resolved through the {@code Environment} reside in one or more "property * source" objects, and {@code @Configuration} classes may contribute property sources to - * the {@code Environment} object using the @{@link PropertySources} annotation: + * the {@code Environment} object using + * the {@link org.springframework.core.env.PropertySources @PropertySources} annotation: *
  * @Configuration
  * @PropertySource("classpath:/com/acme/app.properties")
@@ -129,11 +130,11 @@ import org.springframework.stereotype.Component;
  * }
* * See {@link org.springframework.core.env.Environment Environment} - * and @{@link PropertySource} Javadoc for further details. - * + * and {@link PropertySource @PropertySource} Javadoc for further details. + * *

Using the {@code @Value} annotation

* Externalized values may be 'wired into' {@code @Configuration} classes using - * the @{@link Value} annotation: + * the {@link Value @Value} annotation: *
  * @Configuration
  * @PropertySource("classpath:/com/acme/app.properties")
@@ -151,13 +152,13 @@ import org.springframework.stereotype.Component;
  * PropertySourcesPlaceholderConfigurer}, usually enabled via XML with
  * {@code }.  See the section below on composing
  * {@code @Configuration} classes with Spring XML using {@code @ImportResource},
- * see @{@link Value} Javadoc, and see @{@link Bean} Javadoc for details on working with
+ * see {@link Value @Value} Javadoc, and see {@link Bean @Bean} Javadoc for details on working with
  * {@code BeanFactoryPostProcessor} types such as
  * {@code PropertySourcesPlaceholderConfigurer}.
  *
  * 

Composing {@code @Configuration} classes

*

With the {@code @Import} annotation

- *

{@code @Configuration} classes may be composed using the @{@link Import} annotation, + *

{@code @Configuration} classes may be composed using the {@link Import @Import} annotation, * not unlike the way that {@code } works in Spring XML. Because * {@code @Configuration} objects are managed as Spring beans within the container, * imported configurations may be injected using {@code @Autowired} or {@code @Inject}: @@ -189,7 +190,7 @@ import org.springframework.stereotype.Component; * new AnnotationConfigApplicationContext(AppConfig.class);

* *

With the {@code @Profile} annotation

- * {@code @Configuration} classes may be marked with the @{@link Profile} annotation to + * {@code @Configuration} classes may be marked with the {@link Profile @Profile} annotation to * indicate they should be processed only if a given profile or profiles are * active: *
@@ -211,14 +212,14 @@ import org.springframework.stereotype.Component;
  *     }
  * }
* - * See @{@link Profile} and {@link org.springframework.core.env.Environment Environment} + * See {@link Profile @Profile} and {@link org.springframework.core.env.Environment Environment} * Javadoc for further details. * *

With Spring XML using the {@code @ImportResource} annotation

* As mentioned above, {@code @Configuration} classes may be declared as regular Spring * {@code } definitions within Spring XML files. It is also possible to * import Spring XML configuration files into {@code @Configuration} classes using - * the @{@link ImportResource} annotation. Bean definitions imported from XML can be + * the {@link ImportResource @ImportResource} annotation. Bean definitions imported from XML can be * injected using {@code @Autowired} or {@code @Import}: *
  * @Configuration
@@ -267,7 +268,7 @@ import org.springframework.stereotype.Component;
  * 

Configuring lazy initialization

*

By default, {@code @Bean} methods will be eagerly instantiated at container * bootstrap time. To avoid this, {@code @Configuration} may be used in conjunction with - * the @{@link Lazy} annotation to indicate that all {@code @Bean} methods declared within + * the {@link Lazy @Lazy} annotation to indicate that all {@code @Bean} methods declared within * the class are by default lazily initialized. Note that {@code @Lazy} may be used on * individual {@code @Bean} methods as well. * @@ -291,7 +292,7 @@ import org.springframework.stereotype.Component; * }

* * See TestContext framework reference documentation for details. - * + * *

Enabling built-in Spring features using {@code @Enable} annotations

* Spring features such as asynchronous method execution, scheduled task execution, * annotation driven transaction management, and even Spring MVC can be enabled and @@ -309,7 +310,7 @@ import org.springframework.stereotype.Component; *
  • @Configuration classes must be non-final *
  • @Configuration classes must be non-local (may not be declared within a method) *
  • @Configuration classes must have a default/no-arg constructor and may not - * use @{@link Autowired} constructor parameters. Any nested configuration classes + * use {@link Autowired @Autowired} constructor parameters. Any nested configuration classes * must be {@code static} * * diff --git a/spring-context/src/main/java/org/springframework/context/annotation/EnableLoadTimeWeaving.java b/spring-context/src/main/java/org/springframework/context/annotation/EnableLoadTimeWeaving.java index bed3cec76ac..3c8abd8066f 100644 --- a/spring-context/src/main/java/org/springframework/context/annotation/EnableLoadTimeWeaving.java +++ b/spring-context/src/main/java/org/springframework/context/annotation/EnableLoadTimeWeaving.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -64,13 +64,13 @@ import org.springframework.instrument.classloading.LoadTimeWeaver; * TomcatInstrumentableClassLoader}). * *

    To customize the weaver used, the {@code @Configuration} class annotated with - * {@code @EnableLoadTimeWeaving} may also implement the {@link LoadTimeWeaverConfigurer} + * {@code @EnableLoadTimeWeaving} may also implement the {@link LoadTimeWeavingConfigurer} * interface and return a custom {@code LoadTimeWeaver} instance through the * {@code #getLoadTimeWeaver} method: *

      * @Configuration
      * @EnableLoadTimeWeaving
    - * public class AppConfig implements LoadTimeWeaverConfigurer {
    + * public class AppConfig implements LoadTimeWeavingConfigurer {
      *     @Override
      *     public LoadTimeWeaver getLoadTimeWeaver() {
      *         MyLoadTimeWeaver ltw = new MyLoadTimeWeaver();
    diff --git a/spring-context/src/main/java/org/springframework/context/annotation/FilterType.java b/spring-context/src/main/java/org/springframework/context/annotation/FilterType.java
    index 9ed1b899434..26bd302d8e8 100644
    --- a/spring-context/src/main/java/org/springframework/context/annotation/FilterType.java
    +++ b/spring-context/src/main/java/org/springframework/context/annotation/FilterType.java
    @@ -28,8 +28,8 @@ import org.springframework.core.type.filter.AssignableTypeFilter;
      * @author Chris Beams
      * @since 2.5
      * @see ComponentScan
    - * @see ComponentScan.IncludeFilter
    - * @see ComponentScan.ExcludeFilter
    + * @see ComponentScan#includeFilters()
    + * @see ComponentScan#excludeFilters()
      * @see org.springframework.core.type.filter.TypeFilter
      */
     public enum FilterType {
    diff --git a/spring-context/src/main/java/org/springframework/context/annotation/Import.java b/spring-context/src/main/java/org/springframework/context/annotation/Import.java
    index 4a2fe947ca8..6aacf68a440 100644
    --- a/spring-context/src/main/java/org/springframework/context/annotation/Import.java
    +++ b/spring-context/src/main/java/org/springframework/context/annotation/Import.java
    @@ -1,5 +1,5 @@
     /*
    - * Copyright 2002-2011 the original author or authors.
    + * Copyright 2002-2012 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.
    @@ -23,23 +23,23 @@ import java.lang.annotation.RetentionPolicy;
     import java.lang.annotation.Target;
     
     /**
    - * Indicates one or more @{@link Configuration} classes to import.
    + * Indicates one or more {@link Configuration @Configuration} classes to import.
      *
      * 

    Provides functionality equivalent to the {@code } element in Spring XML. * Only supported for classes annotated with {@code @Configuration} or declaring at least - * one {@link @Bean} method, as well as {@link ImportSelector} and + * one {@link Bean @Bean} method, as well as {@link ImportSelector} and * {@link ImportBeanDefinitionRegistrar} implementations. * - *

    @{@code Bean} definitions declared in imported {@code @Configuration} classes - * should be accessed by using @{@link Autowired} injection. Either the bean itself can - * be autowired, or the configuration class instance declaring the bean can be autowired. - * The latter approach allows for explicit, IDE-friendly navigation between - * {@code @Configuration} class methods. + *

    {@code @Bean} definitions declared in imported {@code @Configuration} classes + * should be accessed by using {@link org.springframework.beans.factory.annotation.Autowired @Autowired} + * injection. Either the bean itself can be autowired, or the configuration class instance + * declaring the bean can be autowired. The latter approach allows for explicit, + * IDE-friendly navigation between {@code @Configuration} class methods. * *

    May be declared at the class level or as a meta-annotation. * *

    If XML or other non-{@code @Configuration} bean definition resources need to be - * imported, use @{@link ImportResource} + * imported, use {@link ImportResource @ImportResource} * * @author Chris Beams * @since 3.0 diff --git a/spring-context/src/main/java/org/springframework/context/annotation/LoadTimeWeavingConfigurer.java b/spring-context/src/main/java/org/springframework/context/annotation/LoadTimeWeavingConfigurer.java index 63322f62966..8df85b91f09 100644 --- a/spring-context/src/main/java/org/springframework/context/annotation/LoadTimeWeavingConfigurer.java +++ b/spring-context/src/main/java/org/springframework/context/annotation/LoadTimeWeavingConfigurer.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -19,12 +19,14 @@ package org.springframework.context.annotation; import org.springframework.instrument.classloading.LoadTimeWeaver; /** - * Interface to be implemented by @{@link org.springframework.context.annotation.Configuration - * Configuration} classes annotated with @{@link EnableLoadTimeWeaving} that wish to + * Interface to be implemented by + * {@link org.springframework.context.annotation.Configuration @Configuration} + * classes annotated with {@link EnableLoadTimeWeaving @EnableLoadTimeWeaving} that wish to * customize the {@link LoadTimeWeaver} instance to be used. * - *

    See @{@link EnableAsync} for usage examples and information on how a default - * {@code LoadTimeWeaver} is selected when this interface is not used. + *

    See {@link org.springframework.scheduling.annotation.EnableAsync @EnableAsync} + * for usage examples and information on how a default {@code LoadTimeWeaver} + * is selected when this interface is not used. * * @author Chris Beams * @since 3.1 diff --git a/spring-context/src/main/java/org/springframework/context/support/AbstractApplicationContext.java b/spring-context/src/main/java/org/springframework/context/support/AbstractApplicationContext.java index 84831884b7b..23b157f1d8a 100644 --- a/spring-context/src/main/java/org/springframework/context/support/AbstractApplicationContext.java +++ b/spring-context/src/main/java/org/springframework/context/support/AbstractApplicationContext.java @@ -506,7 +506,7 @@ public abstract class AbstractApplicationContext extends DefaultResourceLoader /** *

    Replace any stub property sources with actual instances. * @see org.springframework.core.env.PropertySource.StubPropertySource - * @see org.springframework.web.context.support.WebApplicationContextUtils#initSerlvetPropertySources + * @see org.springframework.web.context.support.WebApplicationContextUtils#initServletPropertySources */ protected void initPropertySources() { // For subclasses: do nothing by default. diff --git a/spring-context/src/main/java/org/springframework/context/support/PropertySourcesPlaceholderConfigurer.java b/spring-context/src/main/java/org/springframework/context/support/PropertySourcesPlaceholderConfigurer.java index aa8d9e79924..c831bbb8551 100644 --- a/spring-context/src/main/java/org/springframework/context/support/PropertySourcesPlaceholderConfigurer.java +++ b/spring-context/src/main/java/org/springframework/context/support/PropertySourcesPlaceholderConfigurer.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -108,7 +108,7 @@ public class PropertySourcesPlaceholderConfigurer extends PlaceholderConfigurerS *

    Processing occurs by replacing ${...} placeholders in bean definitions by resolving each * against this configurer's set of {@link PropertySources}, which includes: *

      - *
    • all {@linkplain Environment#getPropertySources environment property sources}, if an + *
    • all {@linkplain org.springframework.core.env.ConfigurableEnvironment#getPropertySources environment property sources}, if an * {@code Environment} {@linkplain #setEnvironment is present} *
    • {@linkplain #mergeProperties merged local properties}, if {@linkplain #setLocation any} * {@linkplain #setLocations have} {@linkplain #setProperties been} diff --git a/spring-context/src/main/java/org/springframework/format/datetime/joda/JodaTimeFormatterRegistrar.java b/spring-context/src/main/java/org/springframework/format/datetime/joda/JodaTimeFormatterRegistrar.java index 3fab08ef8d5..b60a6b3a0a6 100644 --- a/spring-context/src/main/java/org/springframework/format/datetime/joda/JodaTimeFormatterRegistrar.java +++ b/spring-context/src/main/java/org/springframework/format/datetime/joda/JodaTimeFormatterRegistrar.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -41,7 +41,7 @@ import org.springframework.format.Printer; * @see #setTimeStyle * @see #setDateTimeStyle * @see #setUseIsoFormat - * @see #installJodaTimeFormatting + * @see FormatterRegistrar#registerFormatters */ public class JodaTimeFormatterRegistrar implements FormatterRegistrar { diff --git a/spring-context/src/main/java/org/springframework/instrument/classloading/glassfish/GlassFishLoadTimeWeaver.java b/spring-context/src/main/java/org/springframework/instrument/classloading/glassfish/GlassFishLoadTimeWeaver.java index a1ac9034668..82efcf39079 100644 --- a/spring-context/src/main/java/org/springframework/instrument/classloading/glassfish/GlassFishLoadTimeWeaver.java +++ b/spring-context/src/main/java/org/springframework/instrument/classloading/glassfish/GlassFishLoadTimeWeaver.java @@ -23,8 +23,9 @@ import org.springframework.util.Assert; import org.springframework.util.ClassUtils; /** - * {@link LoadTimeWeaver} implementation for GlassFish's {@link InstrumentableClassLoader}. - * + * {@link LoadTimeWeaver} implementation for GlassFish's + * {@link org.glassfish.api.deployment.InstrumentableClassLoader InstrumentableClassLoader}. + * *

      As of Spring 3.0, GlassFish V3 is supported as well. * * @author Costin Leau @@ -49,7 +50,8 @@ public class GlassFishLoadTimeWeaver implements LoadTimeWeaver { * Creates a new instance of the GlassFishLoadTimeWeaver class. * @param classLoader the specific {@link ClassLoader} to use; must not be null * @throws IllegalArgumentException if the supplied classLoader is null; - * or if the supplied classLoader is not an {@link InstrumentableClassLoader} + * or if the supplied classLoader is not an + * {@link org.glassfish.api.deployment.InstrumentableClassLoader InstrumentableClassLoader} */ public GlassFishLoadTimeWeaver(ClassLoader classLoader) { Assert.notNull(classLoader, "ClassLoader must not be null"); diff --git a/spring-context/src/main/java/org/springframework/jmx/access/MBeanClientInterceptor.java b/spring-context/src/main/java/org/springframework/jmx/access/MBeanClientInterceptor.java index 716ec0c6882..0396c0dfb81 100644 --- a/spring-context/src/main/java/org/springframework/jmx/access/MBeanClientInterceptor.java +++ b/spring-context/src/main/java/org/springframework/jmx/access/MBeanClientInterceptor.java @@ -526,7 +526,7 @@ public class MBeanClientInterceptor * Convert the given result object (from attribute access or operation invocation) * to the specified target class for returning from the proxy method. * @param result the result object as returned by the MBeanServer - * @param targetClass the result type of the proxy method that's been invoked + * @param parameter the method parameter of the proxy method that's been invoked * @return the converted result object, or the passed-in object if no conversion * is necessary */ diff --git a/spring-context/src/main/java/org/springframework/jmx/export/assembler/AbstractMBeanInfoAssembler.java b/spring-context/src/main/java/org/springframework/jmx/export/assembler/AbstractMBeanInfoAssembler.java index f81f0c2815f..c0a95abb4ff 100644 --- a/spring-context/src/main/java/org/springframework/jmx/export/assembler/AbstractMBeanInfoAssembler.java +++ b/spring-context/src/main/java/org/springframework/jmx/export/assembler/AbstractMBeanInfoAssembler.java @@ -88,7 +88,7 @@ public abstract class AbstractMBeanInfoAssembler implements MBeanInfoAssembler { * and the plain bean class else. * @param managedBean the bean instance (might be an AOP proxy) * @return the bean class to expose - * @see org.springframework.aop.framework.AopProxyUtils#getTargetClass + * @see org.springframework.aop.support.AopUtils#getTargetClass(Object) */ protected Class getTargetClass(Object managedBean) { return AopUtils.getTargetClass(managedBean); @@ -100,7 +100,7 @@ public abstract class AbstractMBeanInfoAssembler implements MBeanInfoAssembler { * (for example, checked for annotations). * @param managedBean the bean instance (might be an AOP proxy) * @return the bean class to expose - * @see JmxUtils#getClassToExpose(Object) + * @see JmxUtils#getClassToExpose(Object) */ protected Class getClassToExpose(Object managedBean) { return JmxUtils.getClassToExpose(managedBean); diff --git a/spring-context/src/main/java/org/springframework/scheduling/annotation/AsyncAnnotationAdvisor.java b/spring-context/src/main/java/org/springframework/scheduling/annotation/AsyncAnnotationAdvisor.java index b1578438aa5..245ff645b9c 100644 --- a/spring-context/src/main/java/org/springframework/scheduling/annotation/AsyncAnnotationAdvisor.java +++ b/spring-context/src/main/java/org/springframework/scheduling/annotation/AsyncAnnotationAdvisor.java @@ -45,7 +45,7 @@ import org.springframework.util.Assert; * * @author Juergen Hoeller * @since 3.0 - * @see PersistenceExceptionTranslationAdvisor + * @see org.springframework.dao.annotation.PersistenceExceptionTranslationAdvisor * @see org.springframework.stereotype.Repository * @see org.springframework.dao.DataAccessException * @see org.springframework.dao.support.PersistenceExceptionTranslator @@ -126,8 +126,8 @@ public class AsyncAnnotationAdvisor extends AbstractPointcutAdvisor { } /** - * Calculate a pointcut for the given target class, if any. - * @param targetClass the class to introspect + * Calculate a pointcut for the given async annotation types, if any. + * @param asyncAnnotationTypes the async annotation types to introspect * @return the applicable Pointcut object, or null if none */ protected Pointcut buildPointcut(Set> asyncAnnotationTypes) { diff --git a/spring-context/src/main/java/org/springframework/validation/beanvalidation/MethodValidationInterceptor.java b/spring-context/src/main/java/org/springframework/validation/beanvalidation/MethodValidationInterceptor.java index b3e087c83b6..e856247d240 100644 --- a/spring-context/src/main/java/org/springframework/validation/beanvalidation/MethodValidationInterceptor.java +++ b/spring-context/src/main/java/org/springframework/validation/beanvalidation/MethodValidationInterceptor.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -76,7 +76,7 @@ public class MethodValidationInterceptor implements MethodInterceptor { /** * Create a new MethodValidationInterceptor using the given JSR-303 Validator. - * @param validatorFactory the JSR-303 Validator to use + * @param validator the JSR-303 Validator to use */ public MethodValidationInterceptor(Validator validator) { this.validator = validator.unwrap(MethodValidator.class); diff --git a/spring-core/src/main/java/org/springframework/core/convert/ConverterNotFoundException.java b/spring-core/src/main/java/org/springframework/core/convert/ConverterNotFoundException.java index fcfc6f574ab..ec966b708bb 100644 --- a/spring-core/src/main/java/org/springframework/core/convert/ConverterNotFoundException.java +++ b/spring-core/src/main/java/org/springframework/core/convert/ConverterNotFoundException.java @@ -20,7 +20,7 @@ package org.springframework.core.convert; * Thrown when a suitable converter could not be found in a conversion service. * * @author Keith Donald - * @since 3.0 + * @since 3.0 */ @SuppressWarnings("serial") public final class ConverterNotFoundException extends ConversionException { @@ -34,7 +34,6 @@ public final class ConverterNotFoundException extends ConversionException { * Creates a new conversion executor not found exception. * @param sourceType the source type requested to convert from * @param targetType the target type requested to convert to - * @param message a descriptive message */ public ConverterNotFoundException(TypeDescriptor sourceType, TypeDescriptor targetType) { super("No converter found capable of converting from type " + sourceType + " to type " + targetType); diff --git a/spring-core/src/main/java/org/springframework/core/convert/TypeDescriptor.java b/spring-core/src/main/java/org/springframework/core/convert/TypeDescriptor.java index f2ce7ed6280..2a1381cb6e5 100644 --- a/spring-core/src/main/java/org/springframework/core/convert/TypeDescriptor.java +++ b/spring-core/src/main/java/org/springframework/core/convert/TypeDescriptor.java @@ -74,7 +74,7 @@ public class TypeDescriptor { /** * Create a new type descriptor from a {@link MethodParameter}. - * Use this constructor when a source or target conversion point is a constructor parameter, method parameter, or method return value. + * Use this constructor when a source or target conversion point is a constructor parameter, method parameter, or method return value. * @param methodParameter the method parameter */ public TypeDescriptor(MethodParameter methodParameter) { @@ -204,7 +204,7 @@ public class TypeDescriptor { * Create a new type descriptor for an object. * Use this factory method to introspect a source object before asking the conversion system to convert it to some another type. * If the provided object is null, returns null, else calls {@link #valueOf(Class)} to build a TypeDescriptor from the object's class. - * @param object the source object + * @param source the source object * @return the type descriptor */ public static TypeDescriptor forObject(Object source) { @@ -287,7 +287,7 @@ public class TypeDescriptor { /** * Returns true if an object of this type descriptor can be assigned to the location described by the given type descriptor. - * For example, valueOf(String.class).isAssignableTo(valueOf(CharSequence.class)) returns true because a String value can be assigned to a CharSequence variable. + * For example, valueOf(String.class).isAssignableTo(valueOf(CharSequence.class)) returns true because a String value can be assigned to a CharSequence variable. * On the other hand, valueOf(Number.class).isAssignableTo(valueOf(Integer.class)) returns false because, while all Integers are Numbers, not all Numbers are Integers. *

      * For arrays, collections, and maps, element and key/value types are checked if declared. @@ -348,7 +348,7 @@ public class TypeDescriptor { * Narrows the {@link #getElementTypeDescriptor() elementType} property to the class of the provided collection or array element. * For example, if this describes a java.util.List<java.lang.Number< and the element argument is a java.lang.Integer, the returned TypeDescriptor will be java.lang.Integer. * If this describes a java.util.List<?> and the element argument is a java.lang.Integer, the returned TypeDescriptor will be java.lang.Integer as well. - * Annotation and nested type context will be preserved in the narrowed TypeDescriptor that is returned. + * Annotation and nested type context will be preserved in the narrowed TypeDescriptor that is returned. * @param element the collection or array element * @return a element type descriptor, narrowed to the type of the provided element * @throws IllegalStateException if this type is not a java.util.Collection or Array type @@ -383,7 +383,7 @@ public class TypeDescriptor { * Narrows the {@link #getMapKeyTypeDescriptor() mapKeyType} property to the class of the provided map key. * For example, if this describes a java.util.Map<java.lang.Number, java.lang.String< and the key argument is a java.lang.Integer, the returned TypeDescriptor will be java.lang.Integer. * If this describes a java.util.Map<?, ?> and the key argument is a java.lang.Integer, the returned TypeDescriptor will be java.lang.Integer as well. - * Annotation and nested type context will be preserved in the narrowed TypeDescriptor that is returned. + * Annotation and nested type context will be preserved in the narrowed TypeDescriptor that is returned. * @param mapKey the map key * @return the map key type descriptor * @throws IllegalStateException if this type is not a java.util.Map. @@ -409,10 +409,10 @@ public class TypeDescriptor { * Narrows the {@link #getMapValueTypeDescriptor() mapValueType} property to the class of the provided map value. * For example, if this describes a java.util.Map<java.lang.String, java.lang.Number< and the value argument is a java.lang.Integer, the returned TypeDescriptor will be java.lang.Integer. * If this describes a java.util.Map<?, ?> and the value argument is a java.lang.Integer, the returned TypeDescriptor will be java.lang.Integer as well. - * Annotation and nested type context will be preserved in the narrowed TypeDescriptor that is returned. + * Annotation and nested type context will be preserved in the narrowed TypeDescriptor that is returned. * @param mapValue the map value * @return the map value type descriptor - * @throws IllegalStateException if this type is not a java.util.Map. + * @throws IllegalStateException if this type is not a java.util.Map. */ public TypeDescriptor getMapValueTypeDescriptor(Object mapValue) { return narrow(mapValue, getMapValueTypeDescriptor()); diff --git a/spring-core/src/main/java/org/springframework/core/env/AbstractEnvironment.java b/spring-core/src/main/java/org/springframework/core/env/AbstractEnvironment.java index 4e93c5a2784..b9798525db4 100644 --- a/spring-core/src/main/java/org/springframework/core/env/AbstractEnvironment.java +++ b/spring-core/src/main/java/org/springframework/core/env/AbstractEnvironment.java @@ -41,9 +41,9 @@ import static org.springframework.util.StringUtils.*; * *

      Concrete subclasses differ primarily on which {@link PropertySource} objects they * add by default. {@code AbstractEnvironment} adds none. Subclasses should contribute - * property sources through the protected {@link #customizePropertySources()} hook, while - * clients should customize using {@link ConfigurableEnvironment#getPropertySources()} and - * working against the {@link MutablePropertySources} API. See + * property sources through the protected {@link #customizePropertySources(MutablePropertySources)} + * hook, while clients should customize using {@link ConfigurableEnvironment#getPropertySources()} + * and working against the {@link MutablePropertySources} API. See * {@link ConfigurableEnvironment} Javadoc for usage examples. * * @author Chris Beams diff --git a/spring-core/src/main/java/org/springframework/core/env/PropertyResolver.java b/spring-core/src/main/java/org/springframework/core/env/PropertyResolver.java index 60b8da43ff0..cf94472c0c7 100644 --- a/spring-core/src/main/java/org/springframework/core/env/PropertyResolver.java +++ b/spring-core/src/main/java/org/springframework/core/env/PropertyResolver.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -56,7 +56,7 @@ public interface PropertyResolver { * Return the property value associated with the given key, or {@code null} * if the key cannot be resolved. * @param key the property name to resolve - * @param T the expected type of the property value + * @param targetType the expected type of the property value * @see #getRequiredProperty(String, Class) */ T getProperty(String key, Class targetType); @@ -65,11 +65,11 @@ public interface PropertyResolver { * Return the property value associated with the given key, or * {@code defaultValue} if the key cannot be resolved. * @param key the property name to resolve - * @param T the expected type of the property value + * @param targetType the expected type of the property value * @param defaultValue the default value to return if no value is found * @see #getRequiredProperty(String, Class) */ - T getProperty(String string, Class targetType, T defaultValue); + T getProperty(String key, Class targetType, T defaultValue); /** * Convert the property value associated with the given key to a {@code Class} diff --git a/spring-core/src/main/java/org/springframework/core/serializer/support/SerializingConverter.java b/spring-core/src/main/java/org/springframework/core/serializer/support/SerializingConverter.java index fd6fa48c898..3ae7ca3b128 100644 --- a/spring-core/src/main/java/org/springframework/core/serializer/support/SerializingConverter.java +++ b/spring-core/src/main/java/org/springframework/core/serializer/support/SerializingConverter.java @@ -24,7 +24,7 @@ import org.springframework.core.serializer.Serializer; import org.springframework.util.Assert; /** - * A {@Link Converter} that delegates to a {@link org.springframework.core.serializer.Serializer} + * A {@link Converter} that delegates to a {@link org.springframework.core.serializer.Serializer} * to convert an object to a byte array. * * @author Gary Russell diff --git a/spring-core/src/main/java/org/springframework/core/task/support/ExecutorServiceAdapter.java b/spring-core/src/main/java/org/springframework/core/task/support/ExecutorServiceAdapter.java index 91d5122d848..c9c998f2aed 100644 --- a/spring-core/src/main/java/org/springframework/core/task/support/ExecutorServiceAdapter.java +++ b/spring-core/src/main/java/org/springframework/core/task/support/ExecutorServiceAdapter.java @@ -49,7 +49,7 @@ public class ExecutorServiceAdapter extends AbstractExecutorService { /** * Create a new ExecutorServiceAdapter, using the given target executor. - * @param concurrentExecutor the target executor to delegate to + * @param taskExecutor the target executor to delegate to */ public ExecutorServiceAdapter(TaskExecutor taskExecutor) { Assert.notNull(taskExecutor, "TaskExecutor must not be null"); diff --git a/spring-expression/src/main/java/org/springframework/expression/spel/SpelNode.java b/spring-expression/src/main/java/org/springframework/expression/spel/SpelNode.java index 392807ae16e..6e2ba93f3f1 100644 --- a/spring-expression/src/main/java/org/springframework/expression/spel/SpelNode.java +++ b/spring-expression/src/main/java/org/springframework/expression/spel/SpelNode.java @@ -43,7 +43,7 @@ public interface SpelNode { /** * Determine if this expression node will support a setValue() call. - * + * * @param expressionState the current expression state (includes the context) * @return true if the expression node will allow setValue() * @throws EvaluationException if something went wrong trying to determine if the node supports writing @@ -77,7 +77,7 @@ public interface SpelNode { /** * Determine the class of the object passed in, unless it is already a class object. - * @param o the object that the caller wants the class of + * @param obj the object that the caller wants the class of * @return the class of the object if it is not already a class object, or null if the object is null */ Class getObjectClass(Object obj); diff --git a/spring-jdbc/src/main/java/org/springframework/jdbc/core/JdbcOperations.java b/spring-jdbc/src/main/java/org/springframework/jdbc/core/JdbcOperations.java index fc984fe1040..634b2c8b89e 100644 --- a/spring-jdbc/src/main/java/org/springframework/jdbc/core/JdbcOperations.java +++ b/spring-jdbc/src/main/java/org/springframework/jdbc/core/JdbcOperations.java @@ -1012,9 +1012,9 @@ public interface JdbcOperations { * Each batch should be of size indicated in 'batchSize'. * @param sql the SQL statement to execute. * @param batchArgs the List of Object arrays containing the batch of arguments for the query - * @param argTypes SQL types of the arguments - * (constants from java.sql.Types) - * @return an array containing for each batch another array containing the numbers of rows affected + * @param batchSize batch size + * @param pss ParameterizedPreparedStatementSetter to use + * @return an array containing for each batch another array containing the numbers of rows affected * by each update in the batch */ public int[][] batchUpdate(String sql, Collection batchArgs, int batchSize, ParameterizedPreparedStatementSetter pss); diff --git a/spring-jdbc/src/main/java/org/springframework/jdbc/core/ParameterizedPreparedStatementSetter.java b/spring-jdbc/src/main/java/org/springframework/jdbc/core/ParameterizedPreparedStatementSetter.java index 63d8b5e3f8a..fd8f8278764 100644 --- a/spring-jdbc/src/main/java/org/springframework/jdbc/core/ParameterizedPreparedStatementSetter.java +++ b/spring-jdbc/src/main/java/org/springframework/jdbc/core/ParameterizedPreparedStatementSetter.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -34,13 +34,13 @@ import java.sql.SQLException; * @author Nicolas Fabre * @author Thomas Risberg * @since 3.1 - * @see JdbcTemplate#batchUpdate(String sql, Collection objs, int batchSize, ParameterizedPreparedStatementSetter pss) + * @see JdbcTemplate#batchUpdate(String, java.util.Collection, int, ParameterizedPreparedStatementSetter) */ public interface ParameterizedPreparedStatementSetter { - /** + /** * Set parameter values on the given PreparedStatement. - * + * * @param ps the PreparedStatement to invoke setter methods on * @param argument the object containing the values to be set * @throws SQLException if a SQLException is encountered (i.e. there is no need to catch SQLException) diff --git a/spring-jdbc/src/main/java/org/springframework/jdbc/datasource/embedded/EmbeddedDatabaseConfigurer.java b/spring-jdbc/src/main/java/org/springframework/jdbc/datasource/embedded/EmbeddedDatabaseConfigurer.java index f82e0be500f..210439042cb 100644 --- a/spring-jdbc/src/main/java/org/springframework/jdbc/datasource/embedded/EmbeddedDatabaseConfigurer.java +++ b/spring-jdbc/src/main/java/org/springframework/jdbc/datasource/embedded/EmbeddedDatabaseConfigurer.java @@ -29,7 +29,7 @@ public interface EmbeddedDatabaseConfigurer { /** * Configure the properties required to create and connect to the embedded database instance. - * @param dataSource the data source to configure + * @param properties connection properties to configure * @param databaseName the name of the test database */ void configureConnectionProperties(ConnectionProperties properties, String databaseName); diff --git a/spring-jms/src/main/java/org/springframework/jms/support/converter/MappingJacksonMessageConverter.java b/spring-jms/src/main/java/org/springframework/jms/support/converter/MappingJacksonMessageConverter.java index 72e6aa7240c..091e5fc4a33 100644 --- a/spring-jms/src/main/java/org/springframework/jms/support/converter/MappingJacksonMessageConverter.java +++ b/spring-jms/src/main/java/org/springframework/jms/support/converter/MappingJacksonMessageConverter.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -346,7 +346,6 @@ public class MappingJacksonMessageConverter implements MessageConverter { *

      The default implementation parses the configured type id property name * and consults the configured type id mapping. This can be overridden with * a different strategy, e.g. doing some heuristics based on message origin. - * @param object the payload object to set a type id for * @param message the JMS Message to set the type id on * @throws JMSException if thrown by JMS methods * @see #setTypeIdOnMessage(Object, javax.jms.Message) diff --git a/spring-jms/src/main/java/org/springframework/jms/support/converter/MessageType.java b/spring-jms/src/main/java/org/springframework/jms/support/converter/MessageType.java index 8c633d61bb3..67a7b0c0eb9 100644 --- a/spring-jms/src/main/java/org/springframework/jms/support/converter/MessageType.java +++ b/spring-jms/src/main/java/org/springframework/jms/support/converter/MessageType.java @@ -19,7 +19,7 @@ package org.springframework.jms.support.converter; /** * Constants that indicate a target message type to convert to: a * {@link javax.jms.TextMessage}, a {@link javax.jms.BytesMessage}, - * a {@link javax.jms.MapMessage} or an {@link ObjectMessage}. + * a {@link javax.jms.MapMessage} or an {@link javax.jms.ObjectMessage}. * * @author Juergen Hoeller * @since 3.0 diff --git a/spring-orm/src/main/java/org/springframework/orm/hibernate4/LocalSessionFactoryBean.java b/spring-orm/src/main/java/org/springframework/orm/hibernate4/LocalSessionFactoryBean.java index 7c2ecf1e8b7..075a5f6cee4 100644 --- a/spring-orm/src/main/java/org/springframework/orm/hibernate4/LocalSessionFactoryBean.java +++ b/spring-orm/src/main/java/org/springframework/orm/hibernate4/LocalSessionFactoryBean.java @@ -226,7 +226,7 @@ public class LocalSessionFactoryBean extends HibernateExceptionTranslator /** * Specify annotated entity classes to register with this Hibernate SessionFactory. - * @see org.hibernate.cfg.Configuration#addAnnotatedClass(String) + * @see org.hibernate.cfg.Configuration#addAnnotatedClass(Class) */ public void setAnnotatedClasses(Class[] annotatedClasses) { this.annotatedClasses = annotatedClasses; diff --git a/spring-orm/src/main/java/org/springframework/orm/ibatis/SqlMapClientFactoryBean.java b/spring-orm/src/main/java/org/springframework/orm/ibatis/SqlMapClientFactoryBean.java index cb317408661..d250d0ac90b 100644 --- a/spring-orm/src/main/java/org/springframework/orm/ibatis/SqlMapClientFactoryBean.java +++ b/spring-orm/src/main/java/org/springframework/orm/ibatis/SqlMapClientFactoryBean.java @@ -170,7 +170,6 @@ public class SqlMapClientFactoryBean implements FactoryBean, Initi * @see #setTransactionConfigProperties * @see com.ibatis.sqlmap.client.SqlMapClient#getDataSource * @see SqlMapClientTemplate#setDataSource - * @see SqlMapClientTemplate#queryForPaginatedList */ public void setDataSource(DataSource dataSource) { this.dataSource = dataSource; diff --git a/spring-orm/src/main/java/org/springframework/orm/jdo/JdoOperations.java b/spring-orm/src/main/java/org/springframework/orm/jdo/JdoOperations.java index 16b73839d9a..dac404e8e70 100644 --- a/spring-orm/src/main/java/org/springframework/orm/jdo/JdoOperations.java +++ b/spring-orm/src/main/java/org/springframework/orm/jdo/JdoOperations.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -228,7 +228,6 @@ public interface JdoOperations { * to rely on auto-flushing at transaction completion. * @throws org.springframework.dao.DataAccessException in case of JDO errors * @see javax.jdo.PersistenceManager#flush() - * @see JdoDialect#flush(javax.jdo.PersistenceManager) */ void flush() throws DataAccessException; diff --git a/spring-orm/src/main/java/org/springframework/orm/jpa/vendor/EclipseLinkJpaDialect.java b/spring-orm/src/main/java/org/springframework/orm/jpa/vendor/EclipseLinkJpaDialect.java index 7962f6a715f..bbc9526e0a7 100644 --- a/spring-orm/src/main/java/org/springframework/orm/jpa/vendor/EclipseLinkJpaDialect.java +++ b/spring-orm/src/main/java/org/springframework/orm/jpa/vendor/EclipseLinkJpaDialect.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -70,7 +70,7 @@ public class EclipseLinkJpaDialect extends DefaultJpaDialect { *

      It is only recommended to switch this flag to "true" when no JDBC access * code is involved in any of the transactions, and when it is acceptable to * perform read operations outside of the transactional JDBC Connection. - * @see oracle.toplink.sessions.UnitOfWork#beginEarlyTransaction() + * @see org.eclipse.persistence.sessions.UnitOfWork#beginEarlyTransaction() */ public void setLazyDatabaseTransaction(boolean lazyDatabaseTransaction) { this.lazyDatabaseTransaction = lazyDatabaseTransaction; diff --git a/spring-orm/src/main/java/org/springframework/orm/jpa/vendor/TopLinkJpaDialect.java b/spring-orm/src/main/java/org/springframework/orm/jpa/vendor/TopLinkJpaDialect.java index 3cf55ffed0e..89b9141b93a 100644 --- a/spring-orm/src/main/java/org/springframework/orm/jpa/vendor/TopLinkJpaDialect.java +++ b/spring-orm/src/main/java/org/springframework/orm/jpa/vendor/TopLinkJpaDialect.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -68,7 +68,7 @@ public class TopLinkJpaDialect extends DefaultJpaDialect { *

      It is only recommended to switch this flag to "true" when no JDBC access * code is involved in any of the transactions, and when it is acceptable to * perform read operations outside of the transactional JDBC Connection. - * @see oracle.toplink.sessions.UnitOfWork#beginEarlyTransaction() + * @see oracle.toplink.essentials.sessions.UnitOfWork#beginEarlyTransaction() */ public void setLazyDatabaseTransaction(boolean lazyDatabaseTransaction) { this.lazyDatabaseTransaction = lazyDatabaseTransaction; diff --git a/spring-oxm/src/main/java/org/springframework/oxm/GenericMarshaller.java b/spring-oxm/src/main/java/org/springframework/oxm/GenericMarshaller.java index 315682cc812..540b9795d14 100644 --- a/spring-oxm/src/main/java/org/springframework/oxm/GenericMarshaller.java +++ b/spring-oxm/src/main/java/org/springframework/oxm/GenericMarshaller.java @@ -22,7 +22,7 @@ import java.lang.reflect.Type; * Subinterface of {@link Marshaller} that has support for Java 5 generics. * * @author Arjen Poutsma - * @sicne 3.0.1 + * @since 3.0.1 */ public interface GenericMarshaller extends Marshaller { diff --git a/spring-oxm/src/main/java/org/springframework/oxm/GenericUnmarshaller.java b/spring-oxm/src/main/java/org/springframework/oxm/GenericUnmarshaller.java index b0a595dbe53..5b90d1f5a5c 100644 --- a/spring-oxm/src/main/java/org/springframework/oxm/GenericUnmarshaller.java +++ b/spring-oxm/src/main/java/org/springframework/oxm/GenericUnmarshaller.java @@ -22,7 +22,7 @@ import java.lang.reflect.Type; * Subinterface of {@link Unmarshaller} that has support for Java 5 generics. * * @author Arjen Poutsma - * @sicne 3.0.1 + * @since 3.0.1 */ public interface GenericUnmarshaller extends Unmarshaller { diff --git a/spring-oxm/src/main/java/org/springframework/oxm/castor/CastorMarshaller.java b/spring-oxm/src/main/java/org/springframework/oxm/castor/CastorMarshaller.java index 6c2faa38e06..dfea7ac536d 100644 --- a/spring-oxm/src/main/java/org/springframework/oxm/castor/CastorMarshaller.java +++ b/spring-oxm/src/main/java/org/springframework/oxm/castor/CastorMarshaller.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -362,7 +362,7 @@ public class CastorMarshaller extends AbstractMarshaller implements Initializing /** * Sets whether this unmarshaller should re-use objects. This will be only used when unmarshalling to existing - * object.

      The default is {@link false}, which means that the objects won't be re-used. + * object.

      The default is {@code false}, which means that the objects won't be re-used. * * @see org.exolab.castor.xml.Unmarshaller#setReuseObjects(boolean) */ @@ -371,7 +371,7 @@ public class CastorMarshaller extends AbstractMarshaller implements Initializing } /** - * Sets whether this unmarshaller should clear collections upon the first use.

      The default is {@link false}, + * Sets whether this unmarshaller should clear collections upon the first use.

      The default is {@code false}, * which means that marshaller won't clear collections. * * @see org.exolab.castor.xml.Unmarshaller#setClearCollections(boolean) diff --git a/spring-struts/src/main/java/org/springframework/web/struts/ActionSupport.java b/spring-struts/src/main/java/org/springframework/web/struts/ActionSupport.java index 1630b30c77a..c12b895766e 100644 --- a/spring-struts/src/main/java/org/springframework/web/struts/ActionSupport.java +++ b/spring-struts/src/main/java/org/springframework/web/struts/ActionSupport.java @@ -52,7 +52,6 @@ import org.springframework.web.util.WebUtils; * @see ContextLoaderPlugIn#SERVLET_CONTEXT_PREFIX * @see org.springframework.web.context.WebApplicationContext#ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE * @see org.springframework.web.context.ContextLoaderListener - * @see org.springframework.web.context.ContextLoaderServlet * @see DispatchActionSupport * @see LookupDispatchActionSupport * @see MappingDispatchActionSupport diff --git a/spring-struts/src/main/java/org/springframework/web/struts/ContextLoaderPlugIn.java b/spring-struts/src/main/java/org/springframework/web/struts/ContextLoaderPlugIn.java index 24317165dbc..ba316fd3bc2 100644 --- a/spring-struts/src/main/java/org/springframework/web/struts/ContextLoaderPlugIn.java +++ b/spring-struts/src/main/java/org/springframework/web/struts/ContextLoaderPlugIn.java @@ -97,7 +97,6 @@ import org.springframework.web.context.support.XmlWebApplicationContext; * @see DelegatingRequestProcessor * @see DelegatingTilesRequestProcessor * @see org.springframework.web.context.ContextLoaderListener - * @see org.springframework.web.context.ContextLoaderServlet * @see org.springframework.web.servlet.FrameworkServlet * @deprecated as of Spring 3.0 */ diff --git a/spring-struts/src/main/java/org/springframework/web/struts/DispatchActionSupport.java b/spring-struts/src/main/java/org/springframework/web/struts/DispatchActionSupport.java index bb74fafa1c9..ff18cff838a 100644 --- a/spring-struts/src/main/java/org/springframework/web/struts/DispatchActionSupport.java +++ b/spring-struts/src/main/java/org/springframework/web/struts/DispatchActionSupport.java @@ -52,7 +52,6 @@ import org.springframework.web.util.WebUtils; * @see ContextLoaderPlugIn#SERVLET_CONTEXT_PREFIX * @see org.springframework.web.context.WebApplicationContext#ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE * @see org.springframework.web.context.ContextLoaderListener - * @see org.springframework.web.context.ContextLoaderServlet * @see ActionSupport * @see LookupDispatchActionSupport * @see MappingDispatchActionSupport diff --git a/spring-struts/src/main/java/org/springframework/web/struts/LookupDispatchActionSupport.java b/spring-struts/src/main/java/org/springframework/web/struts/LookupDispatchActionSupport.java index 9c606b91b34..1533d81a102 100644 --- a/spring-struts/src/main/java/org/springframework/web/struts/LookupDispatchActionSupport.java +++ b/spring-struts/src/main/java/org/springframework/web/struts/LookupDispatchActionSupport.java @@ -51,7 +51,6 @@ import org.springframework.web.util.WebUtils; * @see ContextLoaderPlugIn#SERVLET_CONTEXT_PREFIX * @see WebApplicationContext#ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE * @see org.springframework.web.context.ContextLoaderListener - * @see org.springframework.web.context.ContextLoaderServlet * @see ActionSupport * @see DispatchActionSupport * @see MappingDispatchActionSupport diff --git a/spring-struts/src/main/java/org/springframework/web/struts/MappingDispatchActionSupport.java b/spring-struts/src/main/java/org/springframework/web/struts/MappingDispatchActionSupport.java index ec08c10771c..b67b34f481d 100644 --- a/spring-struts/src/main/java/org/springframework/web/struts/MappingDispatchActionSupport.java +++ b/spring-struts/src/main/java/org/springframework/web/struts/MappingDispatchActionSupport.java @@ -51,7 +51,6 @@ import org.springframework.web.util.WebUtils; * @see ContextLoaderPlugIn#SERVLET_CONTEXT_PREFIX * @see WebApplicationContext#ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE * @see org.springframework.web.context.ContextLoaderListener - * @see org.springframework.web.context.ContextLoaderServlet * @see ActionSupport * @see DispatchActionSupport * @see LookupDispatchActionSupport diff --git a/spring-test/src/main/java/org/springframework/test/context/ContextConfigurationAttributes.java b/spring-test/src/main/java/org/springframework/test/context/ContextConfigurationAttributes.java index bdcd5135c1a..e937898a231 100644 --- a/spring-test/src/main/java/org/springframework/test/context/ContextConfigurationAttributes.java +++ b/spring-test/src/main/java/org/springframework/test/context/ContextConfigurationAttributes.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -23,10 +23,10 @@ import org.springframework.util.Assert; import org.springframework.util.ObjectUtils; /** - * ContextConfigurationAttributes encapsulates the context + * ContextConfigurationAttributes encapsulates the context * configuration attributes declared on a test class via * {@link ContextConfiguration @ContextConfiguration}. - * + * * @author Sam Brannen * @since 3.1 * @see ContextConfiguration @@ -52,7 +52,7 @@ public class ContextConfigurationAttributes { * Resolve resource locations from the {@link ContextConfiguration#locations() locations} * and {@link ContextConfiguration#value() value} attributes of the supplied * {@link ContextConfiguration} annotation. - * + * * @throws IllegalStateException if both the locations and value attributes have been declared */ private static String[] resolveLocations(Class declaringClass, ContextConfiguration contextConfiguration) { @@ -81,7 +81,7 @@ public class ContextConfigurationAttributes { * supplied {@link ContextConfiguration @ContextConfiguration} annotation and * the {@link Class test class} that declared it. * @param declaringClass the test class that declared {@code @ContextConfiguration} - * @param contextConfiguration the annotation from which to retrieve the attributes + * @param contextConfiguration the annotation from which to retrieve the attributes */ public ContextConfigurationAttributes(Class declaringClass, ContextConfiguration contextConfiguration) { this(declaringClass, resolveLocations(declaringClass, contextConfiguration), contextConfiguration.classes(), @@ -93,14 +93,14 @@ public class ContextConfigurationAttributes { * {@link Class test class} that declared the * {@link ContextConfiguration @ContextConfiguration} annotation and its * corresponding attributes. - * + * * @param declaringClass the test class that declared {@code @ContextConfiguration} * @param locations the resource locations declared via {@code @ContextConfiguration} * @param classes the configuration classes declared via {@code @ContextConfiguration} * @param inheritLocations the inheritLocations flag declared via {@code @ContextConfiguration} * @param contextLoaderClass the {@code ContextLoader} class declared via {@code @ContextConfiguration} * @throws IllegalArgumentException if the {@code declaringClass} or {@code contextLoaderClass} is - * null, or if the {@code locations} and {@code classes} are both non-empty + * null, or if the {@code locations} and {@code classes} are both non-empty */ public ContextConfigurationAttributes(Class declaringClass, String[] locations, Class[] classes, boolean inheritLocations, Class contextLoaderClass) { @@ -138,12 +138,12 @@ public class ContextConfigurationAttributes { * Get the resource locations that were declared via * {@link ContextConfiguration @ContextConfiguration}. *

      Note: this is a mutable property. The returned value may therefore - * represent a processed value that does not match the original value + * represent a processed value that does not match the original value * declared via {@link ContextConfiguration @ContextConfiguration}. * @return the resource locations; potentially null or empty * @see ContextConfiguration#value * @see ContextConfiguration#locations - * @see #setLocations() + * @see #setLocations(String[]) */ public String[] getLocations() { return locations; @@ -162,11 +162,11 @@ public class ContextConfigurationAttributes { * Get the configuration classes that were declared via * {@link ContextConfiguration @ContextConfiguration}. *

      Note: this is a mutable property. The returned value may therefore - * represent a processed value that does not match the original value + * represent a processed value that does not match the original value * declared via {@link ContextConfiguration @ContextConfiguration}. * @return the configuration classes; potentially null or empty * @see ContextConfiguration#classes - * @see #setClasses() + * @see #setClasses(Class[]) */ public Class[] getClasses() { return classes; @@ -182,7 +182,7 @@ public class ContextConfigurationAttributes { } /** - * Determine if this {@code ContextConfigurationAttributes} instance has + * Determine if this {@code ContextConfigurationAttributes} instance has * path-based resource locations. * @return true if the {@link #getLocations() locations} array is not empty * @see #hasResources() @@ -193,7 +193,7 @@ public class ContextConfigurationAttributes { } /** - * Determine if this {@code ContextConfigurationAttributes} instance has + * Determine if this {@code ContextConfigurationAttributes} instance has * class-based resources. * @return true if the {@link #getClasses() classes} array is not empty * @see #hasResources() @@ -204,7 +204,7 @@ public class ContextConfigurationAttributes { } /** - * Determine if this {@code ContextConfigurationAttributes} instance has + * Determine if this {@code ContextConfigurationAttributes} instance has * either path-based resource locations or class-based resources. * @return true if either the {@link #getLocations() locations} * or the {@link #getClasses() classes} array is not empty diff --git a/spring-test/src/main/java/org/springframework/test/context/SmartContextLoader.java b/spring-test/src/main/java/org/springframework/test/context/SmartContextLoader.java index fbf6cd31da2..63d52418a9d 100644 --- a/spring-test/src/main/java/org/springframework/test/context/SmartContextLoader.java +++ b/spring-test/src/main/java/org/springframework/test/context/SmartContextLoader.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -21,7 +21,7 @@ import org.springframework.context.ApplicationContext; /** * Strategy interface for loading an {@link ApplicationContext application context} * for an integration test managed by the Spring TestContext Framework. - * + * *

      The {@code SmartContextLoader} SPI supersedes the {@link ContextLoader} SPI * introduced in Spring 2.5: a {@code SmartContextLoader} can choose to process * either resource locations or configuration classes. Furthermore, a @@ -34,13 +34,13 @@ import org.springframework.context.ApplicationContext; * processContextConfiguration()} prior to calling * {@link #loadContext(MergedContextConfiguration) loadContext()}. This gives a * {@code SmartContextLoader} the opportunity to provide custom support for - * modifying resource locations or detecting default resource locations or + * modifying resource locations or detecting default resource locations or * default configuration classes. The results of * {@link #processContextConfiguration(ContextConfigurationAttributes) * processContextConfiguration()} should be merged for all classes in the * hierarchy of the root test class and then supplied to * {@link #loadContext(MergedContextConfiguration) loadContext()}. - * + * *

      Even though {@code SmartContextLoader} extends {@code ContextLoader}, * clients should favor {@code SmartContextLoader}-specific methods over those * defined in {@code ContextLoader}, particularly because a @@ -97,7 +97,7 @@ public interface SmartContextLoader extends ContextLoader { * {@link org.springframework.beans.factory.annotation.Autowired @Autowired}, * {@link javax.annotation.Resource @Resource}, and * {@link javax.inject.Inject @Inject}. In addition, concrete implementations - * should set the active bean definition profiles in the context's + * should set the active bean definition profiles in the context's * {@link org.springframework.core.env.Environment Environment}. *

      Any ApplicationContext loaded by a * {@code SmartContextLoader} must register a JVM @@ -110,7 +110,8 @@ public interface SmartContextLoader extends ContextLoader { * @return a new application context * @throws Exception if context loading failed * @see #processContextConfiguration(ContextConfigurationAttributes) - * @see org.springframework.context.annotation.AnnotationConfigUtils#registerAnnotationConfigProcessors() + * @see org.springframework.context.annotation.AnnotationConfigUtils + * #registerAnnotationConfigProcessors(org.springframework.beans.factory.support.BeanDefinitionRegistry) * @see org.springframework.test.context.MergedContextConfiguration#getActiveProfiles() * @see org.springframework.context.ConfigurableApplicationContext#getEnvironment() */ diff --git a/spring-test/src/main/java/org/springframework/test/context/junit4/statements/RunAfterTestMethodCallbacks.java b/spring-test/src/main/java/org/springframework/test/context/junit4/statements/RunAfterTestMethodCallbacks.java index 76ba939bce4..925e9f468aa 100644 --- a/spring-test/src/main/java/org/springframework/test/context/junit4/statements/RunAfterTestMethodCallbacks.java +++ b/spring-test/src/main/java/org/springframework/test/context/junit4/statements/RunAfterTestMethodCallbacks.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -28,9 +28,9 @@ import org.springframework.test.context.TestContextManager; * RunAfterTestMethodCallbacks is a custom JUnit 4.5+ * {@link Statement} which allows the Spring TestContext Framework to * be plugged into the JUnit execution chain by calling - * {@link TestContextManager#afterTestMethod(Object, Method) afterTestMethod()} + * {@link TestContextManager#afterTestMethod(Object, Method, Throwable) afterTestMethod()} * on the supplied {@link TestContextManager}. - * + * * @see #evaluate() * @see RunBeforeTestMethodCallbacks * @author Sam Brannen @@ -50,7 +50,7 @@ public class RunAfterTestMethodCallbacks extends Statement { /** * Constructs a new RunAfterTestMethodCallbacks statement. - * + * * @param next the next Statement in the execution chain * @param testInstance the current test instance (never null) * @param testMethod the test method which has just been executed on the @@ -70,7 +70,7 @@ public class RunAfterTestMethodCallbacks extends Statement { * Invokes the next {@link Statement} in the execution chain (typically an * instance of {@link org.junit.internal.runners.statements.RunAfters * RunAfters}), catching any exceptions thrown, and then calls - * {@link TestContextManager#afterTestMethod(Object, Method)} with the first + * {@link TestContextManager#afterTestMethod(Object, Method, Throwable)} with the first * caught exception (if any). If the call to afterTestMethod() * throws an exception, it will also be tracked. Multiple exceptions will be * combined into a {@link MultipleFailureException}. diff --git a/spring-test/src/main/java/org/springframework/test/context/support/AbstractContextLoader.java b/spring-test/src/main/java/org/springframework/test/context/support/AbstractContextLoader.java index 44e18cf1ecb..83e50888e77 100644 --- a/spring-test/src/main/java/org/springframework/test/context/support/AbstractContextLoader.java +++ b/spring-test/src/main/java/org/springframework/test/context/support/AbstractContextLoader.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -35,11 +35,12 @@ import org.springframework.util.StringUtils; * implementations of the {@link ContextLoader} SPI. Provides a * Template Method based approach for {@link #processLocations processing} * resource locations. - * + * *

      As of Spring 3.1, AbstractContextLoader also provides a basis * for all concrete implementations of the {@link SmartContextLoader} SPI. For - * backwards compatibility with the {@code ContextLoader} SPI, - * {@link #processContextConfiguration()} delegates to {@link #processLocations()}. + * backwards compatibility with the {@code ContextLoader} SPI, + * {@link #processContextConfiguration(ContextConfigurationAttributes)} delegates + * to {@link #processLocations(Class, String...)}. * * @author Sam Brannen * @author Juergen Hoeller @@ -59,7 +60,7 @@ public abstract class AbstractContextLoader implements SmartContextLoader { /** * For backwards compatibility with the {@link ContextLoader} SPI, the - * default implementation simply delegates to {@link #processLocations()}, + * default implementation simply delegates to {@link #processLocations(Class, String...)}, * passing it the {@link ContextConfigurationAttributes#getDeclaringClass() * declaring class} and {@link ContextConfigurationAttributes#getLocations() * resource locations} retrieved from the supplied @@ -70,7 +71,7 @@ public abstract class AbstractContextLoader implements SmartContextLoader { *

      Can be overridden in subclasses — for example, to process * configuration classes instead of resource locations. * @since 3.1 - * @see #processLocations() + * @see #processLocations(Class, String...) */ public void processContextConfiguration(ContextConfigurationAttributes configAttributes) { String[] processedLocations = processLocations(configAttributes.getDeclaringClass(), @@ -96,10 +97,10 @@ public abstract class AbstractContextLoader implements SmartContextLoader { * @return a processed array of application context resource locations * @since 2.5 * @see #isGenerateDefaultLocations() - * @see #generateDefaultLocations() - * @see #modifyLocations() - * @see org.springframework.test.context.ContextLoader#processLocations() - * @see #processContextConfiguration() + * @see #generateDefaultLocations(Class) + * @see #modifyLocations(Class, String...) + * @see org.springframework.test.context.ContextLoader#processLocations(Class, String...) + * @see #processContextConfiguration(ContextConfigurationAttributes) */ public final String[] processLocations(Class clazz, String... locations) { return (ObjectUtils.isEmpty(locations) && isGenerateDefaultLocations()) ? generateDefaultLocations(clazz) @@ -115,7 +116,7 @@ public abstract class AbstractContextLoader implements SmartContextLoader { * where <suffix> is the value of the * {@link #getResourceSuffix() resource suffix} string. *

      As of Spring 3.1, the implementation of this method adheres to the - * contract defined in the {@link SmartContextLoader} SPI. Specifically, + * contract defined in the {@link SmartContextLoader} SPI. Specifically, * this method will preemptively verify that the generated default * location actually exists. If it does not exist, this method will log a * warning and return an empty array. @@ -189,14 +190,15 @@ public abstract class AbstractContextLoader implements SmartContextLoader { /** * Determine whether or not default resource locations should be * generated if the locations provided to - * {@link #processLocations()} are null or empty. + * {@link #processLocations(Class, String...)} are null or empty. *

      As of Spring 3.1, the semantics of this method have been overloaded * to include detection of either default resource locations or default - * configuration classes. Consequently, this method can also be used to + * configuration classes. Consequently, this method can also be used to * determine whether or not default configuration classes should be * detected if the classes present in the * {@link ContextConfigurationAttributes configuration attributes} supplied - * to {@link #processContextConfiguration()} are null or empty. + * to {@link #processContextConfiguration(ContextConfigurationAttributes)} + * are null or empty. *

      Can be overridden by subclasses to change the default behavior. * @return always true by default * @since 2.5 @@ -211,7 +213,7 @@ public abstract class AbstractContextLoader implements SmartContextLoader { *

      Must be implemented by subclasses. * @return the resource suffix; should not be null or empty * @since 2.5 - * @see #generateDefaultLocations() + * @see #generateDefaultLocations(Class) */ protected abstract String getResourceSuffix(); diff --git a/spring-test/src/main/java/org/springframework/test/context/support/AbstractGenericContextLoader.java b/spring-test/src/main/java/org/springframework/test/context/support/AbstractGenericContextLoader.java index 243e10da4d8..6da30280093 100644 --- a/spring-test/src/main/java/org/springframework/test/context/support/AbstractGenericContextLoader.java +++ b/spring-test/src/main/java/org/springframework/test/context/support/AbstractGenericContextLoader.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -29,7 +29,7 @@ import org.springframework.util.StringUtils; /** * Abstract, generic extension of {@link AbstractContextLoader} that loads a * {@link GenericApplicationContext}. - * + * *

        *
      • If instances of concrete subclasses are invoked via the * {@link org.springframework.test.context.ContextLoader ContextLoader} SPI, the @@ -38,7 +38,7 @@ import org.springframework.util.StringUtils; *
      • If instances of concrete subclasses are invoked via the * {@link org.springframework.test.context.SmartContextLoader SmartContextLoader} * SPI, the context will be loaded from the {@link MergedContextConfiguration} - * provided to {@link #loadContext(MergedContextConfiguration)}. In such cases, a + * provided to {@link #loadContext(MergedContextConfiguration)}. In such cases, a * SmartContextLoader will decide whether to load the context from * locations or * {@link org.springframework.context.annotation.Configuration configuration classes}.
      • @@ -68,17 +68,17 @@ public abstract class AbstractGenericContextLoader extends AbstractContextLoader *
      • Sets the active bean definition profiles from the supplied * MergedContextConfiguration in the * {@link org.springframework.core.env.Environment Environment} of the context.
      • - *
      • Calls {@link #prepareContext()} to allow for customizing the context + *
      • Calls {@link #prepareContext(GenericApplicationContext)} to allow for customizing the context * before bean definitions are loaded.
      • - *
      • Calls {@link #customizeBeanFactory()} to allow for customizing the + *
      • Calls {@link #customizeBeanFactory(DefaultListableBeanFactory)} to allow for customizing the * context's DefaultListableBeanFactory.
      • - *
      • Delegates to {@link #loadBeanDefinitions()} to populate the context - * from the configuration locations or classes in the supplied + *
      • Delegates to {@link #loadBeanDefinitions(GenericApplicationContext, MergedContextConfiguration)} + * to populate the context from the configuration locations or classes in the supplied * MergedContextConfiguration.
      • *
      • Delegates to {@link AnnotationConfigUtils} for * {@link AnnotationConfigUtils#registerAnnotationConfigProcessors registering} * annotation configuration processors.
      • - *
      • Calls {@link #customizeContext()} to allow for customizing the context + *
      • Calls {@link #customizeContext(GenericApplicationContext)} to allow for customizing the context * before it is refreshed.
      • *
      • {@link ConfigurableApplicationContext#refresh Refreshes} the * context and registers a JVM shutdown hook for it.
      • @@ -110,17 +110,17 @@ public abstract class AbstractGenericContextLoader extends AbstractContextLoader *

        Implementation details: *

          *
        • Creates a {@link GenericApplicationContext} instance.
        • - *
        • Calls {@link #prepareContext()} to allow for customizing the context + *
        • Calls {@link #prepareContext(GenericApplicationContext)} to allow for customizing the context * before bean definitions are loaded.
        • - *
        • Calls {@link #customizeBeanFactory()} to allow for customizing the + *
        • Calls {@link #customizeBeanFactory(DefaultListableBeanFactory)} to allow for customizing the * context's DefaultListableBeanFactory.
        • - *
        • Delegates to {@link #createBeanDefinitionReader()} to create a + *
        • Delegates to {@link #createBeanDefinitionReader(GenericApplicationContext)} to create a * {@link BeanDefinitionReader} which is then used to populate the context * from the specified config locations.
        • *
        • Delegates to {@link AnnotationConfigUtils} for * {@link AnnotationConfigUtils#registerAnnotationConfigProcessors registering} * annotation configuration processors.
        • - *
        • Calls {@link #customizeContext()} to allow for customizing the context + *
        • Calls {@link #customizeContext(GenericApplicationContext)} to allow for customizing the context * before it is refreshed.
        • *
        • {@link ConfigurableApplicationContext#refresh Refreshes} the * context and registers a JVM shutdown hook for it.
        • @@ -188,16 +188,16 @@ public abstract class AbstractGenericContextLoader extends AbstractContextLoader * from the configuration locations or classes in the supplied * MergedContextConfiguration. *

          The default implementation delegates to the {@link BeanDefinitionReader} - * returned by {@link #createBeanDefinitionReader()} to + * returned by {@link #createBeanDefinitionReader(GenericApplicationContext)} to * {@link BeanDefinitionReader#loadBeanDefinitions(String) load} the * bean definitions. *

          Subclasses must provide an appropriate implementation of - * {@link #createBeanDefinitionReader()}. Alternatively subclasses may + * {@link #createBeanDefinitionReader(GenericApplicationContext)}. Alternatively subclasses may * provide a no-op implementation of {@code createBeanDefinitionReader()} * and override this method to provide a custom strategy for loading or * registering bean definitions. * @param context the context into which the bean definitions should be loaded - * @param mergedConfig the merged context configuration + * @param mergedConfig the merged context configuration * @see #loadContext(MergedContextConfiguration) * @since 3.1 */ diff --git a/spring-test/src/main/java/org/springframework/test/context/support/AnnotationConfigContextLoader.java b/spring-test/src/main/java/org/springframework/test/context/support/AnnotationConfigContextLoader.java index 9839adc03c9..8d92ff51a42 100644 --- a/spring-test/src/main/java/org/springframework/test/context/support/AnnotationConfigContextLoader.java +++ b/spring-test/src/main/java/org/springframework/test/context/support/AnnotationConfigContextLoader.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -35,7 +35,7 @@ import org.springframework.util.ObjectUtils; * Concrete implementation of {@link AbstractGenericContextLoader} that loads * bean definitions from * {@link org.springframework.context.annotation.Configuration configuration classes}. - * + * *

          Note: AnnotationConfigContextLoader supports * {@link org.springframework.context.annotation.Configuration configuration classes} * rather than the String-based resource locations defined by the legacy @@ -46,13 +46,13 @@ import org.springframework.util.ObjectUtils; * AbstractContextLoader or AbstractGenericContextLoader. * Consequently, AnnotationConfigContextLoader should chiefly be * considered a {@link org.springframework.test.context.SmartContextLoader SmartContextLoader} - * rather than a {@link org.springframework.test.context.ContextLoader ContextLoader}. - * + * rather than a {@link org.springframework.test.context.ContextLoader ContextLoader}. + * * @author Sam Brannen * @since 3.1 - * @see #processContextConfiguration() - * @see #detectDefaultConfigurationClasses() - * @see #loadBeanDefinitions() + * @see #processContextConfiguration(ContextConfigurationAttributes) + * @see #detectDefaultConfigurationClasses(Class) + * @see #loadBeanDefinitions(GenericApplicationContext, MergedContextConfiguration) */ public class AnnotationConfigContextLoader extends AbstractGenericContextLoader { @@ -72,9 +72,9 @@ public class AnnotationConfigContextLoader extends AbstractGenericContextLoader * supplied configuration attributes. Otherwise, properties in the supplied * configuration attributes will not be modified. * @param configAttributes the context configuration attributes to process - * @see org.springframework.test.context.SmartContextLoader#processContextConfiguration() + * @see org.springframework.test.context.SmartContextLoader#processContextConfiguration(ContextConfigurationAttributes) * @see #isGenerateDefaultLocations() - * @see #detectDefaultConfigurationClasses() + * @see #detectDefaultConfigurationClasses(Class) */ public void processContextConfiguration(ContextConfigurationAttributes configAttributes) { if (ObjectUtils.isEmpty(configAttributes.getClasses()) && isGenerateDefaultLocations()) { @@ -117,7 +117,7 @@ public class AnnotationConfigContextLoader extends AbstractGenericContextLoader * {@link Configuration @Configuration}. *

          The implementation of this method adheres to the contract defined in the * {@link org.springframework.test.context.SmartContextLoader SmartContextLoader} - * SPI. Specifically, this method uses introspection to detect default + * SPI. Specifically, this method uses introspection to detect default * configuration classes that comply with the constraints required of * {@code @Configuration} class implementations. If a potential candidate * configuration class does meet these requirements, this method will log a @@ -187,7 +187,7 @@ public class AnnotationConfigContextLoader extends AbstractGenericContextLoader } /** - * AnnotationConfigContextLoader should be used as a + * AnnotationConfigContextLoader should be used as a * {@link org.springframework.test.context.SmartContextLoader SmartContextLoader}, * not as a legacy {@link org.springframework.test.context.ContextLoader ContextLoader}. * Consequently, this method is not supported. @@ -226,7 +226,7 @@ public class AnnotationConfigContextLoader extends AbstractGenericContextLoader } /** - * AnnotationConfigContextLoader should be used as a + * AnnotationConfigContextLoader should be used as a * {@link org.springframework.test.context.SmartContextLoader SmartContextLoader}, * not as a legacy {@link org.springframework.test.context.ContextLoader ContextLoader}. * Consequently, this method is not supported. diff --git a/spring-tx/src/main/java/org/springframework/jca/work/jboss/JBossWorkManagerUtils.java b/spring-tx/src/main/java/org/springframework/jca/work/jboss/JBossWorkManagerUtils.java index f25330148d2..7c2757b600c 100644 --- a/spring-tx/src/main/java/org/springframework/jca/work/jboss/JBossWorkManagerUtils.java +++ b/spring-tx/src/main/java/org/springframework/jca/work/jboss/JBossWorkManagerUtils.java @@ -53,7 +53,7 @@ public abstract class JBossWorkManagerUtils { /** * Obtain the default JBoss JCA WorkManager through a JMX lookup * for the JBossWorkManagerMBean. - * @param workManagerObjectName the JMX object name to use + * @param mbeanName the JMX object name to use * @see org.jboss.resource.work.JBossWorkManagerMBean */ public static WorkManager getWorkManager(String mbeanName) { diff --git a/spring-tx/src/main/java/org/springframework/transaction/annotation/EnableTransactionManagement.java b/spring-tx/src/main/java/org/springframework/transaction/annotation/EnableTransactionManagement.java index da6ea649429..aa51af07e74 100644 --- a/spring-tx/src/main/java/org/springframework/transaction/annotation/EnableTransactionManagement.java +++ b/spring-tx/src/main/java/org/springframework/transaction/annotation/EnableTransactionManagement.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -157,7 +157,7 @@ public @interface EnableTransactionManagement { /** * Indicate how transactional advice should be applied. The default is - * {@link AdviceMode.PROXY}. + * {@link AdviceMode#PROXY}. * @see AdviceMode */ AdviceMode mode() default AdviceMode.PROXY; diff --git a/spring-tx/src/main/java/org/springframework/transaction/interceptor/TransactionProxyFactoryBean.java b/spring-tx/src/main/java/org/springframework/transaction/interceptor/TransactionProxyFactoryBean.java index fe7ab37bbea..eaf963cc397 100644 --- a/spring-tx/src/main/java/org/springframework/transaction/interceptor/TransactionProxyFactoryBean.java +++ b/spring-tx/src/main/java/org/springframework/transaction/interceptor/TransactionProxyFactoryBean.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -156,7 +156,6 @@ public class TransactionProxyFactoryBean extends AbstractSingletonProxyFactoryBe * @see TransactionAttributeSourceEditor * @see MethodMapTransactionAttributeSource * @see NameMatchTransactionAttributeSource - * @see AttributesTransactionAttributeSource * @see org.springframework.transaction.annotation.AnnotationTransactionAttributeSource */ public void setTransactionAttributeSource(TransactionAttributeSource transactionAttributeSource) { diff --git a/spring-tx/src/main/java/org/springframework/transaction/support/DelegatingTransactionDefinition.java b/spring-tx/src/main/java/org/springframework/transaction/support/DelegatingTransactionDefinition.java index 8e15758e224..d3e111f5bdb 100644 --- a/spring-tx/src/main/java/org/springframework/transaction/support/DelegatingTransactionDefinition.java +++ b/spring-tx/src/main/java/org/springframework/transaction/support/DelegatingTransactionDefinition.java @@ -37,7 +37,7 @@ public abstract class DelegatingTransactionDefinition implements TransactionDefi /** * Create a DelegatingTransactionAttribute for the given target attribute. - * @param targetAttribute the target TransactionAttribute to delegate to + * @param targetDefinition the target TransactionAttribute to delegate to */ public DelegatingTransactionDefinition(TransactionDefinition targetDefinition) { Assert.notNull(targetDefinition, "Target definition must not be null"); diff --git a/spring-web/src/main/java/org/springframework/http/client/ClientHttpRequestInterceptor.java b/spring-web/src/main/java/org/springframework/http/client/ClientHttpRequestInterceptor.java index f6b9f1a8366..410cdeb2ff6 100644 --- a/spring-web/src/main/java/org/springframework/http/client/ClientHttpRequestInterceptor.java +++ b/spring-web/src/main/java/org/springframework/http/client/ClientHttpRequestInterceptor.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -22,7 +22,7 @@ import org.springframework.http.HttpRequest; /** * Intercepts client-side HTTP requests. Implementations of this interface can be {@linkplain - * org.springframework.web.client.RestTemplate#setInterceptors(ClientHttpRequestInterceptor[]) registered} with the + * org.springframework.web.client.RestTemplate#setInterceptors(java.util.List) registered} with the * {@link org.springframework.web.client.RestTemplate RestTemplate}, as to modify the outgoing {@link ClientHttpRequest} * and/or the incoming {@link ClientHttpResponse}. * diff --git a/spring-web/src/main/java/org/springframework/http/converter/HttpMessageNotWritableException.java b/spring-web/src/main/java/org/springframework/http/converter/HttpMessageNotWritableException.java index 5e6580b392a..29f8dc4fe9a 100644 --- a/spring-web/src/main/java/org/springframework/http/converter/HttpMessageNotWritableException.java +++ b/spring-web/src/main/java/org/springframework/http/converter/HttpMessageNotWritableException.java @@ -18,7 +18,8 @@ package org.springframework.http.converter; /** * Thrown by {@link org.springframework.http.converter.HttpMessageConverter} implementations when the - * {@link org.springframework.http.converter.HttpMessageConverter#write(Object, org.springframework.http.HttpOutputMessage) write} method fails. + * {@link org.springframework.http.converter.HttpMessageConverter#write(Object, org.springframework.http.MediaType, + * org.springframework.http.HttpOutputMessage) write} method fails. * * @author Arjen Poutsma * @since 3.0 diff --git a/spring-web/src/main/java/org/springframework/web/bind/annotation/CookieValue.java b/spring-web/src/main/java/org/springframework/web/bind/annotation/CookieValue.java index aab76733f16..1bc57b7f90e 100644 --- a/spring-web/src/main/java/org/springframework/web/bind/annotation/CookieValue.java +++ b/spring-web/src/main/java/org/springframework/web/bind/annotation/CookieValue.java @@ -35,7 +35,8 @@ import java.lang.annotation.Target; * @see RequestParam * @see RequestHeader * @see org.springframework.web.bind.annotation.RequestMapping - * @see org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMethodAdapter + * @see org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter + * @see org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter * @see org.springframework.web.portlet.mvc.annotation.AnnotationMethodHandlerAdapter */ @Target(ElementType.PARAMETER) diff --git a/spring-web/src/main/java/org/springframework/web/bind/annotation/PathVariable.java b/spring-web/src/main/java/org/springframework/web/bind/annotation/PathVariable.java index 40b157534e8..4a117205233 100644 --- a/spring-web/src/main/java/org/springframework/web/bind/annotation/PathVariable.java +++ b/spring-web/src/main/java/org/springframework/web/bind/annotation/PathVariable.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -29,7 +29,8 @@ import java.lang.annotation.Target; * * @author Arjen Poutsma * @see RequestMapping - * @see org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMethodAdapter + * @see org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter + * @see org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter * @since 3.0 */ @Target(ElementType.PARAMETER) diff --git a/spring-web/src/main/java/org/springframework/web/bind/annotation/RequestBody.java b/spring-web/src/main/java/org/springframework/web/bind/annotation/RequestBody.java index 6ea18e30844..b5712abed9b 100644 --- a/spring-web/src/main/java/org/springframework/web/bind/annotation/RequestBody.java +++ b/spring-web/src/main/java/org/springframework/web/bind/annotation/RequestBody.java @@ -25,17 +25,18 @@ import java.lang.annotation.Target; import org.springframework.http.converter.HttpMessageConverter; /** - * Annotation indicating a method parameter should be bound to the body of the web request. - * The body of the request is passed through an {@link HttpMessageConverter} to resolve the - * method argument depending on the content type of the request. Optionally, automatic + * Annotation indicating a method parameter should be bound to the body of the web request. + * The body of the request is passed through an {@link HttpMessageConverter} to resolve the + * method argument depending on the content type of the request. Optionally, automatic * validation can be applied by annotating the argument with {@code @Valid}. - * + * *

          Supported for annotated handler methods in Servlet environments. * * @author Arjen Poutsma * @see RequestHeader * @see ResponseBody - * @see org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMethodAdapter + * @see org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter + * @see org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter * @since 3.0 */ @Target(ElementType.PARAMETER) diff --git a/spring-web/src/main/java/org/springframework/web/bind/annotation/RequestHeader.java b/spring-web/src/main/java/org/springframework/web/bind/annotation/RequestHeader.java index ef962da7aa0..2841462e4cd 100644 --- a/spring-web/src/main/java/org/springframework/web/bind/annotation/RequestHeader.java +++ b/spring-web/src/main/java/org/springframework/web/bind/annotation/RequestHeader.java @@ -31,7 +31,7 @@ import java.lang.annotation.Target; * @see RequestMapping * @see RequestParam * @see CookieValue - * @see org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMethodAdapter + * @see org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter * @see org.springframework.web.portlet.mvc.annotation.AnnotationMethodHandlerAdapter */ @Target(ElementType.PARAMETER) diff --git a/spring-web/src/main/java/org/springframework/web/bind/annotation/RequestMapping.java b/spring-web/src/main/java/org/springframework/web/bind/annotation/RequestMapping.java index 2f4970b8e88..fe93c5b159a 100644 --- a/spring-web/src/main/java/org/springframework/web/bind/annotation/RequestMapping.java +++ b/spring-web/src/main/java/org/springframework/web/bind/annotation/RequestMapping.java @@ -57,7 +57,7 @@ import java.util.concurrent.Callable; * As a consequence, such an argument will never be null. * Note that session access may not be thread-safe, in particular in a * Servlet environment: Consider switching the - * {@link org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMethodAdapter#setSynchronizeOnSession "synchronizeOnSession"} + * {@link org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter#setSynchronizeOnSession "synchronizeOnSession"} * flag to "true" if multiple requests are allowed to access a session concurrently. *

        • {@link org.springframework.web.context.request.WebRequest} or * {@link org.springframework.web.context.request.NativeWebRequest}. @@ -242,8 +242,7 @@ import java.util.concurrent.Callable; * @see SessionAttributes * @see InitBinder * @see org.springframework.web.context.request.WebRequest - * @see org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMethodMapping - * @see org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMethodAdapter + * @see org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter * @see org.springframework.web.portlet.mvc.annotation.DefaultAnnotationHandlerMapping * @see org.springframework.web.portlet.mvc.annotation.AnnotationMethodHandlerAdapter */ diff --git a/spring-web/src/main/java/org/springframework/web/bind/annotation/RequestParam.java b/spring-web/src/main/java/org/springframework/web/bind/annotation/RequestParam.java index 591f4ad5f8b..0997a589696 100644 --- a/spring-web/src/main/java/org/springframework/web/bind/annotation/RequestParam.java +++ b/spring-web/src/main/java/org/springframework/web/bind/annotation/RequestParam.java @@ -26,14 +26,15 @@ import java.lang.annotation.Target; * Annotation which indicates that a method parameter should be bound to a web * request parameter. Supported for annotated handler methods in Servlet and * Portlet environments. - * + * * @author Arjen Poutsma * @author Juergen Hoeller * @since 2.5 * @see RequestMapping * @see RequestHeader * @see CookieValue - * @see org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMethodAdapter + * @see org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter + * @see org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter * @see org.springframework.web.portlet.mvc.annotation.AnnotationMethodHandlerAdapter */ @Target(ElementType.PARAMETER) diff --git a/spring-web/src/main/java/org/springframework/web/bind/support/ConfigurableWebBindingInitializer.java b/spring-web/src/main/java/org/springframework/web/bind/support/ConfigurableWebBindingInitializer.java index 2d5cd6b5acb..68a251d8329 100644 --- a/spring-web/src/main/java/org/springframework/web/bind/support/ConfigurableWebBindingInitializer.java +++ b/spring-web/src/main/java/org/springframework/web/bind/support/ConfigurableWebBindingInitializer.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -62,7 +62,7 @@ public class ConfigurableWebBindingInitializer implements WebBindingInitializer * when accessing an out-of-bounds index. *

          Default is "true" on a standard DataBinder. Note that this feature is only supported * for bean property access (DataBinder's default mode), not for field access. - * @see #initBeanPropertyAccess() + * @see org.springframework.validation.DataBinder#initBeanPropertyAccess() * @see org.springframework.validation.DataBinder#setAutoGrowNestedPaths */ public void setAutoGrowNestedPaths(boolean autoGrowNestedPaths) { diff --git a/spring-web/src/main/java/org/springframework/web/context/ContextLoader.java b/spring-web/src/main/java/org/springframework/web/context/ContextLoader.java index 79c3d8744ca..9abcece00ba 100644 --- a/spring-web/src/main/java/org/springframework/web/context/ContextLoader.java +++ b/spring-web/src/main/java/org/springframework/web/context/ContextLoader.java @@ -202,7 +202,7 @@ public class ContextLoader { * ContextLoaderListener} subclass as a {@code } within {@code web.xml}, as * a no-arg constructor is required. *

          The created application context will be registered into the ServletContext under - * the attribute name {@link WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE} + * the attribute name {@link WebApplicationContext#ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE} * and subclasses are free to call the {@link #closeWebApplicationContext} method on * container shutdown to close the application context. * @see #ContextLoader(WebApplicationContext) @@ -238,7 +238,7 @@ public class ContextLoader { *

          See {@link org.springframework.web.WebApplicationInitializer} for usage examples. *

          In any case, the given application context will be registered into the * ServletContext under the attribute name {@link - * WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE} and subclasses are + * WebApplicationContext#ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE} and subclasses are * free to call the {@link #closeWebApplicationContext} method on container shutdown * to close the application context. * @param context the application context to manage @@ -325,7 +325,6 @@ public class ContextLoader { *

          In addition, {@link #customizeContext} gets called prior to refreshing the * context, allowing subclasses to perform custom modifications to the context. * @param sc current servlet context - * @param parent the parent ApplicationContext to use, or null if none * @return the root WebApplicationContext * @see ConfigurableWebApplicationContext */ @@ -343,7 +342,7 @@ public class ContextLoader { /** * @deprecated as of Spring 3.1 in favor of * {@link #createWebApplicationContext(ServletContext)} and - * {@link #configureAndRefreshWebApplicationContext(WebApplicationContext, ServletContext)} + * {@link #configureAndRefreshWebApplicationContext(ConfigurableWebApplicationContext, ServletContext)} */ @Deprecated protected WebApplicationContext createWebApplicationContext(ServletContext sc, ApplicationContext parent) { diff --git a/spring-web/src/main/java/org/springframework/web/context/ContextLoaderListener.java b/spring-web/src/main/java/org/springframework/web/context/ContextLoaderListener.java index 28de0fa40ec..d378ffdfac0 100644 --- a/spring-web/src/main/java/org/springframework/web/context/ContextLoaderListener.java +++ b/spring-web/src/main/java/org/springframework/web/context/ContextLoaderListener.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -52,7 +52,7 @@ public class ContextLoaderListener extends ContextLoader implements ServletConte * as a {@code } within {@code web.xml}, where a no-arg constructor is * required. *

          The created application context will be registered into the ServletContext under - * the attribute name {@link WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE} + * the attribute name {@link WebApplicationContext#ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE} * and the Spring application context will be closed when the {@link #contextDestroyed} * lifecycle method is invoked on this listener. * @see ContextLoader @@ -66,21 +66,22 @@ public class ContextLoaderListener extends ContextLoader implements ServletConte /** * Create a new {@code ContextLoaderListener} with the given application context. This * constructor is useful in Servlet 3.0+ environments where instance-based - * registration of listeners is possible through the {@link ServletContext#addListener} + * registration of listeners is possible through the {@link javax.servlet.ServletContext#addListener} * API. *

          The context may or may not yet be {@linkplain - * ConfigurableApplicationContext#refresh() refreshed}. If it (a) is an implementation - * of {@link ConfigurableWebApplicationContext} and (b) has not - * already been refreshed (the recommended approach), then the following will occur: + * org.springframework.context.ConfigurableApplicationContext#refresh() refreshed}. If it + * (a) is an implementation of {@link ConfigurableWebApplicationContext} and + * (b) has not already been refreshed (the recommended approach), + * then the following will occur: *

            *
          • If the given context has not already been assigned an {@linkplain - * ConfigurableApplicationContext#setId id}, one will be assigned to it
          • + * org.springframework.context.ConfigurableApplicationContext#setId id}, one will be assigned to it *
          • {@code ServletContext} and {@code ServletConfig} objects will be delegated to * the application context
          • *
          • {@link #customizeContext} will be called
          • - *
          • Any {@link ApplicationContextInitializer}s specified through the - * "contextInitializerClasses" init-param will be applied.
          • - *
          • {@link ConfigurableApplicationContext#refresh refresh()} will be called
          • + *
          • Any {@link org.springframework.context.ApplicationContextInitializer ApplicationContextInitializer}s + * specified through the "contextInitializerClasses" init-param will be applied.
          • + *
          • {@link org.springframework.context.ConfigurableApplicationContext#refresh refresh()} will be called
          • *
          * If the context has already been refreshed or does not implement * {@code ConfigurableWebApplicationContext}, none of the above will occur under the @@ -89,7 +90,7 @@ public class ContextLoaderListener extends ContextLoader implements ServletConte *

          See {@link org.springframework.web.WebApplicationInitializer} for usage examples. *

          In any case, the given application context will be registered into the * ServletContext under the attribute name {@link - * WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE} and the Spring + * WebApplicationContext#ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE} and the Spring * application context will be closed when the {@link #contextDestroyed} lifecycle * method is invoked on this listener. * @param context the application context to manage diff --git a/spring-web/src/main/java/org/springframework/web/context/support/AnnotationConfigWebApplicationContext.java b/spring-web/src/main/java/org/springframework/web/context/support/AnnotationConfigWebApplicationContext.java index 02a46b68f83..8f672aae419 100644 --- a/spring-web/src/main/java/org/springframework/web/context/support/AnnotationConfigWebApplicationContext.java +++ b/spring-web/src/main/java/org/springframework/web/context/support/AnnotationConfigWebApplicationContext.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -137,7 +137,7 @@ public class AnnotationConfigWebApplicationContext extends AbstractRefreshableWe *

          Calls to {@link #register} are idempotent; adding the same * annotated class more than once has no additional effect. * @param annotatedClasses one or more annotated classes, - * e.g. {@link Configuration @Configuration} classes + * e.g. {@link org.springframework.context.annotation.Configuration @Configuration} classes * @see #scan(String...) * @see #loadBeanDefinitions(DefaultListableBeanFactory) * @see #setConfigLocation(String) @@ -179,8 +179,8 @@ public class AnnotationConfigWebApplicationContext extends AbstractRefreshableWe * annotation. * @see #register(Class...) * @see #scan(String...) - * @see #setConfigLocation() - * @see #setConfigLocations() + * @see #setConfigLocation(String) + * @see #setConfigLocations(String[]) * @see AnnotatedBeanDefinitionReader * @see ClassPathBeanDefinitionScanner */ @@ -267,7 +267,7 @@ public class AnnotationConfigWebApplicationContext extends AbstractRefreshableWe /** * Set the {@link ScopeMetadataResolver} to use for detected bean classes. - *

          The default is an {@link AnnotationScopeMetadataResolver}. + *

          The default is an {@link org.springframework.context.annotation.AnnotationScopeMetadataResolver}. */ public void setScopeMetadataResolver(ScopeMetadataResolver scopeMetadataResolver) { this.scopeMetadataResolver = scopeMetadataResolver; diff --git a/spring-webmvc-portlet/src/main/java/org/springframework/web/portlet/DispatcherPortlet.java b/spring-webmvc-portlet/src/main/java/org/springframework/web/portlet/DispatcherPortlet.java index c57c33703e8..98029b9a6ba 100644 --- a/spring-webmvc-portlet/src/main/java/org/springframework/web/portlet/DispatcherPortlet.java +++ b/spring-webmvc-portlet/src/main/java/org/springframework/web/portlet/DispatcherPortlet.java @@ -963,7 +963,6 @@ public class DispatcherPortlet extends FrameworkPortlet { * Return the HandlerExecutionChain for this request. * Try all handler mappings in order. * @param request current portlet request - * @param cache whether to cache the HandlerExecutionChain in a request attribute * @return the HandlerExceutionChain, or null if no handler could be found */ protected HandlerExecutionChain getHandler(PortletRequest request) throws Exception { diff --git a/spring-webmvc-portlet/src/main/java/org/springframework/web/portlet/context/AbstractRefreshablePortletApplicationContext.java b/spring-webmvc-portlet/src/main/java/org/springframework/web/portlet/context/AbstractRefreshablePortletApplicationContext.java index 459a03c7644..56b04da88ff 100644 --- a/spring-webmvc-portlet/src/main/java/org/springframework/web/portlet/context/AbstractRefreshablePortletApplicationContext.java +++ b/spring-webmvc-portlet/src/main/java/org/springframework/web/portlet/context/AbstractRefreshablePortletApplicationContext.java @@ -91,7 +91,7 @@ public abstract class AbstractRefreshablePortletApplicationContext extends Abstr * {@inheritDoc} *

          The parent {@linkplain #getEnvironment() environment} is * delegated to this (child) context if the parent is a - * {@link ConfigurableApplicationContext} implementation. + * {@link org.springframework.context.ConfigurableApplicationContext} implementation. *

          The parent {@linkplain #getServletContext() servlet context} is * delegated to this (child) context if the parent is a {@link WebApplicationContext} * implementation. diff --git a/spring-webmvc-portlet/src/main/java/org/springframework/web/portlet/context/PortletContextScope.java b/spring-webmvc-portlet/src/main/java/org/springframework/web/portlet/context/PortletContextScope.java index bdd5f6846c6..4f3e0178b95 100644 --- a/spring-webmvc-portlet/src/main/java/org/springframework/web/portlet/context/PortletContextScope.java +++ b/spring-webmvc-portlet/src/main/java/org/springframework/web/portlet/context/PortletContextScope.java @@ -54,7 +54,7 @@ public class PortletContextScope implements Scope, DisposableBean { /** * Create a new Scope wrapper for the given PortletContext. - * @param PortletContext the PortletContext to wrap + * @param portletContext the PortletContext to wrap */ public PortletContextScope(PortletContext portletContext) { Assert.notNull(portletContext, "PortletContext must not be null"); diff --git a/spring-webmvc-portlet/src/main/java/org/springframework/web/portlet/context/StaticPortletApplicationContext.java b/spring-webmvc-portlet/src/main/java/org/springframework/web/portlet/context/StaticPortletApplicationContext.java index 7ffc7633657..7452f6b34cd 100644 --- a/spring-webmvc-portlet/src/main/java/org/springframework/web/portlet/context/StaticPortletApplicationContext.java +++ b/spring-webmvc-portlet/src/main/java/org/springframework/web/portlet/context/StaticPortletApplicationContext.java @@ -88,7 +88,7 @@ public class StaticPortletApplicationContext extends StaticApplicationContext * {@inheritDoc} *

          The parent {@linkplain #getEnvironment() environment} is * delegated to this (child) context if the parent is a - * {@link ConfigurableApplicationContext} implementation. + * {@link org.springframework.context.ConfigurableApplicationContext} implementation. *

          The parent {@linkplain #getServletContext() servlet context} is * delegated to this (child) context if the parent is a {@link WebApplicationContext} * implementation. diff --git a/spring-webmvc-portlet/src/main/java/org/springframework/web/portlet/handler/PortletRequestMethodNotSupportedException.java b/spring-webmvc-portlet/src/main/java/org/springframework/web/portlet/handler/PortletRequestMethodNotSupportedException.java index f347a027fba..b9c9718a6e2 100644 --- a/spring-webmvc-portlet/src/main/java/org/springframework/web/portlet/handler/PortletRequestMethodNotSupportedException.java +++ b/spring-webmvc-portlet/src/main/java/org/springframework/web/portlet/handler/PortletRequestMethodNotSupportedException.java @@ -55,7 +55,6 @@ public class PortletRequestMethodNotSupportedException extends PortletException /** * Create a new PortletRequestMethodNotSupportedException. - * @param method the unsupported HTTP request method * @param supportedMethods the actually supported HTTP methods */ public PortletRequestMethodNotSupportedException(String[] supportedMethods) { diff --git a/spring-webmvc/src/main/java/org/springframework/web/servlet/FrameworkServlet.java b/spring-webmvc/src/main/java/org/springframework/web/servlet/FrameworkServlet.java index d8916287c9a..b8d7855ed25 100644 --- a/spring-webmvc/src/main/java/org/springframework/web/servlet/FrameworkServlet.java +++ b/spring-webmvc/src/main/java/org/springframework/web/servlet/FrameworkServlet.java @@ -330,7 +330,7 @@ public abstract class FrameworkServlet extends HttpServletBean { * Specify the set of fully-qualified {@link ApplicationContextInitializer} class * names, per the optional "contextInitializerClasses" servlet init-param. * @see #configureAndRefreshWebApplicationContext(ConfigurableWebApplicationContext) - * @see #applyInitializers(ConfigurableWebApplicationContext) + * @see #applyInitializers(ConfigurableApplicationContext) */ public void setContextInitializerClasses(String contextInitializerClasses) { this.contextInitializerClasses = contextInitializerClasses; @@ -340,7 +340,7 @@ public abstract class FrameworkServlet extends HttpServletBean { * Specify which {@link ApplicationContextInitializer} instances should be used * to initialize the application context used by this {@code FrameworkServlet}. * @see #configureAndRefreshWebApplicationContext(ConfigurableWebApplicationContext) - * @see #applyInitializers(ConfigurableWebApplicationContext) + * @see #applyInitializers(ConfigurableApplicationContext) */ public void setContextInitializers(ApplicationContextInitializer... contextInitializers) { for (ApplicationContextInitializer initializer : contextInitializers) { @@ -691,12 +691,12 @@ public abstract class FrameworkServlet extends HttpServletBean { *

          The default implementation is empty. refresh() will * be called automatically after this method returns. *

          Note that this method is designed to allow subclasses to modify the application - * context, while {@link #initializeWebApplicationContext} is designed to allow + * context, while {@link #initWebApplicationContext} is designed to allow * end-users to modify the context through the use of * {@link ApplicationContextInitializer}s. * @param wac the configured WebApplicationContext (not refreshed yet) * @see #createWebApplicationContext - * @see #initializeWebApplicationContext + * @see #initWebApplicationContext * @see ConfigurableWebApplicationContext#refresh() */ protected void postProcessWebApplicationContext(ConfigurableWebApplicationContext wac) { diff --git a/spring-webmvc/src/main/java/org/springframework/web/servlet/handler/DispatcherServletWebRequest.java b/spring-webmvc/src/main/java/org/springframework/web/servlet/handler/DispatcherServletWebRequest.java index d20beb1dc27..7d039a15b0f 100644 --- a/spring-webmvc/src/main/java/org/springframework/web/servlet/handler/DispatcherServletWebRequest.java +++ b/spring-webmvc/src/main/java/org/springframework/web/servlet/handler/DispatcherServletWebRequest.java @@ -47,7 +47,7 @@ public class DispatcherServletWebRequest extends ServletWebRequest { /** * Create a new DispatcherServletWebRequest instance for the given request and response. * @param request current HTTP request - * @param request current HTTP response + * @param response current HTTP response */ public DispatcherServletWebRequest(HttpServletRequest request, HttpServletResponse response) { super(request, response); diff --git a/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/annotation/AnnotationMethodHandlerAdapter.java b/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/annotation/AnnotationMethodHandlerAdapter.java index bcd6d2f28e0..6a0ef788b8b 100644 --- a/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/annotation/AnnotationMethodHandlerAdapter.java +++ b/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/annotation/AnnotationMethodHandlerAdapter.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -443,7 +443,7 @@ public class AnnotationMethodHandlerAdapter extends WebContentGenerator /** * This method always returns -1 since an annotated controller can have many methods, * each requiring separate lastModified calculations. Instead, an - * @{@link RequestMapping}-annotated method can calculate the lastModified value, call + * {@link RequestMapping}-annotated method can calculate the lastModified value, call * {@link org.springframework.web.context.request.WebRequest#checkNotModified(long)} * to check it, and return {@code null} if that returns {@code true}. * @see org.springframework.web.context.request.WebRequest#checkNotModified(long) @@ -483,7 +483,7 @@ public class AnnotationMethodHandlerAdapter extends WebContentGenerator * @return the ServletRequestDataBinder instance to use * @throws Exception in case of invalid state or arguments * @see ServletRequestDataBinder#bind(javax.servlet.ServletRequest) - * @see ServletRequestDataBinder#convertIfNecessary(Object, Class, org.springframework.core.MethodParameter) + * @see ServletRequestDataBinder#convertIfNecessary(Object, Class, org.springframework.core.MethodParameter) */ protected ServletRequestDataBinder createBinder(HttpServletRequest request, Object target, String objectName) throws Exception { return new ServletRequestDataBinder(target, objectName); diff --git a/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/condition/RequestCondition.java b/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/condition/RequestCondition.java index d97f60ed6cc..fd99e6ffced 100644 --- a/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/condition/RequestCondition.java +++ b/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/condition/RequestCondition.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -22,15 +22,15 @@ import org.springframework.web.bind.annotation.RequestMapping; /** * The contract for request conditions. - * - *

          Request conditions can be combined via {@link #combine(Object)}, matched to - * a request via {@link #getMatchingCondition(HttpServletRequest)}, and compared - * to each other via {@link #compareTo(Object, HttpServletRequest)} to determine + * + *

          Request conditions can be combined via {@link #combine(Object)}, matched to + * a request via {@link #getMatchingCondition(HttpServletRequest)}, and compared + * to each other via {@link #compareTo(Object, HttpServletRequest)} to determine * which matches a request more closely. - * - * @param The type of objects that this RequestCondition can be combined + * + * @param The type of objects that this RequestCondition can be combined * with compared to. - * + * * @author Rossen Stoyanchev * @author Arjen Poutsma * @since 3.1 @@ -38,32 +38,32 @@ import org.springframework.web.bind.annotation.RequestMapping; public interface RequestCondition { /** - * Defines the rules for combining this condition (i.e. the current instance) - * with another condition. For example combining type- and method-level - * {@link RequestMapping} conditions. - * + * Defines the rules for combining this condition (i.e. the current instance) + * with another condition. For example combining type- and method-level + * {@link RequestMapping} conditions. + * * @param other the condition to combine with. - * @returns a request condition instance that is the result of combining + * @return a request condition instance that is the result of combining * the two condition instances. */ T combine(T other); /** - * Checks if this condition matches the given request and returns a - * potentially new request condition with content tailored to the - * current request. For example a condition with URL patterns might - * return a new condition that contains matching patterns sorted + * Checks if this condition matches the given request and returns a + * potentially new request condition with content tailored to the + * current request. For example a condition with URL patterns might + * return a new condition that contains matching patterns sorted * with best matching patterns on top. - * - * @return a condition instance in case of a match; + * + * @return a condition instance in case of a match; * or {@code null} if there is no match. */ T getMatchingCondition(HttpServletRequest request); /** - * Compares this condition to another condition in the context of - * a specific request. This method assumes both instances have - * been obtained via {@link #getMatchingCondition(HttpServletRequest)} + * Compares this condition to another condition in the context of + * a specific request. This method assumes both instances have + * been obtained via {@link #getMatchingCondition(HttpServletRequest)} * to ensure they have content relevant to current request only. */ int compareTo(T other, HttpServletRequest request); diff --git a/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/method/RequestMappingInfoHandlerMapping.java b/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/method/RequestMappingInfoHandlerMapping.java index a98b2db2b55..b206b10c0fe 100644 --- a/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/method/RequestMappingInfoHandlerMapping.java +++ b/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/method/RequestMappingInfoHandlerMapping.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -54,10 +54,10 @@ public abstract class RequestMappingInfoHandlerMapping extends AbstractHandlerMe } /** - * Check if the given RequestMappingInfo matches the current request and - * return a (potentially new) instance with conditions that match the + * Check if the given RequestMappingInfo matches the current request and + * return a (potentially new) instance with conditions that match the * current request -- for example with a subset of URL patterns. - * @returns an info in case of a match; or {@code null} otherwise. + * @return an info in case of a match; or {@code null} otherwise. */ @Override protected RequestMappingInfo getMatchingMapping(RequestMappingInfo info, HttpServletRequest request) { @@ -101,17 +101,17 @@ public abstract class RequestMappingInfoHandlerMapping extends AbstractHandlerMe /** * Iterate all RequestMappingInfos once again, look if any match by URL at * least and raise exceptions accordingly. - * - * @throws HttpRequestMethodNotSupportedException + * + * @throws HttpRequestMethodNotSupportedException * if there are matches by URL but not by HTTP method - * @throws HttpMediaTypeNotAcceptableException + * @throws HttpMediaTypeNotAcceptableException * if there are matches by URL but not by consumable media types - * @throws HttpMediaTypeNotAcceptableException + * @throws HttpMediaTypeNotAcceptableException * if there are matches by URL but not by producible media types */ @Override - protected HandlerMethod handleNoMatch(Set requestMappingInfos, - String lookupPath, + protected HandlerMethod handleNoMatch(Set requestMappingInfos, + String lookupPath, HttpServletRequest request) throws ServletException { Set allowedMethods = new HashSet(6); Set consumableMediaTypes = new HashSet(); diff --git a/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/method/annotation/RequestMappingHandlerMapping.java b/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/method/annotation/RequestMappingHandlerMapping.java index 8301ce7c4df..9d8291158c2 100644 --- a/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/method/annotation/RequestMappingHandlerMapping.java +++ b/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/method/annotation/RequestMappingHandlerMapping.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -32,8 +32,8 @@ import org.springframework.web.servlet.mvc.method.RequestMappingInfo; import org.springframework.web.servlet.mvc.method.RequestMappingInfoHandlerMapping; /** - * Creates {@link RequestMappingInfo} instances from type and method-level - * {@link RequestMapping @RequestMapping} annotations in + * Creates {@link RequestMappingInfo} instances from type and method-level + * {@link RequestMapping @RequestMapping} annotations in * {@link Controller @Controller} classes. * * @author Arjen Poutsma @@ -49,7 +49,7 @@ public class RequestMappingHandlerMapping extends RequestMappingInfoHandlerMappi /** * Whether to use suffix pattern match (".*") when matching patterns to * requests. If enabled a method mapped to "/users" also matches to "/users.*". - *

          The default value is {@code true}. + *

          The default value is {@code true}. */ public void setUseSuffixPatternMatch(boolean useSuffixPatternMatch) { this.useSuffixPatternMatch = useSuffixPatternMatch; @@ -78,7 +78,7 @@ public class RequestMappingHandlerMapping extends RequestMappingInfoHandlerMappi } /** - * {@inheritDoc} + * {@inheritDoc} * Expects a handler to have a type-level @{@link Controller} annotation. */ @Override @@ -89,10 +89,10 @@ public class RequestMappingHandlerMapping extends RequestMappingInfoHandlerMappi /** * Uses method and type-level @{@link RequestMapping} annotations to create * the RequestMappingInfo. - * + * * @return the created RequestMappingInfo, or {@code null} if the method * does not have a {@code @RequestMapping} annotation. - * + * * @see #getCustomMethodCondition(Method) * @see #getCustomTypeCondition(Class) */ @@ -114,9 +114,9 @@ public class RequestMappingHandlerMapping extends RequestMappingInfoHandlerMappi /** * Provide a custom method-level request condition. - * The custom {@link RequestCondition} can be of any type so long as the + * The custom {@link RequestCondition} can be of any type so long as the * same condition type is returned from all calls to this method in order - * to ensure custom request conditions can be combined and compared. + * to ensure custom request conditions can be combined and compared. * @param method the handler method for which to create the condition * @return the condition, or {@code null} */ @@ -126,10 +126,10 @@ public class RequestMappingHandlerMapping extends RequestMappingInfoHandlerMappi /** * Provide a custom type-level request condition. - * The custom {@link RequestCondition} can be of any type so long as the + * The custom {@link RequestCondition} can be of any type so long as the * same condition type is returned from all calls to this method in order - * to ensure custom request conditions can be combined and compared. - * @param method the handler method for which to create the condition + * to ensure custom request conditions can be combined and compared. + * @param handlerType the handler type for which to create the condition * @return the condition, or {@code null} */ protected RequestCondition getCustomTypeCondition(Class handlerType) { @@ -141,13 +141,13 @@ public class RequestMappingHandlerMapping extends RequestMappingInfoHandlerMappi */ private RequestMappingInfo createRequestMappingInfo(RequestMapping annotation, RequestCondition customCondition) { return new RequestMappingInfo( - new PatternsRequestCondition(annotation.value(), + new PatternsRequestCondition(annotation.value(), getUrlPathHelper(), getPathMatcher(), this.useSuffixPatternMatch, this.useTrailingSlashMatch), new RequestMethodsRequestCondition(annotation.method()), new ParamsRequestCondition(annotation.params()), new HeadersRequestCondition(annotation.headers()), new ConsumesRequestCondition(annotation.consumes(), annotation.headers()), - new ProducesRequestCondition(annotation.produces(), annotation.headers()), + new ProducesRequestCondition(annotation.produces(), annotation.headers()), customCondition); } diff --git a/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/method/annotation/ServletModelAttributeMethodProcessor.java b/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/method/annotation/ServletModelAttributeMethodProcessor.java index e2865dc166a..56c45e033b7 100644 --- a/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/method/annotation/ServletModelAttributeMethodProcessor.java +++ b/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/method/annotation/ServletModelAttributeMethodProcessor.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2011 the original author or authors. + * Copyright 2002-2012 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. @@ -37,8 +37,8 @@ import org.springframework.web.servlet.HandlerMapping; /** * A Servlet-specific {@link org.springframework.web.method.annotation.ModelAttributeMethodProcessor} that applies data - * binding through a WebDataBinder of type {@link ServletRequestDataBinder}. - * + * binding through a WebDataBinder of type {@link ServletRequestDataBinder}. + * *

          Also adds a fall-back strategy to instantiate the model attribute from a * URI template variable or from a request parameter if the name matches the * model attribute name and there is an appropriate type conversion strategy. @@ -50,7 +50,7 @@ public class ServletModelAttributeMethodProcessor extends ModelAttributeMethodPr /** * @param annotationNotRequired if "true", non-simple method arguments and - * return values are considered model attributes with or without a + * return values are considered model attributes with or without a * {@code @ModelAttribute} annotation. */ public ServletModelAttributeMethodProcessor(boolean annotationNotRequired) { @@ -62,12 +62,12 @@ public class ServletModelAttributeMethodProcessor extends ModelAttributeMethodPr * request parameter if the name matches to the model attribute name and * if there is an appropriate type conversion strategy. If none of these * are true delegate back to the base class. - * @see #createAttributeFromUriValue + * @see #createAttributeFromRequestValue(String, String, MethodParameter, WebDataBinderFactory, NativeWebRequest) */ @Override - protected final Object createAttribute(String attributeName, - MethodParameter parameter, - WebDataBinderFactory binderFactory, + protected final Object createAttribute(String attributeName, + MethodParameter parameter, + WebDataBinderFactory binderFactory, NativeWebRequest request) throws Exception { String value = getRequestValueForAttribute(attributeName, request); @@ -83,7 +83,7 @@ public class ServletModelAttributeMethodProcessor extends ModelAttributeMethodPr /** * Obtain a value from the request that may be used to instantiate the - * model attribute through type conversion from String to the target type. + * model attribute through type conversion from String to the target type. *

          The default implementation looks for the attribute name to match * a URI variable first and then a request parameter. * @param attributeName the model attribute name @@ -105,7 +105,7 @@ public class ServletModelAttributeMethodProcessor extends ModelAttributeMethodPr @SuppressWarnings("unchecked") protected final Map getUriTemplateVariables(NativeWebRequest request) { - Map variables = + Map variables = (Map) request.getAttribute( HandlerMapping.URI_TEMPLATE_VARIABLES_ATTRIBUTE, RequestAttributes.SCOPE_REQUEST); return (variables != null) ? variables : Collections.emptyMap(); @@ -114,7 +114,7 @@ public class ServletModelAttributeMethodProcessor extends ModelAttributeMethodPr /** * Create a model attribute from a String request value (e.g. URI template * variable, request parameter) using type conversion. - *

          The default implementation converts only if there a registered + *

          The default implementation converts only if there a registered * {@link Converter} that can perform the conversion. * @param sourceValue the source value to create the model attribute from * @param attributeName the name of the attribute, never {@code null} @@ -125,9 +125,9 @@ public class ServletModelAttributeMethodProcessor extends ModelAttributeMethodPr * @throws Exception */ protected Object createAttributeFromRequestValue(String sourceValue, - String attributeName, - MethodParameter parameter, - WebDataBinderFactory binderFactory, + String attributeName, + MethodParameter parameter, + WebDataBinderFactory binderFactory, NativeWebRequest request) throws Exception { DataBinder binder = binderFactory.createBinder(request, null, attributeName); ConversionService conversionService = binder.getConversionService(); diff --git a/spring-webmvc/src/main/java/org/springframework/web/servlet/resource/DefaultServletHttpRequestHandler.java b/spring-webmvc/src/main/java/org/springframework/web/servlet/resource/DefaultServletHttpRequestHandler.java index 1fd85e717d0..e31262c4377 100644 --- a/spring-webmvc/src/main/java/org/springframework/web/servlet/resource/DefaultServletHttpRequestHandler.java +++ b/spring-webmvc/src/main/java/org/springframework/web/servlet/resource/DefaultServletHttpRequestHandler.java @@ -30,7 +30,8 @@ import org.springframework.web.context.ServletContextAware; /** * An {@link HttpRequestHandler} for serving static files using the Servlet container's "default" Servlet. * - *

          This handler is intended to be used with a "/*" mapping when the {@link DispatcherServlet} + *

          This handler is intended to be used with a "/*" mapping when the + * {@link org.springframework.web.servlet.DispatcherServlet DispatcherServlet} * is mapped to "/", thus overriding the Servlet container's default handling of static resources. * The mapping to this handler should generally be ordered as the last in the chain so that it will * only execute when no other more specific mappings (i.e., to controllers) can be matched. diff --git a/spring-webmvc/src/main/java/org/springframework/web/servlet/support/RequestContext.java b/spring-webmvc/src/main/java/org/springframework/web/servlet/support/RequestContext.java index 97aa563b90a..8de20780525 100644 --- a/spring-webmvc/src/main/java/org/springframework/web/servlet/support/RequestContext.java +++ b/spring-webmvc/src/main/java/org/springframework/web/servlet/support/RequestContext.java @@ -50,16 +50,16 @@ import org.springframework.web.util.WebUtils; /** * Context holder for request-specific state, like current web application context, current locale, current theme, and * potential binding errors. Provides easy access to localized messages and Errors instances. - * + * *

          Suitable for exposition to views, and usage within JSP's "useBean" tag, JSP scriptlets, JSTL EL, Velocity * templates, etc. Necessary for views that do not have access to the servlet request, like Velocity templates. - * + * *

          Can be instantiated manually, or automatically exposed to views as model attribute via AbstractView's * "requestContextAttribute" property. - * + * *

          Will also work outside of DispatcherServlet requests, accessing the root WebApplicationContext and using an * appropriate fallback for the locale (the HttpServletRequest's primary locale). - * + * * @author Juergen Hoeller * @since 03.03.2003 * @see org.springframework.web.servlet.DispatcherServlet @@ -83,8 +83,8 @@ public class RequestContext { public static final String WEB_APPLICATION_CONTEXT_ATTRIBUTE = RequestContext.class.getName() + ".CONTEXT"; /** - * The name of the bean to use to look up in an implementation of - * {@link RequestDataValueProcessor} has been configured. + * The name of the bean to use to look up in an implementation of + * {@link RequestDataValueProcessor} has been configured. */ private static final String REQUEST_DATA_VALUE_PROCESSOR_BEAN_NAME = "requestDataValueProcessor"; @@ -148,7 +148,7 @@ public class RequestContext { * @param model the model attributes for the current view (can be null, using the request attributes * for Errors retrieval) * @see org.springframework.web.servlet.DispatcherServlet - * @see #RequestContext(javax.servlet.http.HttpServletRequest, javax.servlet.ServletContext, Map) + * @see #RequestContext(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse, javax.servlet.ServletContext, Map) */ public RequestContext(HttpServletRequest request, Map model) { initContext(request, null, null, model); @@ -226,7 +226,7 @@ public class RequestContext { try { this.requestDataValueProcessor = this.webApplicationContext.getBean( REQUEST_DATA_VALUE_PROCESSOR_BEAN_NAME, RequestDataValueProcessor.class); - } + } catch (NoSuchBeanDefinitionException ex) { // Ignored } @@ -366,7 +366,7 @@ public class RequestContext { } /** - * Return the RequestDataValueProcessor instance to use obtained from the + * Return the RequestDataValueProcessor instance to use obtained from the * WebApplicationContext under the name {@code "requestDataValueProcessor"}. * Or {@code null} if no matching bean was found. */ @@ -402,9 +402,9 @@ public class RequestContext { * Return a context-aware URl for the given relative URL with placeholders (named keys with braces {}). * For example, send in a relative URL foo/{bar}?spam={spam} and a parameter map * {bar=baz,spam=nuts} and the result will be [contextpath]/foo/baz?spam=nuts. - * + * * @param relativeUrl the relative URL part - * @param a map of parameters to insert as placeholders in the url + * @param params a map of parameters to insert as placeholders in the url * @return a URL that points back to the server with an absolute path (also URL-encoded accordingly) */ public String getContextUrl(String relativeUrl, Map params) { @@ -418,9 +418,9 @@ public class RequestContext { } /** - * Return the path to URL mappings within the current servlet including the + * Return the path to URL mappings within the current servlet including the * context path and the servlet path of the original request. This is useful - * for building links to other resources within the application where a + * for building links to other resources within the application where a * servlet mapping of the style {@code "/main/*"} is used. *

          Delegates to the UrlPathHelper for decoding the context path. * @see javax.servlet.http.HttpServletRequest#getContextPath