chore(spanner): add clirr

Author: harshachinta

google-cloud-spanner/clirr-ignored-differences.xml

@@ -964,4 +964,16 @@
     <className>com/google/cloud/spanner/DatabaseClient</className>
     <method>com.google.cloud.spanner.Statement$StatementFactory getStatementFactory()</method>
   </difference>
+
+  <!-- Add method begin() with AbortedException in TransactionManager and AsyncTransactionManager -->
+  <difference>
+    <differenceType>7012</differenceType>
+    <className>com/google/cloud/spanner/AsyncTransactionManager</className>
+    <method>com.google.cloud.spanner.AsyncTransactionManager$TransactionContextFuture beginAsync(com.google.cloud.spanner.AbortedException)</method>
+  </difference>
+  <difference>
+    <differenceType>7012</differenceType>
+    <className>com/google/cloud/spanner/TransactionManager</className>
+    <method>com.google.cloud.spanner.TransactionContext begin(com.google.cloud.spanner.AbortedException)</method>
+  </difference>
 </differences>

google-cloud-spanner/src/main/java/com/google/cloud/spanner/AsyncTransactionManager.java

@@ -178,6 +178,8 @@ interface AsyncTransactionFunction<I, O> {
    * new transaction for retry attempts. If {@link #resetForRetryAsync()} is not used, you can pass
    * the {@link AbortedException} from a previous attempt here to preserve the transaction's
    * priority.
+   *
+   * <p>For regular sessions, this behaves the same as {@link #beginAsync()}.
    */
   TransactionContextFuture beginAsync(AbortedException exception);
 

google-cloud-spanner/src/main/java/com/google/cloud/spanner/TransactionManager.java

@@ -68,6 +68,8 @@ enum TransactionState {
    * <p>This is especially useful in scenarios involving multiplexed sessions and when creating a
    * new transaction for retry attempts. If {@link #resetForRetry()} is not used, you can pass the
    * {@link AbortedException} from a previous attempt here to preserve the transaction's priority.
+   *
+   * <p>For regular sessions, this behaves the same as {@link #begin()}.
    */
   TransactionContext begin(AbortedException exception);