Merge branch '5.3.x'

# Conflicts:
#	spring-tx/src/main/java/org/springframework/jca/endpoint/GenericMessageEndpointFactory.java
This commit is contained in:
Sam Brannen 2022-07-12 12:42:49 +02:00
commit 49b47cc6cf
21 changed files with 25 additions and 25 deletions

View File

@ -17,14 +17,14 @@
package org.springframework.dao; package org.springframework.dao;
/** /**
* Exception thrown when we couldn't cleanup after a data access operation, * Exception thrown when we couldn't clean up after a data access operation,
* but the actual operation went OK. * but the actual operation went OK.
* *
* <p>For example, this exception or a subclass might be thrown if a JDBC * <p>For example, this exception or a subclass might be thrown if a JDBC
* Connection couldn't be closed after it had been used successfully. * Connection couldn't be closed after it had been used successfully.
* *
* <p>Note that data access code might perform resources cleanup in a * <p>Note that data access code might perform resources cleanup in a
* finally block and therefore log cleanup failure rather than rethrow it, * {@code finally} block and therefore log cleanup failure rather than rethrow it,
* to keep the original data access exception, if any. * to keep the original data access exception, if any.
* *
* @author Rod Johnson * @author Rod Johnson

View File

@ -27,7 +27,7 @@ import org.springframework.lang.Nullable;
* *
* <p>This exception hierarchy aims to let user code find and handle the * <p>This exception hierarchy aims to let user code find and handle the
* kind of error encountered without knowing the details of the particular * kind of error encountered without knowing the details of the particular
* data access API in use (e.g. JDBC). Thus it is possible to react to an * data access API in use (e.g. JDBC). Thus, it is possible to react to an
* optimistic locking failure without knowing that JDBC is being used. * optimistic locking failure without knowing that JDBC is being used.
* *
* <p>As this class is a runtime exception, there is no need for user code * <p>As this class is a runtime exception, there is no need for user code
@ -50,7 +50,7 @@ public abstract class DataAccessException extends NestedRuntimeException {
/** /**
* Constructor for DataAccessException. * Constructor for DataAccessException.
* @param msg the detail message * @param msg the detail message
* @param cause the root cause (usually from using a underlying * @param cause the root cause (usually from using an underlying
* data access API such as JDBC) * data access API such as JDBC)
*/ */
public DataAccessException(@Nullable String msg, @Nullable Throwable cause) { public DataAccessException(@Nullable String msg, @Nullable Throwable cause) {

View File

@ -18,7 +18,7 @@ package org.springframework.dao;
/** /**
* Exception thrown when an attempt to insert or update data * Exception thrown when an attempt to insert or update data
* results in violation of an primary key or unique constraint. * results in violation of a primary key or unique constraint.
* Note that this is not necessarily a purely relational concept; * Note that this is not necessarily a purely relational concept;
* unique primary keys are required by most database types. * unique primary keys are required by most database types.
* *

View File

@ -41,7 +41,7 @@ public abstract class NonTransientDataAccessException extends DataAccessExceptio
/** /**
* Constructor for NonTransientDataAccessException. * Constructor for NonTransientDataAccessException.
* @param msg the detail message * @param msg the detail message
* @param cause the root cause (usually from using a underlying * @param cause the root cause (usually from using an underlying
* data access API such as JDBC) * data access API such as JDBC)
*/ */
public NonTransientDataAccessException(@Nullable String msg, @Nullable Throwable cause) { public NonTransientDataAccessException(@Nullable String msg, @Nullable Throwable cause) {

View File

@ -41,7 +41,7 @@ public class RecoverableDataAccessException extends DataAccessException {
/** /**
* Constructor for RecoverableDataAccessException. * Constructor for RecoverableDataAccessException.
* @param msg the detail message * @param msg the detail message
* @param cause the root cause (usually from using a underlying * @param cause the root cause (usually from using an underlying
* data access API such as JDBC) * data access API such as JDBC)
*/ */
public RecoverableDataAccessException(String msg, Throwable cause) { public RecoverableDataAccessException(String msg, Throwable cause) {

View File

@ -41,7 +41,7 @@ public abstract class TransientDataAccessException extends DataAccessException {
/** /**
* Constructor for TransientDataAccessException. * Constructor for TransientDataAccessException.
* @param msg the detail message * @param msg the detail message
* @param cause the root cause (usually from using a underlying * @param cause the root cause (usually from using an underlying
* data access API such as JDBC) * data access API such as JDBC)
*/ */
public TransientDataAccessException(String msg, @Nullable Throwable cause) { public TransientDataAccessException(String msg, @Nullable Throwable cause) {

View File

@ -99,7 +99,7 @@ public class PersistenceExceptionTranslationInterceptor
* raw exception when declared, i.e. when the originating method signature's exception * raw exception when declared, i.e. when the originating method signature's exception
* declarations allow for the raw exception to be thrown ("false"). * declarations allow for the raw exception to be thrown ("false").
* <p>Default is "false". Switch this flag to "true" in order to always translate * <p>Default is "false". Switch this flag to "true" in order to always translate
* applicable exceptions, independent from the originating method signature. * applicable exceptions, independent of the originating method signature.
* <p>Note that the originating method does not have to declare the specific exception. * <p>Note that the originating method does not have to declare the specific exception.
* Any base class will do as well, even {@code throws Exception}: As long as the * Any base class will do as well, even {@code throws Exception}: As long as the
* originating method does explicitly declare compatible exceptions, the raw exception * originating method does explicitly declare compatible exceptions, the raw exception

View File

@ -35,7 +35,7 @@ import org.springframework.util.ReflectionUtils;
* {@link jakarta.resource.spi.endpoint.MessageEndpointFactory} interface, * {@link jakarta.resource.spi.endpoint.MessageEndpointFactory} interface,
* providing transaction management capabilities for any kind of message * providing transaction management capabilities for any kind of message
* listener object (e.g. {@link jakarta.jms.MessageListener} objects or * listener object (e.g. {@link jakarta.jms.MessageListener} objects or
* {@link jakarta.resource.cci.MessageListener} objects. * {@link jakarta.resource.cci.MessageListener} objects).
* *
* <p>Uses AOP proxies for concrete endpoint instances, simply wrapping * <p>Uses AOP proxies for concrete endpoint instances, simply wrapping
* the specified message listener object and exposing all of its implemented * the specified message listener object and exposing all of its implemented

View File

@ -244,9 +244,9 @@ public class GenericMessageEndpointManager implements SmartLifecycle, Initializi
/** /**
* Specify the phase in which this endpoint manager should be started * Specify the phase in which this endpoint manager should be started
* and stopped. The startup order proceeds from lowest to highest, and * and stopped. The startup order proceeds from lowest to highest, and
* the shutdown order is the reverse of that. By default this value is * the shutdown order is the reverse of that. By default, this value is
* Integer.MAX_VALUE meaning that this endpoint manager starts as late * {@code Integer.MAX_VALUE} meaning that this endpoint manager starts
* as possible and stops as soon as possible. * as late as possible and stops as soon as possible.
*/ */
public void setPhase(int phase) { public void setPhase(int phase) {
this.phase = phase; this.phase = phase;

View File

@ -26,7 +26,7 @@ package org.springframework.transaction;
* else, a subtransaction with PROPAGATION_NESTED is preferable. * else, a subtransaction with PROPAGATION_NESTED is preferable.
* *
* <p>This interface is inspired by JDBC 3.0's Savepoint mechanism * <p>This interface is inspired by JDBC 3.0's Savepoint mechanism
* but is independent from any specific persistence technology. * but is independent of any specific persistence technology.
* *
* @author Juergen Hoeller * @author Juergen Hoeller
* @since 1.1 * @since 1.1

View File

@ -170,7 +170,7 @@ public class DefaultTransactionAttribute extends DefaultTransactionDefinition im
/** /**
* The default behavior is as with EJB: rollback on unchecked exception * The default behavior is as with EJB: rollback on unchecked exception
* ({@link RuntimeException}), assuming an unexpected outcome outside of any * ({@link RuntimeException}), assuming an unexpected outcome outside any
* business rules. Additionally, we also attempt to rollback on {@link Error} which * business rules. Additionally, we also attempt to rollback on {@link Error} which
* is clearly an unexpected outcome as well. By contrast, a checked exception is * is clearly an unexpected outcome as well. By contrast, a checked exception is
* considered a business exception and therefore a regular expected outcome of the * considered a business exception and therefore a regular expected outcome of the

View File

@ -22,7 +22,7 @@ import org.springframework.lang.Nullable;
import org.springframework.util.Assert; import org.springframework.util.Assert;
/** /**
* Rule determining whether or not a given exception should cause a rollback. * Rule determining whether a given exception should cause a rollback.
* *
* <p>Multiple such rules can be applied to determine whether a transaction * <p>Multiple such rules can be applied to determine whether a transaction
* should commit or rollback after an exception has been thrown. * should commit or rollback after an exception has been thrown.

View File

@ -570,7 +570,7 @@ public abstract class TransactionAspectSupport implements BeanFactoryAware, Init
* @param txAttr the TransactionAttribute (may be {@code null}) * @param txAttr the TransactionAttribute (may be {@code null})
* @param joinpointIdentification the fully qualified method name * @param joinpointIdentification the fully qualified method name
* (used for monitoring and logging purposes) * (used for monitoring and logging purposes)
* @return a TransactionInfo object, whether or not a transaction was created. * @return a TransactionInfo object, whether a transaction was created.
* The {@code hasTransaction()} method on TransactionInfo can be used to * The {@code hasTransaction()} method on TransactionInfo can be used to
* tell if there was a transaction created. * tell if there was a transaction created.
* @see #getTransactionAttributeSource() * @see #getTransactionAttributeSource()

View File

@ -44,7 +44,7 @@ public class TransactionAttributeEditor extends PropertyEditorSupport {
/** /**
* Format is PROPAGATION_NAME,ISOLATION_NAME,readOnly,timeout_NNNN,+Exception1,-Exception2. * Format is PROPAGATION_NAME,ISOLATION_NAME,readOnly,timeout_NNNN,+Exception1,-Exception2.
* Null or the empty string means that the method is non transactional. * Null or the empty string means that the method is non-transactional.
*/ */
@Override @Override
public void setAsText(String text) throws IllegalArgumentException { public void setAsText(String text) throws IllegalArgumentException {

View File

@ -632,7 +632,7 @@ public abstract class AbstractReactiveTransactionManager implements ReactiveTran
} }
else if (!synchronizations.isEmpty()) { else if (!synchronizations.isEmpty()) {
// Existing transaction that we participate in, controlled outside // Existing transaction that we participate in, controlled outside
// of the scope of this Spring transaction manager -> try to register // the scope of this Spring transaction manager -> try to register
// an afterCompletion callback with the existing (JTA) transaction. // an afterCompletion callback with the existing (JTA) transaction.
return registerAfterCompletionWithExistingTransaction( return registerAfterCompletionWithExistingTransaction(
synchronizationManager, status.getTransaction(), synchronizations); synchronizationManager, status.getTransaction(), synchronizations);

View File

@ -953,7 +953,7 @@ public abstract class AbstractPlatformTransactionManager implements PlatformTran
} }
else if (!synchronizations.isEmpty()) { else if (!synchronizations.isEmpty()) {
// Existing transaction that we participate in, controlled outside // Existing transaction that we participate in, controlled outside
// of the scope of this Spring transaction manager -> try to register // the scope of this Spring transaction manager -> try to register
// an afterCompletion callback with the existing (JTA) transaction. // an afterCompletion callback with the existing (JTA) transaction.
registerAfterCompletionWithExistingTransaction(status.getTransaction(), synchronizations); registerAfterCompletionWithExistingTransaction(status.getTransaction(), synchronizations);
} }

View File

@ -222,7 +222,7 @@ public abstract class AbstractTransactionStatus implements TransactionStatus {
//--------------------------------------------------------------------- //---------------------------------------------------------------------
/** /**
* This implementations is empty, considering flush as a no-op. * This implementation is empty, considering flush as a no-op.
*/ */
@Override @Override
public void flush() { public void flush() {

View File

@ -31,7 +31,7 @@ public interface ResourceTransactionDefinition extends TransactionDefinition {
/** /**
* Determine whether the transactional resource is ready for local optimizations. * Determine whether the transactional resource is ready for local optimizations.
* @return {@code true} if the resource is known to be entirely transaction-local, * @return {@code true} if the resource is known to be entirely transaction-local,
* not affecting any operations outside of the scope of the current transaction * not affecting any operations outside the scope of the current transaction
* @see #isReadOnly() * @see #isReadOnly()
*/ */
boolean isLocalResource(); boolean isLocalResource();

View File

@ -20,7 +20,7 @@ import java.io.Flushable;
/** /**
* Interface to be implemented by transaction objects that are able to * Interface to be implemented by transaction objects that are able to
* return an internal rollback-only marker, typically from a another * return an internal rollback-only marker, typically from another
* transaction that has participated and marked it as rollback-only. * transaction that has participated and marked it as rollback-only.
* *
* <p>Autodetected by DefaultTransactionStatus, to always return a * <p>Autodetected by DefaultTransactionStatus, to always return a

View File

@ -214,7 +214,7 @@ public class JndiJtaTransactionManagerTests {
} }
/** /**
* Prevent any side-effects due to this test modifying ThreadLocals that might * Prevent any side effects due to this test modifying ThreadLocals that might
* affect subsequent tests when all tests are run in the same JVM, as with Eclipse. * affect subsequent tests when all tests are run in the same JVM, as with Eclipse.
*/ */
@AfterEach @AfterEach

View File

@ -1184,7 +1184,7 @@ public class JtaTransactionManagerTests {
/** /**
* Prevent any side-effects due to this test modifying ThreadLocals that might * Prevent any side effects due to this test modifying ThreadLocals that might
* affect subsequent tests when all tests are run in the same JVM, as with Eclipse. * affect subsequent tests when all tests are run in the same JVM, as with Eclipse.
*/ */
@AfterEach @AfterEach