Stop referring to old Spring versions in Javadoc
This commit is contained in:
Sam Brannen
parent
e427ac2683
commit
932ce04541
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright 2002-2023 the original author or authors.
|
||||
* Copyright 2002-2024 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,18 +54,17 @@ import java.lang.annotation.Target;
|
|||
*
|
||||
* <h3>Autowired Parameters</h3>
|
||||
* <p>Although {@code @Autowired} can technically be declared on individual method
|
||||
* or constructor parameters since Spring Framework 5.0, most parts of the
|
||||
* framework ignore such declarations. The only part of the core Spring Framework
|
||||
* that actively supports autowired parameters is the JUnit Jupiter support in
|
||||
* the {@code spring-test} module (see the
|
||||
* or constructor parameters, most parts of the framework ignore such declarations.
|
||||
* The only part of the core Spring Framework that actively supports autowired
|
||||
* parameters is the JUnit Jupiter support in the {@code spring-test} module (see the
|
||||
* <a href="https://docs.spring.io/spring/docs/current/spring-framework-reference/testing.html#testcontext-junit-jupiter-di">TestContext framework</a>
|
||||
* reference documentation for details).
|
||||
*
|
||||
* <h3>Multiple Arguments and 'required' Semantics</h3>
|
||||
* <p>In the case of a multi-arg constructor or method, the {@link #required} attribute
|
||||
* is applicable to all arguments. Individual parameters may be declared as Java-8 style
|
||||
* {@link java.util.Optional} or, as of Spring Framework 5.0, also as {@code @Nullable}
|
||||
* or a not-null parameter type in Kotlin, overriding the base 'required' semantics.
|
||||
* {@link java.util.Optional} as well as {@code @Nullable} or a not-null parameter
|
||||
* type in Kotlin, overriding the base 'required' semantics.
|
||||
*
|
||||
* <h3>Autowiring Arrays, Collections, and Maps</h3>
|
||||
* <p>In case of an array, {@link java.util.Collection}, or {@link java.util.Map}
|
||||
|
|
|
|||
|
|
@ -224,8 +224,8 @@ public interface ConfigurableApplicationContext extends ApplicationContext, Life
|
|||
* on JVM shutdown unless it has already been closed at that time.
|
||||
* <p>This method can be called multiple times. Only one shutdown hook
|
||||
* (at max) will be registered for each context instance.
|
||||
* <p>As of Spring Framework 5.2, the {@linkplain Thread#getName() name} of
|
||||
* the shutdown hook thread should be {@link #SHUTDOWN_HOOK_THREAD_NAME}.
|
||||
* <p>The {@linkplain Thread#getName() name} of the shutdown hook thread
|
||||
* should be {@link #SHUTDOWN_HOOK_THREAD_NAME}.
|
||||
* @see java.lang.Runtime#addShutdownHook
|
||||
* @see #close()
|
||||
*/
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright 2002-2017 the original author or authors.
|
||||
* Copyright 2002-2024 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.util.ClassUtils;
|
|||
* {@link LoadTimeWeaver} implementation for GlassFish's
|
||||
* {@code org.glassfish.api.deployment.InstrumentableClassLoader InstrumentableClassLoader}.
|
||||
*
|
||||
* <p>As of Spring Framework 5.0, this weaver supports GlassFish 4+.
|
||||
* <p>This weaver supports GlassFish 4+.
|
||||
*
|
||||
* @author Costin Leau
|
||||
* @author Juergen Hoeller
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright 2002-2019 the original author or authors.
|
||||
* Copyright 2002-2024 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,8 +31,7 @@ import org.springframework.util.ReflectionUtils;
|
|||
* {@link LoadTimeWeaver} implementation for JBoss's instrumentable ClassLoader.
|
||||
* Thanks to Ales Justin and Marius Bogoevici for the initial prototype.
|
||||
*
|
||||
* <p>As of Spring Framework 5.0, this weaver supports WildFly 8+.
|
||||
* As of Spring Framework 5.1.5, it also supports WildFly 13+.
|
||||
* <p>This weaver supports WildFly 13+.
|
||||
*
|
||||
* @author Costin Leau
|
||||
* @author Juergen Hoeller
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright 2002-2023 the original author or authors.
|
||||
* Copyright 2002-2024 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.
|
||||
|
|
@ -295,8 +295,8 @@ public class ScheduledTaskRegistrar implements ScheduledTaskHolder, Initializing
|
|||
|
||||
/**
|
||||
* Add a {@link Runnable} task to be triggered per the given cron {@code expression}.
|
||||
* <p>As of Spring Framework 5.2, this method will not register the task if the
|
||||
* {@code expression} is equal to {@link #CRON_DISABLED}.
|
||||
* <p>This method will not register the task if the {@code expression} is
|
||||
* equal to {@link #CRON_DISABLED}.
|
||||
*/
|
||||
public void addCronTask(Runnable task, String expression) {
|
||||
if (!CRON_DISABLED.equals(expression)) {
|
||||
|
|
|
|||
|
|
@ -549,11 +549,10 @@ public class DataBinder implements PropertyEditorRegistry, TypeConverter {
|
|||
* well as direct equality.
|
||||
* <p>The default implementation of this method stores disallowed field patterns
|
||||
* in {@linkplain PropertyAccessorUtils#canonicalPropertyName(String) canonical}
|
||||
* form. As of Spring Framework 5.2.21, the default implementation also transforms
|
||||
* disallowed field patterns to {@linkplain String#toLowerCase() lowercase} to
|
||||
* support case-insensitive pattern matching in {@link #isAllowed}. Subclasses
|
||||
* which override this method must therefore take both of these transformations
|
||||
* into account.
|
||||
* form and also transforms disallowed field patterns to
|
||||
* {@linkplain String#toLowerCase() lowercase} to support case-insensitive
|
||||
* pattern matching in {@link #isAllowed}. Subclasses which override this
|
||||
* method must therefore take both of these transformations into account.
|
||||
* <p>More sophisticated matching can be implemented by overriding the
|
||||
* {@link #isAllowed} method.
|
||||
* <p>Alternatively, specify a list of <i>allowed</i> field patterns.
|
||||
|
|
|
|||
|
|
@ -69,7 +69,7 @@ import org.springframework.validation.method.ParameterValidationResult;
|
|||
* at the type level of the containing target class, applying to all public service methods
|
||||
* of that class. By default, JSR-303 will validate against its default group only.
|
||||
*
|
||||
* <p>As of Spring 5.0, this functionality requires a Bean Validation 1.1+ provider.
|
||||
* <p>This functionality requires a Bean Validation 1.1+ provider.
|
||||
*
|
||||
* @author Juergen Hoeller
|
||||
* @author Rossen Stoyanchev
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright 2002-2023 the original author or authors.
|
||||
* Copyright 2002-2024 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.
|
||||
|
|
@ -60,7 +60,7 @@ import org.springframework.validation.method.MethodValidationResult;
|
|||
* inline constraint annotations. Validation groups can be specified through {@code @Validated}
|
||||
* as well. By default, JSR-303 will validate against its default group only.
|
||||
*
|
||||
* <p>As of Spring 5.0, this functionality requires a Bean Validation 1.1+ provider.
|
||||
* <p>This functionality requires a Bean Validation 1.1+ provider.
|
||||
*
|
||||
* @author Juergen Hoeller
|
||||
* @since 3.1
|
||||
|
|
|
|||
|
|
@ -55,8 +55,7 @@ import org.springframework.validation.SmartValidator;
|
|||
* {@link CustomValidatorBean} and {@link LocalValidatorFactoryBean},
|
||||
* and as the primary implementation of the {@link SmartValidator} interface.
|
||||
*
|
||||
* <p>As of Spring Framework 5.0, this adapter is fully compatible with
|
||||
* Bean Validation 1.1 as well as 2.0.
|
||||
* <p>This adapter is fully compatible with Bean Validation 1.1 as well as 2.0.
|
||||
*
|
||||
* @author Juergen Hoeller
|
||||
* @author Sam Brannen
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright 2002-2019 the original author or authors.
|
||||
* Copyright 2002-2024 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.
|
||||
|
|
@ -25,8 +25,8 @@ import org.springframework.lang.Nullable;
|
|||
* <p>Note that some ClassLoaders do not expose the package metadata,
|
||||
* hence this class might not be able to determine the Spring version
|
||||
* in all environments. Consider using a reflection-based check instead —
|
||||
* for example, checking for the presence of a specific Spring 5.2
|
||||
* method that you intend to call.
|
||||
* for example, checking for the presence of a specific Spring method that you
|
||||
* intend to call.
|
||||
*
|
||||
* @author Juergen Hoeller
|
||||
* @since 1.1
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright 2002-2023 the original author or authors.
|
||||
* Copyright 2002-2024 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,10 +62,9 @@ public interface Profiles {
|
|||
* without using parentheses. For example, {@code "a & b | c"} is not a valid
|
||||
* expression: it must be expressed as {@code "(a & b) | c"} or
|
||||
* {@code "a & (b | c)"}.
|
||||
* <p>As of Spring Framework 5.1.17, two {@code Profiles} instances returned
|
||||
* by this method are considered equivalent to each other (in terms of
|
||||
* {@code equals()} and {@code hashCode()} semantics) if they are created
|
||||
* with identical <em>profile expressions</em>.
|
||||
* <p>Two {@code Profiles} instances returned by this method are considered
|
||||
* equivalent to each other (in terms of {@code equals()} and {@code hashCode()}
|
||||
* semantics) if they are created with identical <em>profile expressions</em>.
|
||||
* @param profileExpressions the <em>profile expressions</em> to include
|
||||
* @return a new {@link Profiles} instance
|
||||
*/
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright 2002-2023 the original author or authors.
|
||||
* Copyright 2002-2024 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.
|
||||
|
|
@ -45,10 +45,10 @@ import org.springframework.util.StringUtils;
|
|||
* Supports resolution as a {@code File} and also as a {@code URL}.
|
||||
* Implements the extended {@link WritableResource} interface.
|
||||
*
|
||||
* <p>Note: As of Spring Framework 5.0, this {@link Resource} implementation uses
|
||||
* NIO.2 API for read/write interactions. As of 5.1, it may be constructed with a
|
||||
* {@link java.nio.file.Path} handle in which case it will perform all file system
|
||||
* interactions via NIO.2, only resorting to {@link File} on {@link #getFile()}.
|
||||
* <p>Note: This {@link Resource} implementation uses NIO.2 API for read/write
|
||||
* interactions and may be constructed with a {@link java.nio.file.Path} handle
|
||||
* in which case it will perform all file system interactions via NIO.2, only
|
||||
* resorting to {@link File} on {@link #getFile()}.
|
||||
*
|
||||
* @author Juergen Hoeller
|
||||
* @author Sam Brannen
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright 2002-2023 the original author or authors.
|
||||
* Copyright 2002-2024 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,10 +37,10 @@ import org.springframework.lang.Nullable;
|
|||
* <p>This class is normally used to verify performance during proof-of-concept
|
||||
* work and in development, rather than as part of production applications.
|
||||
*
|
||||
* <p>As of Spring Framework 5.2, running time is tracked and reported in
|
||||
* nanoseconds. As of 6.1, the default time unit for String renderings is
|
||||
* seconds with decimal points in nanosecond precision. Custom renderings with
|
||||
* specific time units can be requested through {@link #prettyPrint(TimeUnit)}.
|
||||
* <p>Running time is tracked and reported in nanoseconds. As of Spring Framework
|
||||
* 6.1, the default time unit for String renderings is seconds with decimal points
|
||||
* in nanosecond precision. Custom renderings with specific time units can be
|
||||
* requested through {@link #prettyPrint(TimeUnit)}.
|
||||
*
|
||||
* @author Rod Johnson
|
||||
* @author Juergen Hoeller
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright 2002-2021 the original author or authors.
|
||||
* Copyright 2002-2024 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,10 +36,10 @@ public abstract class DatabasePopulatorUtils {
|
|||
|
||||
/**
|
||||
* Execute the given {@link DatabasePopulator} against the given {@link DataSource}.
|
||||
* <p>As of Spring Framework 5.3.11, the {@link Connection} for the supplied
|
||||
* {@code DataSource} will be {@linkplain Connection#commit() committed} if
|
||||
* it is not configured for {@link Connection#getAutoCommit() auto-commit} and
|
||||
* is not {@linkplain DataSourceUtils#isConnectionTransactional transactional}.
|
||||
* <p>The {@link Connection} for the supplied {@code DataSource} will be
|
||||
* {@linkplain Connection#commit() committed} if it is not configured for
|
||||
* {@link Connection#getAutoCommit() auto-commit} and is not
|
||||
* {@linkplain DataSourceUtils#isConnectionTransactional transactional}.
|
||||
* @param populator the {@code DatabasePopulator} to execute
|
||||
* @param dataSource the {@code DataSource} to execute against
|
||||
* @throws DataAccessException if an error occurs, specifically a {@link ScriptException}
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright 2002-2021 the original author or authors.
|
||||
* Copyright 2002-2024 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,7 +54,7 @@ import org.springframework.jdbc.support.JdbcUtils;
|
|||
* "useNewConnection" property to false. In this case you <i>MUST</i> use a non-transactional
|
||||
* storage engine like MYISAM when defining the incrementer table.
|
||||
*
|
||||
* <p>As of Spring Framework 5.3.7, {@code MySQLMaxValueIncrementer} is compatible with
|
||||
* <p>Note that {@code MySQLMaxValueIncrementer} is compatible with
|
||||
* <a href="https://dev.mysql.com/doc/refman/8.0/en/mysql-tips.html#safe-updates">MySQL safe updates mode</a>.
|
||||
*
|
||||
* @author Jean-Pierre Pawlak
|
||||
|
|
@ -104,7 +104,7 @@ public class MySQLMaxValueIncrementer extends AbstractColumnMaxValueIncrementer
|
|||
* {@code false} is sufficient if the storage engine of the sequence table
|
||||
* is non-transactional (like MYISAM), avoiding the effort of acquiring an
|
||||
* extra {@code Connection} for the increment operation.
|
||||
* <p>Default is {@code true} since Spring Framework 5.0.
|
||||
* <p>Default is {@code true}.
|
||||
* @since 4.3.6
|
||||
* @see DataSource#getConnection()
|
||||
*/
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright 2002-2023 the original author or authors.
|
||||
* Copyright 2002-2024 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.
|
||||
|
|
@ -114,9 +114,9 @@ public @interface JmsListener {
|
|||
|
||||
/**
|
||||
* The name for the durable subscription, if any.
|
||||
* <p>As of Spring Framework 5.3.26, if an explicit subscription name is not
|
||||
* specified, a default subscription name will be generated based on the fully
|
||||
* qualified name of the annotated listener method — for example,
|
||||
* <p>If an explicit subscription name is not specified, a default subscription
|
||||
* name will be generated based on the fully qualified name of the annotated
|
||||
* listener method — for example,
|
||||
* {@code "org.example.jms.ProductListener.processRequest"} for a
|
||||
* {@code processRequest(...)} listener method in the
|
||||
* {@code org.example.jms.ProductListener} class.
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright 2002-2023 the original author or authors.
|
||||
* Copyright 2002-2024 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.
|
||||
|
|
@ -43,7 +43,7 @@ import org.springframework.util.Assert;
|
|||
* are provided as additional arguments so that these can be injected as
|
||||
* method arguments if necessary.
|
||||
*
|
||||
* <p>As of Spring Framework 5.3.26, {@code MessagingMessageListenerAdapter} implements
|
||||
* <p>Note that {@code MessagingMessageListenerAdapter} implements
|
||||
* {@link SubscriptionNameProvider} in order to provide a meaningful default
|
||||
* subscription name. See {@link #getSubscriptionName()} for details.
|
||||
*
|
||||
|
|
|
|||
|
|
@ -189,11 +189,11 @@ public class HibernateTransactionManager extends AbstractPlatformTransactionMana
|
|||
|
||||
/**
|
||||
* Set the JDBC DataSource that this instance should manage transactions for.
|
||||
* The DataSource should match the one used by the Hibernate SessionFactory:
|
||||
* <p>The DataSource should match the one used by the Hibernate SessionFactory:
|
||||
* for example, you could specify the same JNDI DataSource for both.
|
||||
* <p>If the SessionFactory was configured with LocalDataSourceConnectionProvider,
|
||||
* i.e. by Spring's LocalSessionFactoryBean with a specified "dataSource",
|
||||
* the DataSource will be auto-detected: You can still explicitly specify the
|
||||
* the DataSource will be auto-detected. You can still explicitly specify the
|
||||
* DataSource, but you don't need to in this case.
|
||||
* <p>A transactional JDBC Connection for this DataSource will be provided to
|
||||
* application code accessing this DataSource directly via DataSourceUtils
|
||||
|
|
@ -210,7 +210,7 @@ public class HibernateTransactionManager extends AbstractPlatformTransactionMana
|
|||
* for the actual target DataSource. Alternatively, consider switching
|
||||
* {@link #setPrepareConnection "prepareConnection"} to {@code false}.</b>
|
||||
* In both cases, this transaction manager will not eagerly acquire a
|
||||
* JDBC Connection for each Hibernate Session anymore (as of Spring 5.1).
|
||||
* JDBC Connection for each Hibernate Session.
|
||||
* @see #setAutodetectDataSource
|
||||
* @see TransactionAwareDataSourceProxy
|
||||
* @see org.springframework.jdbc.datasource.LazyConnectionDataSourceProxy
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright 2002-2023 the original author or authors.
|
||||
* Copyright 2002-2024 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.
|
||||
|
|
@ -109,9 +109,7 @@ import org.springframework.util.xml.StaxUtils;
|
|||
* Therefore, it has limited namespace support. As such, it is rather unsuitable for
|
||||
* usage within Web Services.
|
||||
*
|
||||
* <p>This marshaller requires XStream 1.4.7 or higher, as of Spring 5.2.17.
|
||||
* Note that {@link XStream} construction has been reworked in 4.0, with the
|
||||
* stream driver and the class loader getting passed into XStream itself now.
|
||||
* <p>This marshaller requires XStream 1.4.7 or higher.
|
||||
*
|
||||
* <p>As of Spring Framework 6.0, the default {@link HierarchicalStreamDriver} is
|
||||
* a {@link DomDriver} that uses the configured {@linkplain #setEncoding(String)
|
||||
|
|
@ -641,11 +639,10 @@ public class XStreamMarshaller extends AbstractMarshaller implements BeanClassLo
|
|||
|
||||
/**
|
||||
* Return the native XStream delegate used by this marshaller.
|
||||
* <p><b>NOTE: This method has been marked as final as of Spring 4.0.</b>
|
||||
* It can be used to access the fully configured XStream for marshalling
|
||||
* but not configuration purposes anymore.
|
||||
* <p>As of Spring Framework 5.1.16, creation of the {@link XStream} instance
|
||||
* returned by this method is thread safe.
|
||||
* <p>The creation of the {@link XStream} instance returned by this method is
|
||||
* thread safe.
|
||||
* <p><b>NOTE: This method is marked as final.</b> It can be used to access
|
||||
* the fully configured XStream for marshalling but not configuration purposes.
|
||||
*/
|
||||
public final XStream getXStream() {
|
||||
return this.xstream.obtain();
|
||||
|
|
|
|||
|
|
@ -29,7 +29,7 @@ import java.lang.annotation.Target;
|
|||
* <em>Spring TestContext Framework</em>.
|
||||
*
|
||||
* <p>This annotation may also be used as a <em>meta-annotation</em> to create
|
||||
* custom <em>composed annotations</em>. As of Spring Framework 5.1, a locally
|
||||
* custom <em>composed annotations</em>. Note, however, that a locally
|
||||
* declared {@code @BootstrapWith} annotation (i.e., one that is <em>directly
|
||||
* present</em> on the current test class) will override any meta-present
|
||||
* declarations of {@code @BootstrapWith}.
|
||||
|
|
|
|||
|
|
@ -46,8 +46,8 @@ import org.springframework.lang.Nullable;
|
|||
* <p>This annotation may be used as a <em>meta-annotation</em> to create custom
|
||||
* <em>composed annotations</em>.
|
||||
*
|
||||
* <p>As of Spring Framework 5.2, this annotation is only supported in conjunction
|
||||
* with the {@link org.springframework.test.context.junit.jupiter.SpringExtension
|
||||
* <p>This annotation is only supported in conjunction with the
|
||||
* {@link org.springframework.test.context.junit.jupiter.SpringExtension
|
||||
* SpringExtension} for use with JUnit Jupiter. Note that the {@code SpringExtension} is
|
||||
* often automatically registered for you — for example, when using annotations such as
|
||||
* {@link org.springframework.test.context.junit.jupiter.SpringJUnitConfig @SpringJUnitConfig} and
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright 2002-2023 the original author or authors.
|
||||
* Copyright 2002-2024 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,13 +30,13 @@ import org.springframework.test.annotation.DirtiesContext.HierarchyMode;
|
|||
* {@code TestContext} encapsulates the context in which a test is executed,
|
||||
* agnostic of the actual testing framework in use.
|
||||
*
|
||||
* <p>As of Spring Framework 5.0, concrete implementations are highly encouraged
|
||||
* to implement a <em>copy constructor</em> in order to allow the immutable state
|
||||
* and attributes of a {@code TestContext} to be used as a template for additional
|
||||
* contexts created for parallel test execution. The copy constructor must accept a
|
||||
* single argument of the type of the concrete implementation. Any implementation
|
||||
* that does not provide a copy constructor will likely fail in an environment
|
||||
* that executes tests concurrently.
|
||||
* <p>Concrete implementations are highly encouraged to implement a <em>copy
|
||||
* constructor</em> in order to allow the immutable state and attributes of a
|
||||
* {@code TestContext} to be used as a template for additional contexts created
|
||||
* for parallel test execution. The copy constructor must accept a single argument
|
||||
* of the type of the concrete implementation. Any implementation that does not
|
||||
* provide a copy constructor will likely fail in an environment that executes
|
||||
* tests concurrently.
|
||||
*
|
||||
* <p>As of Spring Framework 6.1, concrete implementations are highly encouraged to
|
||||
* override {@link #setMethodInvoker(MethodInvoker)} and {@link #getMethodInvoker()}.
|
||||
|
|
|
|||
|
|
@ -60,14 +60,13 @@ import org.springframework.util.StringUtils;
|
|||
* <h3>Multipart Data</h3>
|
||||
*
|
||||
* <p>By default, {@code "multipart/form-data"} is used as the content type when
|
||||
* {@linkplain #write writing} multipart data. As of Spring Framework 5.2 it is
|
||||
* also possible to write multipart data using other multipart subtypes such as
|
||||
* {@code "multipart/mixed"} and {@code "multipart/related"}, as long as the
|
||||
* multipart subtype is registered as a {@linkplain #getSupportedMediaTypes
|
||||
* supported media type} <em>and</em> the desired multipart subtype is specified
|
||||
* as the content type when {@linkplain #write writing} the multipart data. Note
|
||||
* that {@code "multipart/mixed"} is registered as a supported media type by
|
||||
* default.
|
||||
* {@linkplain #write writing} multipart data. It is also possible to write
|
||||
* multipart data using other multipart subtypes such as {@code "multipart/mixed"}
|
||||
* and {@code "multipart/related"}, as long as the multipart subtype is registered
|
||||
* as a {@linkplain #getSupportedMediaTypes supported media type} <em>and</em> the
|
||||
* desired multipart subtype is specified as the content type when
|
||||
* {@linkplain #write writing} the multipart data. Note that {@code "multipart/mixed"}
|
||||
* is registered as a supported media type by default.
|
||||
*
|
||||
* <p>When writing multipart data, this converter uses other
|
||||
* {@link HttpMessageConverter HttpMessageConverters} to write the respective
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright 2002-2023 the original author or authors.
|
||||
* Copyright 2002-2024 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.
|
||||
|
|
@ -220,9 +220,8 @@ public class ControllerAdviceBean implements Ordered {
|
|||
/**
|
||||
* Get the bean instance for this {@code ControllerAdviceBean}, if necessary
|
||||
* resolving the bean name through the {@link BeanFactory}.
|
||||
* <p>As of Spring Framework 5.2, once the bean instance has been resolved it
|
||||
* will be cached if it is a singleton, thereby avoiding repeated lookups in
|
||||
* the {@code BeanFactory}.
|
||||
* <p>Once the bean instance has been resolved it will be cached if it is a
|
||||
* singleton, thereby avoiding repeated lookups in the {@code BeanFactory}.
|
||||
*/
|
||||
public Object resolveBean() {
|
||||
if (this.resolvedBean == null) {
|
||||
|
|
@ -276,8 +275,8 @@ public class ControllerAdviceBean implements Ordered {
|
|||
* Find beans annotated with {@link ControllerAdvice @ControllerAdvice} in the
|
||||
* given {@link ApplicationContext} and wrap them as {@code ControllerAdviceBean}
|
||||
* instances.
|
||||
* <p>As of Spring Framework 5.2, the {@code ControllerAdviceBean} instances
|
||||
* in the returned list are sorted using {@link OrderComparator#sort(List)}.
|
||||
* <p>Note that the {@code ControllerAdviceBean} instances in the returned list
|
||||
* are sorted using {@link OrderComparator#sort(List)}.
|
||||
* @see #getOrder()
|
||||
* @see OrderComparator
|
||||
* @see Ordered
|
||||
|
|
|
|||
|
|
@ -41,23 +41,25 @@ import org.springframework.web.multipart.MultipartRequest;
|
|||
import org.springframework.web.servlet.support.RequestContextUtils;
|
||||
|
||||
/**
|
||||
* Resolves servlet backed request-related method arguments. Supports values of the
|
||||
* following types:
|
||||
* Resolves servlet backed request-related method arguments.
|
||||
*
|
||||
* <p>Supports values of the following types:
|
||||
*
|
||||
* <ul>
|
||||
* <li>{@link WebRequest}
|
||||
* <li>{@link ServletRequest}
|
||||
* <li>{@link MultipartRequest}
|
||||
* <li>{@link HttpSession}
|
||||
* <li>{@link PushBuilder} (as of Spring 5.0 on Servlet 4.0)
|
||||
* <li>{@link PushBuilder}
|
||||
* <li>{@link Principal} but only if not annotated in order to allow custom
|
||||
* resolvers to resolve it, and the falling back on
|
||||
* {@link PrincipalMethodArgumentResolver}.
|
||||
* resolvers to resolve it, and then falling back on
|
||||
* {@link PrincipalMethodArgumentResolver}
|
||||
* <li>{@link InputStream}
|
||||
* <li>{@link Reader}
|
||||
* <li>{@link HttpMethod} (as of Spring 4.0)
|
||||
* <li>{@link HttpMethod}
|
||||
* <li>{@link Locale}
|
||||
* <li>{@link TimeZone} (as of Spring 4.0)
|
||||
* <li>{@link java.time.ZoneId} (as of Spring 4.0 and Java 8)
|
||||
* <li>{@link TimeZone}
|
||||
* <li>{@link ZoneId}
|
||||
* </ul>
|
||||
*
|
||||
* @author Arjen Poutsma
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright 2002-2023 the original author or authors.
|
||||
* Copyright 2002-2024 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,10 +67,11 @@ import org.springframework.web.socket.sockjs.frame.SockJsFrame;
|
|||
|
||||
/**
|
||||
* An XHR transport based on Undertow's {@link io.undertow.client.UndertowClient}.
|
||||
* Requires Undertow 1.3 or 1.4, including XNIO, as of Spring Framework 5.0.
|
||||
*
|
||||
* <p>Requires Undertow 1.3 or 1.4, including XNIO.
|
||||
*
|
||||
* <p>When used for testing purposes (e.g. load testing) or for specific use cases
|
||||
* (like HTTPS configuration), a custom OptionMap should be provided:
|
||||
* (like HTTPS configuration), a custom {@link OptionMap} should be provided:
|
||||
*
|
||||
* <pre class="code">
|
||||
* OptionMap optionMap = OptionMap.builder()
|
||||
|
|
|
|||
Loading…
Reference in New Issue