refactor: replace word transaction to saga (#120)

* refactor: replace word transaction to saga

* build: netx version 0.3.8 to 0.3.9

Author: devxb

README.md

@@ -2,7 +2,7 @@ kotlin.code.style=official
 
 ### Project ###
 group=org.rooftop.netx
-version=0.3.8
+version=0.3.9
 compatibility=17
 
 ### Sonarcloud ###

gradle.properties

@@ -4,14 +4,14 @@ class EncodeException(message: String, throwable: Throwable) : RuntimeException(
 
 class DecodeException(message: String, throwable: Throwable) : RuntimeException(message, throwable)
 
-open class TransactionException(message: String) : RuntimeException(message)
+open class SagaException(message: String) : RuntimeException(message)
 
-class AlreadyCommittedTransactionException(transactionId: String, state: String) :
-    TransactionException("Cannot join transaction cause, transaction \"$transactionId\" already \"$state\"")
+class AlreadyCommittedSagaException(id: String, state: String) :
+    SagaException("Cannot join saga cause, saga \"$id\" already \"$state\"")
 
 class NotFoundDispatchFunctionException(message: String) : RuntimeException(message)
 
-class FailedAckTransactionException(message: String) : RuntimeException(message)
+class FailedAckSagaException(message: String) : RuntimeException(message)
 
 class ResultTimeoutException(message: String, throwable: Throwable) :
     RuntimeException(message, throwable)

src/main/kotlin/org/rooftop/netx/api/Exceptions.kt

@@ -4,19 +4,19 @@ import reactor.core.publisher.Mono
 
 interface Orchestrator<T : Any, V : Any> {
 
-    fun transaction(request: T): Mono<Result<V>>
+    fun saga(request: T): Mono<Result<V>>
 
-    fun transaction(timeoutMillis: Long, request: T): Mono<Result<V>>
+    fun saga(timeoutMillis: Long, request: T): Mono<Result<V>>
 
-    fun transaction(request: T, context: MutableMap<String, Any>): Mono<Result<V>>
+    fun saga(request: T, context: MutableMap<String, Any>): Mono<Result<V>>
 
-    fun transaction(timeoutMillis: Long, request: T, context: MutableMap<String, Any>): Mono<Result<V>>
+    fun saga(timeoutMillis: Long, request: T, context: MutableMap<String, Any>): Mono<Result<V>>
 
-    fun transactionSync(request: T): Result<V>
+    fun sagaSync(request: T): Result<V>
 
-    fun transactionSync(timeoutMillis: Long, request: T): Result<V>
+    fun sagaSync(timeoutMillis: Long, request: T): Result<V>
 
-    fun transactionSync(request: T, context: MutableMap<String, Any>): Result<V>
+    fun sagaSync(request: T, context: MutableMap<String, Any>): Result<V>
 
-    fun transactionSync(timeoutMillis: Long, request: T, context: MutableMap<String, Any>): Result<V>
+    fun sagaSync(timeoutMillis: Long, request: T, context: MutableMap<String, Any>): Result<V>
 }

src/main/kotlin/org/rooftop/netx/api/Orchestrator.kt

@@ -0,0 +1,13 @@
+package org.rooftop.netx.api
+
+class SagaCommitEvent internal constructor(
+    id: String,
+    nodeName: String,
+    group: String,
+    event: String?,
+    codec: Codec,
+) : SagaEvent(id, nodeName, group, event, codec) {
+
+    override fun copy(): SagaCommitEvent =
+        SagaCommitEvent(id, nodeName, group, event, codec)
+}

src/main/kotlin/org/rooftop/netx/api/SagaCommitEvent.kt

@@ -4,7 +4,7 @@ import kotlin.reflect.KClass
 
 @Target(AnnotationTarget.FUNCTION)
 @Retention(AnnotationRetention.RUNTIME)
-annotation class TransactionCommitListener(
+annotation class SagaCommitListener(
     val event: KClass<*> = Any::class,
     val noRollbackFor: Array<KClass<out Throwable>> = [],
 )

…op/netx/api/TransactionCommitListener.kt …g/rooftop/netx/api/SagaCommitListener.ktsrc/main/kotlin/org/rooftop/netx/api/TransactionCommitListener.kt renamed to src/main/kotlin/org/rooftop/netx/api/SagaCommitListener.kt src/main/kotlin/org/rooftop/netx/api/TransactionCommitListener.kt renamed to src/main/kotlin/org/rooftop/netx/api/SagaCommitListener.kt

@@ -2,8 +2,8 @@ package org.rooftop.netx.api
 
 import kotlin.reflect.KClass
 
-sealed class TransactionEvent(
-    val transactionId: String,
+sealed class SagaEvent(
+    val id: String,
     val nodeName: String,
     val group: String,
     internal val event: String?,
@@ -24,5 +24,5 @@ sealed class TransactionEvent(
             type
         )
 
-    internal abstract fun copy(): TransactionEvent
+    internal abstract fun copy(): SagaEvent
 }

…org/rooftop/netx/api/TransactionEvent.kt …kotlin/org/rooftop/netx/api/SagaEvent.ktsrc/main/kotlin/org/rooftop/netx/api/TransactionEvent.kt renamed to src/main/kotlin/org/rooftop/netx/api/SagaEvent.kt src/main/kotlin/org/rooftop/netx/api/TransactionEvent.kt renamed to src/main/kotlin/org/rooftop/netx/api/SagaEvent.kt

@@ -0,0 +1,13 @@
+package org.rooftop.netx.api
+
+class SagaJoinEvent internal constructor(
+    id: String,
+    nodeName: String,
+    group: String,
+    event: String?,
+    codec: Codec,
+) : SagaEvent(id, nodeName, group, event, codec) {
+
+    override fun copy(): SagaJoinEvent =
+        SagaJoinEvent(id, nodeName, group, event, codec)
+}

src/main/kotlin/org/rooftop/netx/api/SagaJoinEvent.kt

@@ -4,7 +4,7 @@ import kotlin.reflect.KClass
 
 @Target(AnnotationTarget.FUNCTION)
 @Retention(AnnotationRetention.RUNTIME)
-annotation class TransactionJoinListener(
+annotation class SagaJoinListener(
     val event: KClass<*> = Any::class,
     val noRollbackFor: Array<KClass<out Throwable>> = [],
     val successWith: SuccessWith = SuccessWith.PUBLISH_JOIN,

…ftop/netx/api/TransactionJoinListener.kt …org/rooftop/netx/api/SagaJoinListener.ktsrc/main/kotlin/org/rooftop/netx/api/TransactionJoinListener.kt renamed to src/main/kotlin/org/rooftop/netx/api/SagaJoinListener.kt src/main/kotlin/org/rooftop/netx/api/TransactionJoinListener.kt renamed to src/main/kotlin/org/rooftop/netx/api/SagaJoinListener.kt

@@ -0,0 +1,43 @@
+package org.rooftop.netx.api
+
+import reactor.core.publisher.Mono
+
+interface SagaManager {
+
+    fun start(): Mono<String>
+
+    fun <T : Any> start(event: T): Mono<String>
+
+    fun syncStart(): String
+
+    fun <T : Any> syncStart(event: T): String
+
+    fun join(id: String): Mono<String>
+
+    fun <T : Any> join(id: String, event: T): Mono<String>
+
+    fun syncJoin(id: String): String
+
+    fun <T : Any> syncJoin(id: String, event: T): String
+
+    fun exists(id: String): Mono<String>
+
+    fun syncExists(id: String): String
+
+    fun commit(id: String): Mono<String>
+
+    fun <T : Any> commit(id: String, event: T): Mono<String>
+
+    fun syncCommit(id: String): String
+
+    fun <T : Any> syncCommit(id: String, event: T): String
+
+    fun rollback(id: String, cause: String): Mono<String>
+
+    fun <T : Any> rollback(id: String, cause: String, event: T): Mono<String>
+
+    fun syncRollback(id: String, cause: String): String
+
+    fun <T : Any> syncRollback(id: String, cause: String, event: T): String
+
+}