Clarify ReactiveTransactionManager
exception declarations
#30817
Labels
in: data
Issues in data modules (jdbc, orm, oxm, tx)
status: backported
An issue that has been backported to maintenance branches
type: documentation
A documentation task
Milestone
By design,
ReactiveTransactionManager
uses javadoc@throws
clauses for indicating the exceptions that it propagates through the reactive pipeline returned from its methods. Unfortunately it also inherited Java method signaturethrows TransactionException
declarations fromPlatformTransactionManager
which do not add anything to the signature here sinceTransactionException
is aRuntimeException
, and those declarations actually do not give a correct indication since theReactiveTransactionManager
methods are not expected to actually throw that exception type in a traditional sense. As a consequence, we'll drop thosethrows
declarations from the method signature but keep the javadoc@throws
indications around, in theReactiveTransactionManager
interface as well as theAbstractReactiveTransactionManager
base class.Also, along the lines of #30802,
R2dbcTransactionManager
actually propagatesR2dbcException
(aDataAccessException
subclass) fromcommit
/rollback
which we should support in theReactiveTransactionManager
javadoc as well.The text was updated successfully, but these errors were encountered: