Skip to content

Stork Programmatic API#

Stork proposes a programmatic API that lets you register new service Definitions and do manual lookup and selection. When using the programmatic API of Stork, you can: Retrieve the singleton Stork instance. This instance is configured with the set of Services it manages. Register new service definition. Retrieve the Service you want to use. Each Service is associated with a name. Retrieve the ServiceInstance, which will provide the metadata to access the actual instance.

Initializing Stork#

If your framework does not already provide a configured Stork instance, you need to do:

1

Adding service dynamically#

To register a new ServiceDefinition, use the defineIfAbsent method:

1

The ServiceDefinition instances can be created from:

  • A service discovery configuration - these classes are provided by the service discovery implementations,
  • An optional load balancer configuration - these classes are provided by the load balancer implementations

Attributes from the service discovery and load balancer can be configured from the Configuration classes.

Looking for service instances#

To list the service instances for a given service, or to select an instance according to the load balancer strategy, use the following code:

1

The lookup and selection methods are returning Uni as these processes are asynchronous.

All in one example#

The following snippet provides an all in one example of the Stork programmatic API:

1