diff --git a/spring-aop/src/main/java/org/springframework/aop/framework/autoproxy/BeanNameAutoProxyCreator.java b/spring-aop/src/main/java/org/springframework/aop/framework/autoproxy/BeanNameAutoProxyCreator.java index 8c49d4ff7d2..297ab0cd1f6 100644 --- a/spring-aop/src/main/java/org/springframework/aop/framework/autoproxy/BeanNameAutoProxyCreator.java +++ b/spring-aop/src/main/java/org/springframework/aop/framework/autoproxy/BeanNameAutoProxyCreator.java @@ -61,7 +61,7 @@ public class BeanNameAutoProxyCreator extends AbstractAutoProxyCreator { * FactoryBean will get proxied. This default behavior applies as of Spring 2.0. * If you intend to proxy a FactoryBean instance itself (a rare use case, but * Spring 1.2's default behavior), specify the bean name of the FactoryBean - * including the factory-bean prefix "&": e.g. "&myFactoryBean". + * including the factory-bean prefix "&": e.g. "&myFactoryBean". * @see org.springframework.beans.factory.FactoryBean * @see org.springframework.beans.factory.BeanFactory#FACTORY_BEAN_PREFIX */ diff --git a/spring-beans/src/main/java/org/springframework/beans/factory/groovy/GroovyBeanDefinitionReader.java b/spring-beans/src/main/java/org/springframework/beans/factory/groovy/GroovyBeanDefinitionReader.java index da1ebc58c5f..9ef7aa3799f 100644 --- a/spring-beans/src/main/java/org/springframework/beans/factory/groovy/GroovyBeanDefinitionReader.java +++ b/spring-beans/src/main/java/org/springframework/beans/factory/groovy/GroovyBeanDefinitionReader.java @@ -75,18 +75,18 @@ import org.springframework.util.StringUtils; * * def reader = new GroovyBeanDefinitionReader(myApplicationContext) * reader.beans { - * dataSource(BasicDataSource) { // <--- invokeMethod + * dataSource(BasicDataSource) { // <--- invokeMethod * driverClassName = "org.hsqldb.jdbcDriver" * url = "jdbc:hsqldb:mem:grailsDB" - * username = "sa" // <-- setProperty + * username = "sa" // <-- setProperty * password = "" * settings = [mynew:"setting"] * } * sessionFactory(SessionFactory) { - * dataSource = dataSource // <-- getProperty for retrieving references + * dataSource = dataSource // <-- getProperty for retrieving references * } * myService(MyService) { - * nestedBean = { AnotherBean bean -> // <-- setProperty with closure for nested bean + * nestedBean = { AnotherBean bean -> // <-- setProperty with closure for nested bean * dataSource = dataSource * } * } @@ -113,7 +113,7 @@ import org.springframework.util.StringUtils; * dataSource = dataSource * } * myService(MyService) { - * nestedBean = { AnotherBean bean -> + * nestedBean = { AnotherBean bean -> * dataSource = dataSource * } * } 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 725999d89c8..39856654f90 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-2020 the original author or authors. + * Copyright 2002-2021 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. @@ -129,7 +129,7 @@ import org.springframework.stereotype.Component; * @Configuration * public class AppConfig { * - * @Autowired Environment env; + * @Autowired Environment env; * * @Bean * public MyBean myBean() { @@ -149,7 +149,7 @@ import org.springframework.stereotype.Component; * @PropertySource("classpath:/com/acme/app.properties") * public class AppConfig { * - * @Inject Environment env; + * @Inject Environment env; * * @Bean * public MyBean myBean() { @@ -170,7 +170,7 @@ import org.springframework.stereotype.Component; * @PropertySource("classpath:/com/acme/app.properties") * public class AppConfig { * - * @Value("${bean.name}") String beanName; + * @Value("${bean.name}") String beanName; * * @Bean * public MyBean myBean() { @@ -297,7 +297,7 @@ import org.springframework.stereotype.Component; * @ImportResource("classpath:/com/acme/database-config.xml") * public class AppConfig { * - * @Inject DataSource dataSource; // from XML + * @Inject DataSource dataSource; // from XML * * @Bean * public MyBean myBean() { diff --git a/spring-context/src/main/java/org/springframework/context/annotation/EnableAspectJAutoProxy.java b/spring-context/src/main/java/org/springframework/context/annotation/EnableAspectJAutoProxy.java index 8e264634066..62cb6404c49 100644 --- a/spring-context/src/main/java/org/springframework/context/annotation/EnableAspectJAutoProxy.java +++ b/spring-context/src/main/java/org/springframework/context/annotation/EnableAspectJAutoProxy.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2018 the original author or authors. + * Copyright 2002-2021 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. @@ -98,7 +98,7 @@ import java.lang.annotation.Target; * @EnableAspectJAutoProxy * public class AppConfig { * - * // no explicit @Bean definitions required + * // no explicit @Bean definitions required * } * * Note: {@code @EnableAspectJAutoProxy} applies to its local application context only, diff --git a/spring-context/src/main/java/org/springframework/context/support/GenericGroovyApplicationContext.java b/spring-context/src/main/java/org/springframework/context/support/GenericGroovyApplicationContext.java index 8e1f74ba45d..4f4c0701734 100644 --- a/spring-context/src/main/java/org/springframework/context/support/GenericGroovyApplicationContext.java +++ b/spring-context/src/main/java/org/springframework/context/support/GenericGroovyApplicationContext.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2018 the original author or authors. + * Copyright 2002-2021 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. @@ -46,18 +46,18 @@ import org.springframework.lang.Nullable; * * def context = new GenericGroovyApplicationContext() * context.reader.beans { - * dataSource(BasicDataSource) { // <--- invokeMethod + * dataSource(BasicDataSource) { // <--- invokeMethod * driverClassName = "org.hsqldb.jdbcDriver" * url = "jdbc:hsqldb:mem:grailsDB" - * username = "sa" // <-- setProperty + * username = "sa" // <-- setProperty * password = "" * settings = [mynew:"setting"] * } * sessionFactory(SessionFactory) { - * dataSource = dataSource // <-- getProperty for retrieving references + * dataSource = dataSource // <-- getProperty for retrieving references * } * myService(MyService) { - * nestedBean = { AnotherBean bean -> // <-- setProperty with closure for nested bean + * nestedBean = { AnotherBean bean -> // <-- setProperty with closure for nested bean * dataSource = dataSource * } * } @@ -84,7 +84,7 @@ import org.springframework.lang.Nullable; * dataSource = dataSource * } * myService(MyService) { - * nestedBean = { AnotherBean bean -> + * nestedBean = { AnotherBean bean -> * dataSource = dataSource * } * } diff --git a/spring-context/src/main/java/org/springframework/context/support/ReloadableResourceBundleMessageSource.java b/spring-context/src/main/java/org/springframework/context/support/ReloadableResourceBundleMessageSource.java index e7f78f83f64..6b6ff96af18 100644 --- a/spring-context/src/main/java/org/springframework/context/support/ReloadableResourceBundleMessageSource.java +++ b/spring-context/src/main/java/org/springframework/context/support/ReloadableResourceBundleMessageSource.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2020 the original author or authors. + * Copyright 2002-2021 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. @@ -229,7 +229,7 @@ public class ReloadableResourceBundleMessageSource extends AbstractResourceBased * for a Locale, after merging all specified resource bundles. * Either fetches the holder from the cache or freshly loads it. *
Only used when caching resource bundle contents forever, i.e. - * with cacheSeconds < 0. Therefore, merged properties are always + * with cacheSeconds < 0. Therefore, merged properties are always * cached forever. */ protected PropertiesHolder getMergedProperties(Locale locale) { diff --git a/spring-context/src/main/java/org/springframework/format/support/DefaultFormattingConversionService.java b/spring-context/src/main/java/org/springframework/format/support/DefaultFormattingConversionService.java index 805a9828c4c..3ffbba9ef09 100644 --- a/spring-context/src/main/java/org/springframework/format/support/DefaultFormattingConversionService.java +++ b/spring-context/src/main/java/org/springframework/format/support/DefaultFormattingConversionService.java @@ -37,7 +37,7 @@ import org.springframework.util.StringValueResolver; * as {@code DefaultConversionService} exposes its own * {@link DefaultConversionService#addDefaultConverters addDefaultConverters} method. * - *
Automatically registers formatters for JSR-354 Money & Currency, JSR-310 Date-Time + *
Automatically registers formatters for JSR-354 Money & Currency, JSR-310 Date-Time * and/or Joda-Time 2.x, depending on the presence of the corresponding API on the classpath. * * @author Chris Beams @@ -100,7 +100,7 @@ public class DefaultFormattingConversionService extends FormattingConversionServ /** * Add formatters appropriate for most environments: including number formatters, - * JSR-354 Money & Currency formatters, JSR-310 Date-Time and/or Joda-Time formatters, + * JSR-354 Money & Currency formatters, JSR-310 Date-Time and/or Joda-Time formatters, * depending on the presence of the corresponding API on the classpath. * @param formatterRegistry the service to register default formatters with */ diff --git a/spring-context/src/main/java/org/springframework/validation/Validator.java b/spring-context/src/main/java/org/springframework/validation/Validator.java index d95b054872b..b67b6d5d8b7 100644 --- a/spring-context/src/main/java/org/springframework/validation/Validator.java +++ b/spring-context/src/main/java/org/springframework/validation/Validator.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2018 the original author or authors. + * Copyright 2002-2021 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. @@ -33,7 +33,7 @@ package org.springframework.validation; * wholly of whitespace), and that any password that is present is * at least {@code 'MINIMUM_PASSWORD_LENGTH'} characters in length. * - *
public class UserLoginValidator implements Validator {
+ * public class UserLoginValidator implements Validator {
*
* private static final int MINIMUM_PASSWORD_LENGTH = 6;
*
@@ -46,7 +46,7 @@ package org.springframework.validation;
* ValidationUtils.rejectIfEmptyOrWhitespace(errors, "password", "field.required");
* UserLogin login = (UserLogin) target;
* if (login.getPassword() != null
- * && login.getPassword().trim().length() < MINIMUM_PASSWORD_LENGTH) {
+ * && login.getPassword().trim().length() < MINIMUM_PASSWORD_LENGTH) {
* errors.rejectValue("password", "field.min.length",
* new Object[]{Integer.valueOf(MINIMUM_PASSWORD_LENGTH)},
* "The password must be at least [" + MINIMUM_PASSWORD_LENGTH + "] characters in length.");
diff --git a/spring-core/src/main/java/org/springframework/core/env/CommandLinePropertySource.java b/spring-core/src/main/java/org/springframework/core/env/CommandLinePropertySource.java
index 321629954d4..a7ee178a3e4 100644
--- a/spring-core/src/main/java/org/springframework/core/env/CommandLinePropertySource.java
+++ b/spring-core/src/main/java/org/springframework/core/env/CommandLinePropertySource.java
@@ -1,5 +1,5 @@
/*
- * Copyright 2002-2018 the original author or authors.
+ * Copyright 2002-2021 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.
@@ -110,7 +110,7 @@ import org.springframework.util.StringUtils;
* evaluate true:
*
*
- * CommandLinePropertySource> ps = ...
+ * CommandLinePropertySource<?> ps = ...
* assert ps.containsProperty("o1") == true;
* assert ps.containsProperty("o2") == true;
* assert ps.containsProperty("o3") == false;
@@ -149,7 +149,7 @@ import org.springframework.util.StringUtils;
* will evaluate true:
*
*
- * CommandLinePropertySource> ps = ...
+ * CommandLinePropertySource<?> ps = ...
* assert ps.containsProperty("o1") == true;
* assert ps.containsProperty("o2") == true;
* assert ps.containsProperty("nonOptionArgs") == true;
diff --git a/spring-core/src/main/java/org/springframework/core/env/JOptCommandLinePropertySource.java b/spring-core/src/main/java/org/springframework/core/env/JOptCommandLinePropertySource.java
index 64f67e3321b..22353e09895 100644
--- a/spring-core/src/main/java/org/springframework/core/env/JOptCommandLinePropertySource.java
+++ b/spring-core/src/main/java/org/springframework/core/env/JOptCommandLinePropertySource.java
@@ -1,5 +1,5 @@
/*
- * Copyright 2002-2018 the original author or authors.
+ * Copyright 2002-2021 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.
@@ -42,7 +42,7 @@ import org.springframework.util.StringUtils;
* parser.accepts("option1");
* parser.accepts("option2").withRequiredArg();
* OptionSet options = parser.parse(args);
- * PropertySource> ps = new JOptCommandLinePropertySource(options);
+ * PropertySource<?> ps = new JOptCommandLinePropertySource(options);
* // ...
* }
*
diff --git a/spring-core/src/main/java/org/springframework/core/env/SimpleCommandLinePropertySource.java b/spring-core/src/main/java/org/springframework/core/env/SimpleCommandLinePropertySource.java
index a4a25397ac9..c4f34a13e50 100644
--- a/spring-core/src/main/java/org/springframework/core/env/SimpleCommandLinePropertySource.java
+++ b/spring-core/src/main/java/org/springframework/core/env/SimpleCommandLinePropertySource.java
@@ -1,5 +1,5 @@
/*
- * Copyright 2002-2020 the original author or authors.
+ * Copyright 2002-2021 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.
@@ -66,7 +66,7 @@ import org.springframework.util.StringUtils;
* Typical usage
*
* public static void main(String[] args) {
- * PropertySource> ps = new SimpleCommandLinePropertySource(args);
+ * PropertySource<?> ps = new SimpleCommandLinePropertySource(args);
* // ...
* }
*
diff --git a/spring-jms/src/main/java/org/springframework/jms/annotation/EnableJms.java b/spring-jms/src/main/java/org/springframework/jms/annotation/EnableJms.java
index 79c4a3bca05..e4d97367d1f 100644
--- a/spring-jms/src/main/java/org/springframework/jms/annotation/EnableJms.java
+++ b/spring-jms/src/main/java/org/springframework/jms/annotation/EnableJms.java
@@ -1,5 +1,5 @@
/*
- * Copyright 2002-2018 the original author or authors.
+ * Copyright 2002-2021 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.
@@ -138,7 +138,7 @@ import org.springframework.context.annotation.Import;
* }
*
* @Bean
- * public JmsListenerContainerFactory> myJmsListenerContainerFactory() {
+ * public JmsListenerContainerFactory<?> myJmsListenerContainerFactory() {
* // factory settings
* }
*
@@ -184,7 +184,7 @@ import org.springframework.context.annotation.Import;
* }
*
* @Bean
- * public JmsListenerEndpointRegistry> myJmsListenerEndpointRegistry() {
+ * public JmsListenerEndpointRegistry<?> myJmsListenerEndpointRegistry() {
* // registry configuration
* }
*
@@ -246,7 +246,7 @@ import org.springframework.context.annotation.Import;
* }
*
* @Bean
- * public JmsListenerContainerFactory> anotherJmsListenerContainerFactory() {
+ * public JmsListenerContainerFactory<?> anotherJmsListenerContainerFactory() {
* // ...
* }
*
diff --git a/spring-messaging/src/main/java/org/springframework/messaging/handler/AbstractMessageCondition.java b/spring-messaging/src/main/java/org/springframework/messaging/handler/AbstractMessageCondition.java
index 835020e90f6..93bb26fcac1 100644
--- a/spring-messaging/src/main/java/org/springframework/messaging/handler/AbstractMessageCondition.java
+++ b/spring-messaging/src/main/java/org/springframework/messaging/handler/AbstractMessageCondition.java
@@ -1,5 +1,5 @@
/*
- * Copyright 2002-2019 the original author or authors.
+ * Copyright 2002-2021 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.
@@ -67,7 +67,7 @@ public abstract class AbstractMessageCondition
+ *
* WebDAV Draft Changes
*/
@Deprecated
INSUFFICIENT_SPACE_ON_RESOURCE(419, Series.CLIENT_ERROR, "Insufficient Space On Resource"),
/**
* @deprecated See
- *
+ *
* WebDAV Draft Changes
*/
@Deprecated
METHOD_FAILURE(420, Series.CLIENT_ERROR, "Method Failure"),
/**
* @deprecated
- * See
+ * See
* WebDAV Draft Changes
*/
@Deprecated
diff --git a/spring-web/src/main/java/org/springframework/http/converter/json/Jackson2ObjectMapperBuilder.java b/spring-web/src/main/java/org/springframework/http/converter/json/Jackson2ObjectMapperBuilder.java
index 415113ff059..bdd1e577283 100644
--- a/spring-web/src/main/java/org/springframework/http/converter/json/Jackson2ObjectMapperBuilder.java
+++ b/spring-web/src/main/java/org/springframework/http/converter/json/Jackson2ObjectMapperBuilder.java
@@ -83,7 +83,7 @@ import org.springframework.util.xml.StaxUtils;
* jackson-datatype-jdk8:
* support for other Java 8 types like {@link java.util.Optional}
* jackson-datatype-jsr310:
- * support for Java 8 Date & Time API types
+ * support for Java 8 Date & Time API types
* jackson-datatype-joda:
* support for Joda-Time types
* jackson-module-kotlin:
diff --git a/spring-web/src/main/java/org/springframework/http/converter/json/Jackson2ObjectMapperFactoryBean.java b/spring-web/src/main/java/org/springframework/http/converter/json/Jackson2ObjectMapperFactoryBean.java
index 57d3e63e184..376e6b27737 100644
--- a/spring-web/src/main/java/org/springframework/http/converter/json/Jackson2ObjectMapperFactoryBean.java
+++ b/spring-web/src/main/java/org/springframework/http/converter/json/Jackson2ObjectMapperFactoryBean.java
@@ -1,5 +1,5 @@
/*
- * Copyright 2002-2020 the original author or authors.
+ * Copyright 2002-2021 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,54 +62,54 @@ import org.springframework.lang.Nullable;
* Example usage with
* {@link MappingJackson2HttpMessageConverter}:
*
- *
- * <bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter">
- * <property name="objectMapper">
- * <bean class="org.springframework.http.converter.json.Jackson2ObjectMapperFactoryBean"
+ * {@code
+ *
+ *
+ *
- * </property>
- * </bean>
- *
+ *
+ *
+ * }
*
* Example usage with MappingJackson2JsonView:
*
- *
- * <bean class="org.springframework.web.servlet.view.json.MappingJackson2JsonView">
- * <property name="objectMapper">
- * <bean class="org.springframework.http.converter.json.Jackson2ObjectMapperFactoryBean"
+ * {@code
+ *
+ *
+ *
- * <property name="serializers">
- * <array>
- * <bean class="org.mycompany.MyCustomSerializer" />
- * </array>
- * </property>
- * </bean>
- * </property>
- * </bean>
- *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ * }
*
* In case there are no specific setters provided (for some rarely used options),
* you can still use the more general methods {@link #setFeaturesToEnable} and
* {@link #setFeaturesToDisable}.
*
- *
- * <bean class="org.springframework.http.converter.json.Jackson2ObjectMapperFactoryBean">
- * <property name="featuresToEnable">
- * <array>
- * <util:constant static-field="com.fasterxml.jackson.databind.SerializationFeature.WRAP_ROOT_VALUE"/>
- * <util:constant static-field="com.fasterxml.jackson.databind.SerializationFeature.CLOSE_CLOSEABLE"/>
- * </array>
- * </property>
- * <property name="featuresToDisable">
- * <array>
- * <util:constant static-field="com.fasterxml.jackson.databind.MapperFeature.USE_ANNOTATIONS"/>
- * </array>
- * </property>
- * </bean>
- *
+ * {@code
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ * }
*
* It also automatically registers the following well-known modules if they are
* detected on the classpath:
@@ -119,7 +119,7 @@ import org.springframework.lang.Nullable;
*
jackson-datatype-jdk8:
* support for other Java 8 types like {@link java.util.Optional}
* jackson-datatype-jsr310:
- * support for Java 8 Date & Time API types
+ * support for Java 8 Date & Time API types
* jackson-datatype-joda:
* support for Joda-Time types
* jackson-module-kotlin:
@@ -129,11 +129,11 @@ import org.springframework.lang.Nullable;
* In case you want to configure Jackson's {@link ObjectMapper} with a custom {@link Module},
* you can register one or more such Modules by class name via {@link #setModulesToInstall}:
*
- *
- * <bean class="org.springframework.http.converter.json.Jackson2ObjectMapperFactoryBean">
- * <property name="modulesToInstall" value="myapp.jackson.MySampleModule,myapp.jackson.MyOtherModule"/>
- * </bean
- *
+ * {@code
+ *
+ *
+ *
*
* Compatible with Jackson 2.9 to 2.12, as of Spring 5.3.
*
diff --git a/spring-web/src/main/java/org/springframework/web/util/HtmlUtils.java b/spring-web/src/main/java/org/springframework/web/util/HtmlUtils.java
index 3cac0b07bbe..07a200dc201 100644
--- a/spring-web/src/main/java/org/springframework/web/util/HtmlUtils.java
+++ b/spring-web/src/main/java/org/springframework/web/util/HtmlUtils.java
@@ -1,5 +1,5 @@
/*
- * Copyright 2002-2019 the original author or authors.
+ * Copyright 2002-2021 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.
@@ -49,7 +49,7 @@ public abstract class HtmlUtils {
/**
* Turn special characters into HTML character references.
- *
Handles complete character set defined in HTML 4.01 recommendation.
+ *
Handles the complete character set defined in the HTML 4.01 recommendation.
*
Escapes all special characters to their corresponding
* entity reference (e.g. {@code <}).
*
Reference:
@@ -65,7 +65,7 @@ public abstract class HtmlUtils {
/**
* Turn special characters into HTML character references.
- *
Handles complete character set defined in HTML 4.01 recommendation.
+ *
Handles the complete character set defined in the HTML 4.01 recommendation.
*
Escapes all special characters to their corresponding
* entity reference (e.g. {@code <}) at least as required by the
* specified encoding. In other words, if a special character does
@@ -98,9 +98,9 @@ public abstract class HtmlUtils {
/**
* Turn special characters into HTML character references.
- *
Handles complete character set defined in HTML 4.01 recommendation.
+ *
Handles the complete character set defined in the HTML 4.01 recommendation.
*
Escapes all special characters to their corresponding numeric
- * reference in decimal format (Decimal;).
+ * reference in decimal format (&#Decimal;).
*
* will print: {@code https://example.com/hotels/Rest%20%26%20Relax/bookings/42}
@@ -113,7 +113,7 @@ public class UriTemplate implements Serializable {
* Example:
*
* UriTemplate template = new UriTemplate("https://example.com/hotels/{hotel}/bookings/{booking}");
- * System.out.println(template.expand("Rest & Relax", 42));
+ * System.out.println(template.expand("Rest & Relax", 42));
*
* will print: {@code https://example.com/hotels/Rest%20%26%20Relax/bookings/42}
* @param uriVariableValues the array of URI variables
diff --git a/spring-web/src/main/java/org/springframework/web/util/UriUtils.java b/spring-web/src/main/java/org/springframework/web/util/UriUtils.java
index 4697b3affc6..a67be402e56 100644
--- a/spring-web/src/main/java/org/springframework/web/util/UriUtils.java
+++ b/spring-web/src/main/java/org/springframework/web/util/UriUtils.java
@@ -246,15 +246,15 @@ public abstract class UriUtils {
* Encode the query parameters from the given {@code MultiValueMap} with UTF-8.
* This can be used with {@link UriComponentsBuilder#queryParams(MultiValueMap)}
* when building a URI from an already encoded template.
- *
- * MultiValueMap<String, String> params = new LinkedMultiValueMap<>(2);
+ * {@code
+ * MultiValueMap params = new LinkedMultiValueMap<>(2);
* // add to params...
*
* ServletUriComponentsBuilder.fromCurrentRequest()
* .queryParams(UriUtils.encodeQueryParams(params))
* .build(true)
* .toUriString();
- *
+ * }
* @param params the parameters to encode
* @return a new {@code MultiValueMap} with the encoded names and values
* @since 5.2.3
diff --git a/spring-webflux/src/main/java/org/springframework/web/reactive/result/condition/CompositeRequestCondition.java b/spring-webflux/src/main/java/org/springframework/web/reactive/result/condition/CompositeRequestCondition.java
index 003f47caa24..afaf28433e7 100644
--- a/spring-webflux/src/main/java/org/springframework/web/reactive/result/condition/CompositeRequestCondition.java
+++ b/spring-webflux/src/main/java/org/springframework/web/reactive/result/condition/CompositeRequestCondition.java
@@ -1,5 +1,5 @@
/*
- * Copyright 2002-2018 the original author or authors.
+ * Copyright 2002-2021 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.
@@ -27,7 +27,7 @@ import org.springframework.web.server.ServerWebExchange;
/**
* Implements the {@link RequestCondition} contract by delegating to multiple
- * {@code RequestCondition} types and using a logical conjunction (' && ') to
+ * {@code RequestCondition} types and using a logical conjunction ({@code ' && '}) to
* ensure all conditions match a given request.
*
* When {@code CompositeRequestCondition} instances are combined or compared
diff --git a/spring-webflux/src/main/java/org/springframework/web/reactive/result/condition/HeadersRequestCondition.java b/spring-webflux/src/main/java/org/springframework/web/reactive/result/condition/HeadersRequestCondition.java
index 229b610b844..8a785dcb0ff 100644
--- a/spring-webflux/src/main/java/org/springframework/web/reactive/result/condition/HeadersRequestCondition.java
+++ b/spring-webflux/src/main/java/org/springframework/web/reactive/result/condition/HeadersRequestCondition.java
@@ -1,5 +1,5 @@
/*
- * Copyright 2002-2020 the original author or authors.
+ * Copyright 2002-2021 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.web.cors.reactive.CorsUtils;
import org.springframework.web.server.ServerWebExchange;
/**
- * A logical conjunction (' && ') request condition that matches a request against
+ * A logical conjunction ({@code ' && '}) request condition that matches a request against
* a set of header expressions with syntax defined in {@link RequestMapping#headers()}.
*
*
Expressions passed to the constructor with header names 'Accept' or
diff --git a/spring-webflux/src/main/java/org/springframework/web/reactive/result/condition/ParamsRequestCondition.java b/spring-webflux/src/main/java/org/springframework/web/reactive/result/condition/ParamsRequestCondition.java
index 9b1bc9f904e..81ff4416ef9 100644
--- a/spring-webflux/src/main/java/org/springframework/web/reactive/result/condition/ParamsRequestCondition.java
+++ b/spring-webflux/src/main/java/org/springframework/web/reactive/result/condition/ParamsRequestCondition.java
@@ -1,5 +1,5 @@
/*
- * Copyright 2002-2020 the original author or authors.
+ * Copyright 2002-2021 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.
@@ -26,7 +26,7 @@ import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.server.ServerWebExchange;
/**
- * A logical conjunction (' && ') request condition that matches a request against
+ * A logical conjunction ({@code ' && '}) request condition that matches a request against
* a set parameter expressions with syntax defined in {@link RequestMapping#params()}.
*
* @author Rossen Stoyanchev
diff --git a/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/condition/CompositeRequestCondition.java b/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/condition/CompositeRequestCondition.java
index 5857fdc5eb5..d2bf8da0ac2 100644
--- a/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/condition/CompositeRequestCondition.java
+++ b/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/condition/CompositeRequestCondition.java
@@ -1,5 +1,5 @@
/*
- * Copyright 2002-2018 the original author or authors.
+ * Copyright 2002-2021 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.ObjectUtils;
/**
* Implements the {@link RequestCondition} contract by delegating to multiple
- * {@code RequestCondition} types and using a logical conjunction (' && ') to
+ * {@code RequestCondition} types and using a logical conjunction ({@code ' && '}) to
* ensure all conditions match a given request.
*
*
When {@code CompositeRequestCondition} instances are combined or compared
diff --git a/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/condition/HeadersRequestCondition.java b/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/condition/HeadersRequestCondition.java
index e3f1773318e..2f7fac423f4 100644
--- a/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/condition/HeadersRequestCondition.java
+++ b/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/condition/HeadersRequestCondition.java
@@ -1,5 +1,5 @@
/*
- * Copyright 2002-2020 the original author or authors.
+ * Copyright 2002-2021 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.web.bind.annotation.RequestMapping;
import org.springframework.web.cors.CorsUtils;
/**
- * A logical conjunction (' && ') request condition that matches a request against
+ * A logical conjunction ({@code ' && '}) request condition that matches a request against
* a set of header expressions with syntax defined in {@link RequestMapping#headers()}.
*
*
Expressions passed to the constructor with header names 'Accept' or
diff --git a/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/condition/ParamsRequestCondition.java b/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/condition/ParamsRequestCondition.java
index f06f363aa2c..ead4ec3d049 100644
--- a/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/condition/ParamsRequestCondition.java
+++ b/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/condition/ParamsRequestCondition.java
@@ -1,5 +1,5 @@
/*
- * Copyright 2002-2020 the original author or authors.
+ * Copyright 2002-2021 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.web.bind.annotation.RequestMapping;
import org.springframework.web.util.WebUtils;
/**
- * A logical conjunction (' && ') request condition that matches a request against
+ * A logical conjunction ({@code ' && '}) request condition that matches a request against
* a set parameter expressions with syntax defined in {@link RequestMapping#params()}.
*
* @author Arjen Poutsma
diff --git a/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/method/annotation/MvcUriComponentsBuilder.java b/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/method/annotation/MvcUriComponentsBuilder.java
index f6b2bf26c68..db1ca29c5c4 100644
--- a/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/method/annotation/MvcUriComponentsBuilder.java
+++ b/spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/method/annotation/MvcUriComponentsBuilder.java
@@ -413,7 +413,7 @@ public class MvcUriComponentsBuilder {
* A JSP can prepare a URL to the controller method as follows:
*
*
- * <%@ taglib uri="http://www.springframework.org/tags" prefix="s" %>
+ * <%@ taglib uri="http://www.springframework.org/tags" prefix="s" %>
*
* <a href="${s:mvcUrl('PC#getPerson').arg(0,"123").build()}">Get Person</a>
*
diff --git a/spring-webmvc/src/main/java/org/springframework/web/servlet/tags/UrlTag.java b/spring-webmvc/src/main/java/org/springframework/web/servlet/tags/UrlTag.java
index 079b3214846..9b0043b3639 100644
--- a/spring-webmvc/src/main/java/org/springframework/web/servlet/tags/UrlTag.java
+++ b/spring-webmvc/src/main/java/org/springframework/web/servlet/tags/UrlTag.java
@@ -313,7 +313,7 @@ public class UrlTag extends HtmlEscapingAwareTag implements ParamAware {
* @param usedParams set of parameter names that have been applied as
* template params
* @param includeQueryStringDelimiter true if the query string should start
- * with a '?' instead of '&'
+ * with a '?' instead of '&'
* @return the query string
*/
protected String createQueryString(List params, Set usedParams, boolean includeQueryStringDelimiter)