Package it.tidalwave.util.spi

Class AsSupport

java.lang.Object

it.tidalwave.util.spi.AsSupport

All Implemented Interfaces:

As

public class AsSupport
extends Object
implements As

Version:

$Id$

Author:

Fabrizio Giudici

Nested Class Summary

Nested classes/interfaces inherited from interface it.tidalwave.util.As

As.Defaults, As.NotFoundBehaviour<T>

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AsSupport()	Constructor for use in subclassing.
	AsSupport(Object owner, Object... rolesOrFactories)	Constructor for use in composition.

Method Summary

Modifier and Type	Method	Description
<T> T	as(Class<T> type)	Returns an adapter to this object of the specified type.
<T> T	as(Class<T> type, As.NotFoundBehaviour<T> notFoundBehaviour)	Returns an adapter to this object of the specified type.
<T> Collection<T>	asMany(Class<T> type)	Searches for multiple adapters of the given type and returns them.

Methods inherited from class java.lang.Object

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

Constructor Detail

AsSupport

protected AsSupport()

Constructor for use in subclassing.

AsSupport

public AsSupport(@Nonnull
                 Object owner,
                 @Nonnull
                 Object... rolesOrFactories)

Constructor for use in composition. In addition to the mandatory owner, it's possible to pass a collection of pre-instantiated roles, or instances of RoleFactory that will be invoked to create additional roles.

Parameters:

owner - the owner

rolesOrFactories - a collection of roles or factories for roles

Method Detail

as

@Nonnull
public <T> T as(@Nonnull
                Class<T> type)

Returns an adapter to this object of the specified type. If the implementation can find multiple compliant adapters, only one will be returned.

Specified by:

as in interface As

Returns:

the adapter

as

@Nonnull
public <T> T as(@Nonnull
                Class<T> type,
                @Nonnull
                As.NotFoundBehaviour<T> notFoundBehaviour)

Returns an adapter to this object of the specified type. If the implementation can find multiple compliant adapters, only one will be returned. If no adapter is found, the result provided by the given default behaviour will be returned. First, local roles are probed; then the owner, in case it directly implements the required role; at last, the delegate is invoked.

Specified by:

as in interface As

notFoundBehaviour - the behaviour to apply when an adapter is not found

asMany

@Nonnull
public <T> Collection<T> asMany(@Nonnull
                                Class<T> type)

Searches for multiple adapters of the given type and returns them. The list contains all the relevant local roles, as well as those retrieved by the delegate, in this order.

Specified by:

asMany in interface As

Parameters:

type - the adapter type

Returns:

a collection of adapters, possibly empty