hello-world

Orbit
Search…
Orbit
README
hello-world
In this guide we’ll cover how to get a very simple Orbit application running in the form of “Hello World”. It shows using a single-module in a single-process environment, often useful for development purposes. This will demonstrate how to set up an Actor and communicate with an Orbit Server.
This tutorial assumes that you have set up a development environment as described in the Getting Started Prerequisites document and have some familiarity with Gradle based Kotlin projects. All samples are in Kotlin, the language in which Orbit is developed, but the principles work for a Java app as well.
Gradle Project
The first step is to set up a Gradle project and pull in the Orbit dependencies.
1
implementation("cloud.orbit:orbit-client:{{< release >}}")
Copied!
Actor Interface
In Orbit all actors must have an interface, below we’ll create a very simple actor interface.
greeter.kt
1
package orbit.hello
2
​
3
import orbit.client.actor.ActorWithStringKey
4
​
5
interface Greeter : ActorWithStringKey {
6
    suspend fun sayHello(): String
7
}
Copied!
Actor interfaces are standard Kotlin interfaces with special constraints
All Actor interfaces must extend an Actor type
All interface methods must return a future in the form of a Deferred or be a suspending Kotlin method
The return type must be serializable or Unit.
Actor Implementation
Once you have an actor interface in place, the final step to complete the actor is to create an actor implementation.
greeterImpl.kt
1
package orbit.hello
2
​
3
import orbit.client.actor.AbstractActor
4
​
5
class GreeterImpl : AbstractActor(), Player {
6
{
7
    override suspend fun sayHello(greeting: String): String {
8
    {
9
        println("Here: ${greeting}")
10
        return "You said: '${greeting}', I say: 'Hello from ${context.reference.key} at node ${context.client.nodeId?.key}!'")
11
    }
12
}
Copied!
An actor implementation is a standard Kotlin or Java class
Extending AbstractActor grants access to the context with a reference to client and the actor's address
The actor must implement an actor interface
Only one actor implementation per actor interface is permitted
Using The Actor
The final step to get a working example is for us to actually use the actor.
app.kt
1
package orbit.hello
2
​
3
import kotlinx.coroutines.runBlocking
4
import orbit.client.OrbitClient
5
import orbit.client.OrbitClientConfig
6
​
7
fun main() {
8
    runBlocking {
9
        val orbitClient = OrbitClient(
10
            OrbitClientConfig(
11
                namespace = "hello",
12
                grpcEndpoint = "dns:///localhost:50056/"
13
            )
14
        )
15
​
16
        orbitClient.start().join()
17
​
18
        val greeter = orbitClient.actorFactory.createProxy(Greeter::class.java, "Tim");
19
        val response = greeter.sayHello("Welcome to Orbit");
20
​
21
        println(response)
22
​
23
        orbitClient.stop().join()
24
    }
25
}
Copied!
We create an orbit client instance in our namespace "hello"
We get a reference to an actor
The framework will handle the activation of the actor.
You can communicate with the actor without knowing it's status.
Running Orbit Server
Assure Docker Desktop is running and Docker Compose is installed from the Prerequisites step.
In a terminal window, run the following.
```shell script
docker run -it -p 50056:50056 orbitframework/orbit: Listening for transport dt_socket at address: 5005 [main] INFO orbit.application.impl.SettingsLoader - Searching for Orbit Settings... [main] INFO orbit.application.impl.SettingsLoader - No settings found. Using defaults. [main] INFO orbit.server.mesh.local.LocalMeterRegistry - Starting simple meter registry [orbit-cpu-1] INFO orbit.server.OrbitServer - Starting Orbit server... [orbit-cpu-1] INFO orbit.server.OrbitServer - Lease expirations: Addressable: 600s, Node: 10s [orbit-cpu-1] INFO orbit.server.pipeline.Pipeline - Started a rail worker with 32 rails and a 10000 entry buffer. [orbit-cpu-1] INFO orbit.server.mesh.LocalNodeInfo - Joined cluster as (NodeId(key=aFmxt6MWvWP5HihR, namespace=management)) [orbit-cpu-1] INFO orbit.server.service.GrpcEndpoint - Starting gRPC Endpoint on LocalServerInfo(port=50056, url=localhost:50056).port... [orbit-cpu-1] INFO orbit.server.service.GrpcEndpoint - gRPC Endpoint started on LocalServerInfo(port=50056, url=localhost:50056).port. [orbit-cpu-1] INFO orbit.server.OrbitServer - Orbit server started successfully in 338ms. ```
Running
You should now be able to run the project. If everything has gone well, you should see output similar to the following:
1
Connecting to Orbit at dns:///localhost:50056/
2
Here: Welcome to Orbit
3
You said: 'Welcome to Orbit!', I say: Hello from Tim at node aFmxt6MWvWP5HihR!
Copied!
Congratulations, you have created your first Orbit application!
migration-from-1.x
_index
Last modified 5mo ago
Copy link
Contents