Testing your Java and Kotlin services with the Restate SDK is straightforward and efficient. The SDK provides a comprehensive testing module that simplifies integration and service validation.

Getting Started with SDK Testing

To begin testing your services, you'll need to add the SDK testing module to your project. Include the following dependency in your build configuration:

implementation("dev.restate:sdk-testing:2.1.0")

Using JUnit 5 Extension

The Restate SDK offers a JUnit 5 extension that automatically sets up a test environment for your services. Here are examples in both Java and Kotlin:

@RestateTest
class GreeterTest {
    @BindService
    GreeterService greeterService = new GreeterService();
}

@RestateTest
class GreeterTest {
    @BindService
    val greeterService = GreeterService()
}

The extension creates a single server for the entire test class, simplifying your testing setup.

Writing Test Methods

You can inject a Restate client to interact with your registered services. Here are sample test implementations:

@Test
void testGreet(@RestateClient IngressClient client) {
    var greeterServiceClient = GreeterServiceClient.fromClient(client);
    String response = client.greet("Francesco");
    assertEquals(response, "Hello, Francesco!");
}

@Test
fun testGreet(ingressClient: IngressClient) {
    val greeterServiceClient = GreeterServiceClient.fromClient(ingressClient)
    val response = ingressClient.greet("Francesco")
    assertEquals(response, "Hello, Francesco!")
}

Alternative Testing Approach

If you're not using JUnit 5, you can utilize the `RestateRunner` directly. Check the JavaDocs for specific implementation details.