com.lightbend.lagom.javadsl.client.integration

Class LagomClientFactory

Object

com.lightbend.lagom.javadsl.client.integration.LagomClientFactory

All Implemented Interfaces:

java.io.Closeable, AutoCloseable

public class LagomClientFactory
extends Object
implements java.io.Closeable

Factory for creating Lagom service clients. This is designed for use from non Lagom systems. Generally, there should be only one instance of this per system. Additionally, since it holds thread and connection pools, it must be shutdown, by calling the close() method, when no longer needed.

Method Summary

Modifier and Type	Method and Description
void	close() Close all resources associated with this client factory.
static LagomClientFactory	create(String serviceName, ClassLoader classLoader) Create a client factory that uses the given service locator.
<T> T	createClient(Class<T> clientInterface, java.util.Collection<java.net.URI> serviceUris) Create a Lagom service client that uses the given URIs.
<T> T	createClient(Class<T> clientInterface, ServiceLocator serviceLocator) Create a Lagom service client for the given client interface using the given service locator.
<T> T	createClient(Class<T> clientInterface, java.net.URI serviceUri) Create a Lagom service client that uses the given URI.
<T> T	createDevClient(Class<T> clientInterface) Create a Lagom service client that uses the Lagom dev mode service locator to locate the service.
<T> T	createDevClient(Class<T> clientInterface, java.net.URI serviceLocatorUri) Create a Lagom service client that uses the Lagom dev mode service locator to locate the service.

Methods inherited from class Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

createClient

public <T> T createClient(Class<T> clientInterface,
                          ServiceLocator serviceLocator)

Create a Lagom service client for the given client interface using the given service locator.

Parameters:

clientInterface - The client interface for the service.

serviceLocator - The service locator.

Returns:

An implementation of the client interface.

createClient

public <T> T createClient(Class<T> clientInterface,
                          java.net.URI serviceUri)

Create a Lagom service client that uses the given URI.

Parameters:

clientInterface - The client interface for the service.

serviceUri - The URI that the service lives at.

Returns:

An implementation of the client interface.

createClient

public <T> T createClient(Class<T> clientInterface,
                          java.util.Collection<java.net.URI> serviceUris)

Create a Lagom service client that uses the given URIs. The URIs are used in a round robin fashion. No validation is done to verify that a particular URI is still valid.

Parameters:

clientInterface - The client interface for the service.

serviceUris - The URIs that the service lives at. A copy of this collection will be used, so changes to the collection after invoking this have no effect.

Returns:

An implementation of the client interface.

createDevClient

public <T> T createDevClient(Class<T> clientInterface)

Create a Lagom service client that uses the Lagom dev mode service locator to locate the service. This uses the default Lagom service locator port, that is, localhost:8000.

Parameters:

clientInterface - The client interface for the service.

Returns:

An implementation of the client interface.

createDevClient

public <T> T createDevClient(Class<T> clientInterface,
                             java.net.URI serviceLocatorUri)

Create a Lagom service client that uses the Lagom dev mode service locator to locate the service.

Parameters:

clientInterface - The client interface for the service.

serviceLocatorUri - The URI of the Lagom dev mode service locator - usually http://localhost:8000.

Returns:

An implementation of the client interface.

close

public void close()

Close all resources associated with this client factory. This must be invoked when the client factory is no longer needed, otherwise threads and connections will leak.

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface AutoCloseable

create

public static LagomClientFactory create(String serviceName,
                                        ClassLoader classLoader)

Create a client factory that uses the given service locator.

Parameters:

serviceName - The name of this service that is going to be accessing the services created by this factory.

classLoader - The classloader.

Returns:

The client factory.