fish.payara.ejb.http.client.adapter

Class CompositeClientAdapter

java.lang.Object

fish.payara.ejb.http.client.adapter.CompositeClientAdapter

All Implemented Interfaces:

ClientAdapter

public final class CompositeClientAdapter
extends Object
implements ClientAdapter

Adapter that allows composing multiple adapter implementations. invokes all registered adapters in order in which they were registered, and returns first non-empty match for a name.

Downstream adapters are registered by constructing a new CompositeClientAdapter.Builder, or method newBuilder()

Downstream adapters can also be customized by decorators provided by ClientAdapterCustomizer, which allows separating name matching from proxy construction in adapters' implementations.

See Also:

ClientAdapterCustomizer

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CompositeClientAdapter.Builder Builder for composite Client Adapter.

Method Summary

Modifier and Type	Method and Description
Optional<Object>	makeLocalProxy(String jndiName, Context remoteContext) Find a client adapter for handling specific jndiName.
static CompositeClientAdapter.Builder	newBuilder() Convenience method for constructing a CompositeClientAdapter.Builder

Methods inherited from class java.lang.Object

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

Method Detail

makeLocalProxy

public Optional<Object> makeLocalProxy(String jndiName,
                                       Context remoteContext)
                                throws NamingException

Find a client adapter for handling specific jndiName. Composite client adapter will attempt invoking ClientAdapter.makeLocalProxy(String, Context) for all registered adapters in order they were registered in. The iteration ends when

1. A registered adapter returns non-empty value; or
2. A registered adapter throws NamingException
3. All adapters are tried and return empty value

Specified by:

makeLocalProxy in interface ClientAdapter

Parameters:

jndiName - JNDI name that is being looked up

remoteContext - EJB HTTP Client naming context for delegating the calls

Returns:

adapter object if any of registered client adapters returns one, Optional.empty() otherwise

Throws:

NamingException - if any of attempted client adapters throws one

newBuilder

public static CompositeClientAdapter.Builder newBuilder()

Convenience method for constructing a CompositeClientAdapter.Builder

Returns:

new builder instance