extended transaction management doc

Author: sterlp

README.md

@@ -88,14 +88,29 @@ public class BuildVehicleTask implements SpringBeanTask<Vehicle> {
 }
 ```
 
+Consider setting a timeout to the `TransactionTemplate`:
+
+```java
+@Bean
+TransactionTemplate transactionTemplate(PlatformTransactionManager transactionManager) {
+    TransactionTemplate template = new TransactionTemplate(transactionManager);
+    template.setTimeout(10);
+    return template;
+}
+```
+
 ### As a closure
 
-Note: this example has no aspects as above the spring _@Transactional_
+Simple task will use defaults:
+
+- Not a transactional task, e.g. HTTP calls
+- 4 executions, one regular and 3 retries, linear
+- using minutes with an offset of 1 which is added to now
 
 ```java
 @Bean
-SpringBeanTask<Vehicle> task1(VehicleRepository vehicleRepository) {
-    return v -> vehicleRepository.save(v);
+SpringBeanTask<Vehicle> task1(VehicleHttpConnector vehicleHttpConnector) {
+    return v -> vehicleHttpConnector.send(v);
 }
 ```
 

core/src/main/java/org/sterl/spring/persistent_tasks/api/RetryStrategy.java

@@ -64,7 +64,7 @@ default OffsetDateTime retryAt(int executionCount, @Nullable Exception exception
      * @author Your Name
      */
     @RequiredArgsConstructor
-    public class LinearRetryStrategy implements RetryStrategy {
+    class LinearRetryStrategy implements RetryStrategy {
         private final int maxExecutionCount;
         private final TemporalUnit unit;
         private final int offset;
@@ -97,7 +97,7 @@ public OffsetDateTime retryAt(int executionCount, Exception error) {
      * ({@code maxExecutionCount}) is reached.</p>
      */
     @RequiredArgsConstructor
-    public class MultiplicativeRetryStrategy implements RetryStrategy {
+    class MultiplicativeRetryStrategy implements RetryStrategy {
         private final int maxExecutionCount;
         private final TemporalUnit unit;
         private final int scalingFactor;

core/src/test/java/org/sterl/spring/persistent_tasks/AbstractSpringTest.java

@@ -15,6 +15,7 @@
 import org.springframework.context.annotation.Configuration;
 import org.springframework.context.annotation.Primary;
 import org.springframework.stereotype.Component;
+import org.springframework.transaction.PlatformTransactionManager;
 import org.springframework.transaction.support.TransactionTemplate;
 import org.sterl.spring.persistent_tasks.api.SpringBeanTask;
 import org.sterl.spring.persistent_tasks.api.TaskId;
@@ -28,6 +29,7 @@
 import org.sterl.spring.persistent_tasks.trigger.model.TriggerEntity;
 import org.sterl.spring.sample_app.SampleApp;
 import org.sterl.test.AsyncAsserts;
+import org.sterl.test.HibernateAsserts;
 
 import jakarta.persistence.EntityManager;
 import lombok.RequiredArgsConstructor;
@@ -75,6 +77,13 @@ AsyncAsserts asserts() {
             return new AsyncAsserts();
         }
 
+        @Bean
+        TransactionTemplate transactionTemplate(PlatformTransactionManager transactionManager) {
+            TransactionTemplate template = new TransactionTemplate(transactionManager);
+            template.setTimeout(10);
+            return template;
+        }
+        
         @Bean
         HibernateAsserts hibernateAsserts(EntityManager entityManager) {
             return new HibernateAsserts(entityManager);

core/src/test/java/org/sterl/spring/persistent_tasks/HibernateAsserts.java renamed to core/src/test/java/org/sterl/test/HibernateAsserts.java

@@ -1,4 +1,4 @@
-package org.sterl.spring.persistent_tasks;
+package org.sterl.test;
 
 import static org.junit.jupiter.api.Assertions.fail;