sk.stuba.fiit.perconik.core.services.resources

Class ForwardingResourceManager

java.lang.Object

com.google.common.collect.ForwardingObject

sk.stuba.fiit.perconik.core.ForwardingNameable

sk.stuba.fiit.perconik.core.services.ForwardingManager

sk.stuba.fiit.perconik.core.services.resources.ForwardingResourceManager

All Implemented Interfaces:

Nameable, Manager, ResourceManager

public abstract class ForwardingResourceManager
extends ForwardingManager
implements ResourceManager

A resource manager which forwards all its method calls to another resource manager. Subclasses should override one or more methods to modify the behavior of the backing resource manager as desired per the decorator pattern.

Note that this class does not forward the equals and hashCode methods through to the backing object. See ForwardingObject for more details.

Since:

1.0

Author:

Pavol Zbell

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ForwardingResourceManager() Constructor for use by subclasses.

Method Summary

Modifier and Type	Method and Description
<L extends Listener> java.util.Set<Resource<? extends L>>	assignables(java.lang.Class<L> type) Returns a set of resources assignable to the specified listener type.
protected abstract ResourceManager	delegate()
<L extends Listener> void	register(java.lang.Class<L> type, Resource<? super L> resource) Registers a resource with the given listener type.
<L extends Listener> java.util.Set<Resource<? super L>>	registrables(java.lang.Class<L> type) Returns a set of resources registrable with the specified listener type.
com.google.common.collect.SetMultimap<java.lang.Class<? extends Listener>,Resource<?>>	registrations() Returns a set multimap of listener types to all registered resources.
<L extends Listener> void	unregister(java.lang.Class<L> type, Resource<? super L> resource) Unregisters a resource with the given listener type.
<L extends Listener> void	unregisterAll(java.lang.Class<L> type) Unregisters all resources assignable to the specified listener type.

Methods inherited from class sk.stuba.fiit.perconik.core.ForwardingNameable

getName

Methods inherited from class com.google.common.collect.ForwardingObject

toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface sk.stuba.fiit.perconik.core.services.resources.ResourceManager

equals, hashCode, registered

Methods inherited from interface sk.stuba.fiit.perconik.core.Nameable

getName

Constructor Detail

ForwardingResourceManager

protected ForwardingResourceManager()

Constructor for use by subclasses.

Method Detail

delegate

protected abstract ResourceManager delegate()

Specified by:

delegate in class ForwardingManager

register

public <L extends Listener> void register(java.lang.Class<L> type,
                                          Resource<? super L> resource)

Description copied from interface: ResourceManager

Registers a resource with the given listener type. Resource registration hooks are properly invoked during the registration process.

Note that this method propagates any exception thrown by the specified resource as a cause of a ResourceRegistrationException instance.

Specified by:

register in interface ResourceManager

Parameters:

type - the listener type with which the specified resource is to be registered, not null

resource - the resource to be registered with the specified listener type, not null

unregister

public <L extends Listener> void unregister(java.lang.Class<L> type,
                                            Resource<? super L> resource)

Description copied from interface: ResourceManager

Unregisters a resource with the given listener type. Resource unregistration hooks are properly invoked during the unregistration process.

Note that this method propagates any exception thrown by the specified resource as a cause of a ResourceUnregistrationException instance.

Specified by:

unregister in interface ResourceManager

Parameters:

type - the listener type with which the specified resource is to be unregistered, not null

resource - the resource to be unregistered from the specified listener type, not null

unregisterAll

public <L extends Listener> void unregisterAll(java.lang.Class<L> type)

Description copied from interface: ResourceManager

Unregisters all resources assignable to the specified listener type. A resource is assignable to a given listener type if the listener type supported by the resource is assignable to the given listener type. Resource unregistration hooks are properly invoked for all matched resources during the unregistration process.

Note that this method collects all exceptions thrown by resources during the unregistration process and propagates them as suppressed exceptions of a ResourceUnregistrationException instance.

Specified by:

unregisterAll in interface ResourceManager

Parameters:

type - the listener type to which the assignable resources are going be unregistered, not null

assignables

public <L extends Listener> java.util.Set<Resource<? extends L>> assignables(java.lang.Class<L> type)

Description copied from interface: ResourceManager

Returns a set of resources assignable to the specified listener type.

A resource is assignable to a given listener type if the listener type supported by the resource is assignable to the given listener type.

Specified by:

assignables in interface ResourceManager

registrables

public <L extends Listener> java.util.Set<Resource<? super L>> registrables(java.lang.Class<L> type)

Description copied from interface: ResourceManager

Returns a set of resources registrable with the specified listener type.

A resource is registrable with a given listener type if the listener type supported by the resource is equal to the given listener type or one of its superinterfaces.

Specified by:

registrables in interface ResourceManager

registrations

public com.google.common.collect.SetMultimap<java.lang.Class<? extends Listener>,Resource<?>> registrations()

Description copied from interface: ResourceManager

Returns a set multimap of listener types to all registered resources.

Specified by:

registrations in interface ResourceManager