yass2

yass2 (Yet Another Service Solution)

• yass2 is
  • a small Kotlin Multiplatform library
  • for efficient asynchronous/non-blocking Coroutines based peer-to-peer communication
  • enforcing type-safe contracts with interfaces and data transfer objects

                         contract library
                       +-----------------------------------------+
                       | // contract definition                  |
                       | interface Calculator {                  |
                       |   suspend fun add(a: Int, b: Int): Int  |
                       | }                                       |
                       +-----------------------------------------+

  client process                             server process
+----------------------------------+       +----------------------------------------------------+
| // contract usage                |       | // contract implementation                         |
| val calculator: Calculator = ... |       | class CalculatorImpl : Calculator {                |
| println(calculator.add(1, 2))    |       |   override suspend fun add(a: Int, b: Int) = a + b |
|                                  |       | }                                                  |
|..................................|       |....................................................|
|         contract library         |       |                 contract library                   |
|..................................|       |....................................................|
|          yass2 library           |       |                  yass2 library                     |
|..................................|       |....................................................|
|        transport library         | <---> |                transport library                   |
+----------------------------------+       +----------------------------------------------------+

• provides unidirectional and session based bidirectional remoting

• provides Ktor transport adaptors for Http, WebSocket and plain Socket

• Javascript transport uses the Fetch and the WebSocket API instead of Ktor

• provided either with reflection (works only on the JVM platform and is slower) or by generated code (works on any platform and is faster)

  • fast, compact and extendable binary serializer for high throughput and low latency
  • dumper (generic object printer)
  • interceptor (around advice, aspect-oriented programming)
  • remoting (remote proxy and invoker)

• Tutorial

• Open Source (BSD-3-Clause license)

• yass2 has multiple modules with the following dependencies

yass2-core
     ^
     |
     +--- yass2-coroutines ---> kotlinx-coroutines-core
     |         ^
     |         |
     |    yass2-ktor ---> io.ktor
     |
     |
     +--- yass2-reflect ---> kotlin-reflect
               ^
               |
          yass2-generate

• artifacts on Maven Central (GroupId: ch.softappeal.yass2)

• uses Semantic Versioning

• supersedes yass