io.joynr.jeeintegration

Class JeeJoynrServiceLocator

java.lang.Object

io.joynr.jeeintegration.JeeJoynrServiceLocator

All Implemented Interfaces:

ServiceLocator

public class JeeJoynrServiceLocator
extends Object
implements ServiceLocator

JEE integration joynr service locator which uses a joynr proxy to provide an implementation for a service interface. The service interface is mapped to its joynr proxy, by expecting a UsedBy annotation is attached in the class hierarchy of the service interface. With this annotation, the proxy is found by the JeeJoynrServiceLocator.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	JeeJoynrServiceLocator.JeeJoynrServiceProxyBuilder<T>

Nested classes/interfaces inherited from interface io.joynr.jeeintegration.api.ServiceLocator

ServiceLocator.ServiceProxyBuilder<T>

Constructor Summary

Constructors

Constructor and Description
JeeJoynrServiceLocator(JoynrIntegrationBean joynrIntegrationBean)

Method Summary

Modifier and Type	Method and Description
<I> ServiceLocator.ServiceProxyBuilder<I>	builder(Class<I> serviceInterface, String... domains) Create a ServiceLocator.ServiceProxyBuilder for the given service interface and domains.
<I> I	get(Class<I> serviceInterface, Set<String> domains) Obtains a client proxy for multiple services of the given service interface in the given domains.
<I> I	get(Class<I> serviceInterface, Set<String> domains, long ttl) Like #get(Class, Set), but allows you to specify the maximum time-to-live for messages sent to the services.
<I> I	get(Class<I> serviceInterface, Set<String> domains, io.joynr.messaging.MessagingQos messagingQos, io.joynr.arbitration.DiscoveryQos discoveryQos) Like #get(Class, Set), but allows you to specify the messaging and discovery quality of service information to use.
<I> I	get(Class<I> serviceInterface, Set<String> domains, io.joynr.messaging.MessagingQos messagingQos, io.joynr.arbitration.DiscoveryQos discoveryQos, String useCase) Like #get(Class, Set), but allows you to specify the messaging and discovery quality of service information to use, as well as the stateless async use case in order to identify the CallbackHandler bean to use for processing stateless async replies received for requests made from this proxy.
<I> I	get(Class<I> serviceInterface, String domain) Obtains a client proxy for the given service interface in the given domain.
<I> I	get(Class<I> serviceInterface, String domain, long ttl) Like ServiceLocator.get(Class, String), but allows you to specify the maximum time-to-live for messages sent to the service.
<I> I	get(Class<I> serviceInterface, String domain, io.joynr.messaging.MessagingQos messagingQos, io.joynr.arbitration.DiscoveryQos discoveryQos) Like ServiceLocator.get(Class, String), but allows you to specify the messaging and discovery quality of service information to use.

Methods inherited from class java.lang.Object

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

Constructor Detail

JeeJoynrServiceLocator

@Inject
public JeeJoynrServiceLocator(JoynrIntegrationBean joynrIntegrationBean)

Method Detail

get

public <I> I get(Class<I> serviceInterface,
                 String domain)

Description copied from interface: ServiceLocator

Obtains a client proxy for the given service interface in the given domain. Calls ServiceLocator.get(Class, String, MessagingQos, DiscoveryQos) with default values for messaging and discovery quality of service.

Specified by:

get in interface ServiceLocator

Type Parameters:

I - the service type

Parameters:

serviceInterface - the service interface for which to get a client proxy.

domain - the domain in which the service implementation must be available.

Returns:

the client proxy, which can be used to call methods on the service service.

get

public <I> I get(Class<I> serviceInterface,
                 String domain,
                 long ttl)

Description copied from interface: ServiceLocator

Like ServiceLocator.get(Class, String), but allows you to specify the maximum time-to-live for messages sent to the service. Calls ServiceLocator.get(Class, String, MessagingQos, DiscoveryQos), setting the TTL passed in on the messaging quality of service and providing default values for the discovery quality of service.

Specified by:

get in interface ServiceLocator

Type Parameters:

I - the service type

Parameters:

serviceInterface - the service interface for which to get a client proxy.

domain - the domain in which the service implementation must be available.

ttl - the maximum time to live for messages sent via the service. If the time to live expires (the message takes longer to deliver), then an exception is thrown.

Returns:

the client proxy, which can be used to call methods on the service interface.

get

public <I> I get(Class<I> serviceInterface,
                 Set<String> domains)

Description copied from interface: ServiceLocator

