Skip to content

Commit 3d55bed

Browse files
authored
docs(retries): add a note about implicit transaction (#1688)
This update adds a note about implicit transaction to `RetryableException`.
1 parent a02447f commit 3d55bed

File tree

1 file changed

+9
-1
lines changed

1 file changed

+9
-1
lines changed

driver/src/main/java/org/neo4j/driver/exceptions/RetryableException.java

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,10 +16,18 @@
1616
*/
1717
package org.neo4j.driver.exceptions;
1818

19+
import org.neo4j.driver.Session;
20+
1921
/**
2022
* A marker interface for retryable exceptions.
2123
* <p>
22-
* This indicates whether an operation that resulted in retryable exception is worth retrying.
24+
* This indicates whether an operation that resulted in retryable exception might be resolved by retrying.
25+
* <p>
26+
* <b>Note</b> that some database requests executed via implicit transaction API (like, {@link Session#run(String)}),
27+
* might not be idempotent irrispective of this marker interface as its main focus is on the error type and not
28+
* individual database request. An example of such database request is
29+
* <a href="https://neo4j.com/docs/cypher-manual/current/subqueries/subqueries-in-transactions/">CALL {} IN TRANSACTIONS</a>.
30+
*
2331
* @since 5.0
2432
*/
2533
public interface RetryableException {}

0 commit comments

Comments
 (0)