Ankur Mhatre
585eed4d57
The repository now aggregates two independent modules. migration-behavior/ is the
original project, moved unchanged; it stays on Spring Boot 4.0.6 / JDK 21 because
that is what the four published migration articles were verified against, and
upgrading it would silently invalidate output they quote. The article-tagged trees
are untouched, so links into a tag are unaffected.
transactions/ Companion code for "@Transactional in Spring: Propagation, Isolation,
and the Six Ways It Silently Does Nothing". Spring Boot 4.1.1 / JDK 25.
Every row of the propagation matrix is produced by calling the method and asking the
transaction manager what it did. The transaction NAME is the exhibit: a scope that
joined reports its caller's name, a scope that started its own reports its own.
Three things the transcripts settle:
- Propagation.NESTED cannot be used with JpaTransactionManager. It fails twice,
with two different messages, the second of which blames your JPA provider. The
savepoint manager comes from the object the JpaDialect returns when it begins the
transaction, and Hibernate's does not implement one. It works on
DataSourceTransactionManager, because a savepoint is a JDBC concept -- shown
working there rather than only failing here.
- Catching a REQUIRED inner failure does not save the transaction. The inner scope
has already marked it rollback-only, so the commit throws
UnexpectedRollbackException from a place with no connection to the cause.
- A checked exception commits, and so does a swallowed one. Those two do not merely
fail to start a transaction; they commit work the code was abandoning.
19 contract tests, six captured transcripts, all regenerated by scripts/run-all.sh.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Gip4srpzMwjgoba6uEfbr5
81 lines
5.5 KiB
Plaintext
81 lines
5.5 KiB
Plaintext
== the propagation matrix ==
|
|
|
|
Each inner method is called twice: once from a @Transactional caller and once from a
|
|
plain one. 'active' is TransactionSynchronizationManager.isActualTransactionActive();
|
|
'name' is the transaction's name, which is how you tell JOINING from STARTING -- a
|
|
joining method reports the OUTER method's name.
|
|
|
|
PROPAGATION CALLER ACTIVE TRANSACTION NAME / OUTCOME
|
|
----------------------------------------------------------------------------
|
|
REQUIRED inside @Transactional True inTransaction
|
|
REQUIRED no transaction True required
|
|
|
|
REQUIRES_NEW inside @Transactional True requiresNew
|
|
REQUIRES_NEW no transaction True requiresNew
|
|
|
|
NESTED inside @Transactional -- NestedTransactionNotSupportedException
|
|
NESTED no transaction True nested
|
|
|
|
SUPPORTS inside @Transactional True inTransaction
|
|
SUPPORTS no transaction False supports
|
|
|
|
NOT_SUPPORTED inside @Transactional False notSupported
|
|
NOT_SUPPORTED no transaction False notSupported
|
|
|
|
MANDATORY inside @Transactional True inTransaction
|
|
MANDATORY no transaction -- IllegalTransactionStateException
|
|
|
|
NEVER inside @Transactional -- IllegalTransactionStateException
|
|
NEVER no transaction False never
|
|
|
|
|
|
Reading it:
|
|
REQUIRED inside a transaction the inner name is the OUTER method -- it joined.
|
|
REQUIRES_NEW the inner name is its own method -- it started a second transaction.
|
|
NESTED fails outright on JpaTransactionManager. See docs/output/03-nested.txt.
|
|
SUPPORTS joins if there is one, runs with none if there is not. No transaction
|
|
is created, so the write below it lands on an auto-commit connection.
|
|
NOT_SUPPORTED suspends the outer transaction: active=False even inside one.
|
|
MANDATORY requires a caller's transaction; IllegalTransactionStateException if none.
|
|
NEVER requires the absence of one; IllegalTransactionStateException if present.
|
|
|
|
== the exact exception messages ==
|
|
NESTED (withOuterTransaction)
|
|
org.springframework.transaction.NestedTransactionNotSupportedException
|
|
Transaction manager does not allow nested transactions by default - specify 'nestedTransactionAllowed' property with value 'true'
|
|
|
|
MANDATORY (withoutOuterTransaction)
|
|
org.springframework.transaction.IllegalTransactionStateException
|
|
No existing transaction found for transaction marked with propagation 'mandatory'
|
|
|
|
NEVER (withOuterTransaction)
|
|
org.springframework.transaction.IllegalTransactionStateException
|
|
Existing transaction found for transaction marked with propagation 'never'
|
|
|
|
== what the transaction manager logged while doing it ==
|
|
|
|
o.s.orm.jpa.JpaTransactionManager: Creating new transaction with name [com.ankurm.tx.service.SilentlyNonTransactional.properlyCalled]: PROPAGATION_REQUIRED,ISOLATION_DEFAULT
|
|
o.s.orm.jpa.JpaTransactionManager: Initiating transaction commit
|
|
o.s.orm.jpa.JpaTransactionManager: Creating new transaction with name [org.springframework.data.jpa.repository.support.SimpleJpaRepository.deleteAll]: PROPAGATION_REQUIRED,ISOLATION_DEFAULT
|
|
o.s.orm.jpa.JpaTransactionManager: Initiating transaction commit
|
|
o.s.orm.jpa.JpaTransactionManager: Creating new transaction with name [com.ankurm.tx.service.SilentlyNonTransactional.checkedExceptionCommits]: PROPAGATION_REQUIRED,ISOLATION_DEFAULT
|
|
o.s.orm.jpa.JpaTransactionManager: Participating in existing transaction
|
|
o.s.orm.jpa.JpaTransactionManager: Initiating transaction commit
|
|
o.s.orm.jpa.JpaTransactionManager: Creating new transaction with name [org.springframework.data.jpa.repository.support.SimpleJpaRepository.existsById]: PROPAGATION_REQUIRED,ISOLATION_DEFAULT,readOnly
|
|
o.s.orm.jpa.JpaTransactionManager: Initiating transaction commit
|
|
o.s.orm.jpa.JpaTransactionManager: Creating new transaction with name [org.springframework.data.jpa.repository.support.SimpleJpaRepository.existsById]: PROPAGATION_REQUIRED,ISOLATION_DEFAULT,readOnly
|
|
o.s.orm.jpa.JpaTransactionManager: Initiating transaction commit
|
|
o.s.orm.jpa.JpaTransactionManager: Creating new transaction with name [com.ankurm.tx.service.SilentlyNonTransactional.swallowsException]: PROPAGATION_REQUIRED,ISOLATION_DEFAULT
|
|
o.s.orm.jpa.JpaTransactionManager: Participating in existing transaction
|
|
o.s.orm.jpa.JpaTransactionManager: Initiating transaction commit
|
|
o.s.orm.jpa.JpaTransactionManager: Creating new transaction with name [org.springframework.data.jpa.repository.support.SimpleJpaRepository.existsById]: PROPAGATION_REQUIRED,ISOLATION_DEFAULT,readOnly
|
|
o.s.orm.jpa.JpaTransactionManager: Initiating transaction commit
|
|
o.s.orm.jpa.JpaTransactionManager: Creating new transaction with name [org.springframework.data.jpa.repository.support.SimpleJpaRepository.existsById]: PROPAGATION_REQUIRED,ISOLATION_DEFAULT,readOnly
|
|
o.s.orm.jpa.JpaTransactionManager: Initiating transaction commit
|
|
o.s.orm.jpa.JpaTransactionManager: Creating new transaction with name [org.springframework.data.jpa.repository.support.SimpleJpaRepository.deleteAll]: PROPAGATION_REQUIRED,ISOLATION_DEFAULT
|
|
o.s.orm.jpa.JpaTransactionManager: Initiating transaction commit
|
|
o.s.orm.jpa.JpaTransactionManager: Creating new transaction with name [com.ankurm.tx.service.OuterService.inTransaction]: PROPAGATION_REQUIRED,ISOLATION_DEFAULT
|
|
o.s.orm.jpa.JpaTransactionManager: Participating in existing transaction
|
|
o.s.orm.jpa.JpaTransactionManager: Participating in existing transaction
|
|
o.s.orm.jpa.JpaTransactionManager: Participating in existing transaction
|