Obtains a client proxy for multiple services of the given service interface in the given domains. Calls #get(Class, Set, MessagingQos, DiscoveryQos) with default values for messaging and discovery quality of service.

Specified by:

get in interface ServiceLocator

Type Parameters:

I - the service type

Parameters:

serviceInterface - the BCI interface for which to get a client proxy.

domains - the set of domains in which the service implementations must be available.

Returns:

the client proxy, which can be used to call methods on the BCI service.

get

public <I> I get(Class<I> serviceInterface,
                 Set<String> domains,
                 long ttl)

Description copied from interface: ServiceLocator

Like #get(Class, Set), but allows you to specify the maximum time-to-live for messages sent to the services. Calls #get(Class, Set, MessagingQos, DiscoveryQos), setting the TTL passed in on the messaging quality of service and providing default values for the discovery quality of service.

Specified by:

get in interface ServiceLocator

Type Parameters:

I - the service type

Parameters:

serviceInterface - the BCI interface for which to get a client proxy.

domains - the set of domains in which the service implementations must be available.

ttl - the maximum time to live for messages sent via the service. If the time to live expires (the message takes longer to deliver), then an exception is thrown.

Returns:

the client proxy, which can be used to call methods on the BCI service.

get

public <I> I get(Class<I> serviceInterface,
                 String domain,
                 io.joynr.messaging.MessagingQos messagingQos,
                 io.joynr.arbitration.DiscoveryQos discoveryQos)

Description copied from interface: ServiceLocator

Like ServiceLocator.get(Class, String), but allows you to specify the messaging and discovery quality of service information to use.

Specified by:

get in interface ServiceLocator

Type Parameters:

I - the service type

Parameters:

serviceInterface - the service interface for which to get a client proxy.

domain - the domain in which the service implementation must be available.

messagingQos - the messaging quality of service information (including the time to live value) to use when communicating to the service.

discoveryQos - the discovery quality of service information to use when communicating to the service.

Returns:

the client proxy, which can be used to call methods on the service service.

get

public <I> I get(Class<I> serviceInterface,
                 Set<String> domains,
                 io.joynr.messaging.MessagingQos messagingQos,
                 io.joynr.arbitration.DiscoveryQos discoveryQos)

Description copied from interface: ServiceLocator

Like #get(Class, Set), but allows you to specify the messaging and discovery quality of service information to use.

Specified by:

get in interface ServiceLocator

Type Parameters:

I - the service type

Parameters:

serviceInterface - the BCI interface for which to get a client proxy.

domains - the set of domains in which the service implementations must be available.

messagingQos - the messaging quality of service information (including the time to live value) to use when communicating to the service.

discoveryQos - the discovery quality of service information to use when communicating to the service.

Returns:

the client proxy, which can be used to call methods on the BCI service.

get

public <I> I get(Class<I> serviceInterface,
                 Set<String> domains,
                 io.joynr.messaging.MessagingQos messagingQos,
                 io.joynr.arbitration.DiscoveryQos discoveryQos,
                 String useCase)

Description copied from interface: ServiceLocator

Like #get(Class, Set), but allows you to specify the messaging and discovery quality of service information to use, as well as the stateless async use case in order to identify the CallbackHandler bean to use for processing stateless async replies received for requests made from this proxy.

Specified by:

get in interface ServiceLocator

Type Parameters:

I - the service type

Parameters:

serviceInterface - the BCI interface for which to get a client proxy.

domains - the set of domains in which the service implementations must be available.

messagingQos - the messaging quality of service information (including the time to live value) to use when communicating to the service.

discoveryQos - the discovery quality of service information to use when communicating to the service.

useCase - the name of the use case for identifying the relevant CallbackHandler bean to use for processing stateless async replies received for requests made from this proxy.

Returns:

the client proxy, which can be used to call methods on the BCI service.

builder

public <I> ServiceLocator.ServiceProxyBuilder<I> builder(Class<I> serviceInterface,
                                                         String... domains)

Description copied from interface: ServiceLocator

Create a ServiceLocator.ServiceProxyBuilder for the given service interface and domains.

Specified by:

builder in interface ServiceLocator

Type Parameters:

I - the type of the service interface for which a service proxy builder should be created.

Parameters:

serviceInterface - the service interface for which to create the service proxy builder.

domains - the list of domains which the proxy will use for looking up the services to communicate with. At least one domain must be provided.

Returns:

the ServiceLocator.ServiceProxyBuilder which can be used to setup the configuration with which to build the service proxy.