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;
/**
* 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.
*
* <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.
*
* <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.
*
* @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
* 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.
*
* <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.
* @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)
*/
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
* 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;
* unique primary keys are required by most database types.
*

View File

@ -41,7 +41,7 @@ public abstract class NonTransientDataAccessException extends DataAccessExceptio
/**
* Constructor for NonTransientDataAccessException.
* @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)
*/
public NonTransientDataAccessException(@Nullable String msg, @Nullable Throwable cause) {

View File

@ -41,7 +41,7 @@ public class RecoverableDataAccessException extends DataAccessException {
/**
* Constructor for RecoverableDataAccessException.
* @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)
*/
public RecoverableDataAccessException(String msg, Throwable cause) {

View File

@ -41,7 +41,7 @@ public abstract class TransientDataAccessException extends DataAccessException {
/**
* Constructor for TransientDataAccessException.
* @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)
*/
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
* declarations allow for the raw exception to be thrown ("false").
* <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.
* 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

View File

@ -35,7 +35,7 @@ import org.springframework.util.ReflectionUtils;
* {@link jakarta.resource.spi.endpoint.MessageEndpointFactory} interface,
* providing transaction management capabilities for any kind of message
* 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
* 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
* and stopped. The startup order proceeds from lowest to highest, and
* the shutdown order is the reverse of that. By default this value is
* Integer.MAX_VALUE meaning that this endpoint manager starts as late
* as possible and stops as soon as possible.
* the shutdown order is the reverse of that. By default, this value is
* {@code Integer.MAX_VALUE} meaning that this endpoint manager starts
* as late as possible and stops as soon as possible.
*/
public void setPhase(int phase) {
this.phase = phase;

View File

@ -26,7 +26,7 @@ package org.springframework.transaction;
* else, a subtransaction with PROPAGATION_NESTED is preferable.
*
* <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
* @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
* ({@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
* 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

View File

@ -22,7 +22,7 @@ import org.springframework.lang.Nullable;
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
* 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 joinpointIdentification the fully qualified method name
* (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
* tell if there was a transaction created.
* @see #getTransactionAttributeSource()

View File

@ -44,7 +44,7 @@ public class TransactionAttributeEditor extends PropertyEditorSupport {
/**
* 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
public void setAsText(String text) throws IllegalArgumentException {

View File

@ -632,7 +632,7 @@ public abstract class AbstractReactiveTransactionManager implements ReactiveTran
}
else if (!synchronizations.isEmpty()) {
// 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.
return registerAfterCompletionWithExistingTransaction(
synchronizationManager, status.getTransaction(), synchronizations);

View File

@ -953,7 +953,7 @@ public abstract class AbstractPlatformTransactionManager implements PlatformTran
}
else if (!synchronizations.isEmpty()) {
// 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.
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
public void flush() {

View File

@ -31,7 +31,7 @@ public interface ResourceTransactionDefinition extends TransactionDefinition {
/**
* Determine whether the transactional resource is ready for local optimizations.
* @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()
*/
boolean isLocalResource();

View File

@ -20,7 +20,7 @@ import java.io.Flushable;
/**
* 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.
*
* <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.
*/
@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.
*/
@AfterEach