sk.stuba.fiit.perconik.core

Class ForwardingResource<L extends Listener>

java.lang.Object

com.google.common.collect.ForwardingObject

sk.stuba.fiit.perconik.core.ForwardingRegistrable

sk.stuba.fiit.perconik.core.ForwardingResource<L>

All Implemented Interfaces:

Nameable, Registrable, Resource<L>

public abstract class ForwardingResource<L extends Listener>
extends ForwardingRegistrable
implements Resource<L>

A resource which forwards all its method calls to another resource. Subclasses should override one or more methods to modify the behavior of the backing resource 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

See Also:

Resource

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
protected abstract Resource<L>	delegate()
java.lang.String	getName() Returns a fully qualified name of this resource.
void	register(L listener) Registers a listener to this resource.
<U extends Listener> java.util.Collection<U>	registered(java.lang.Class<U> type) Returns all registered listeners assignable to the specified listener type.
boolean	registered(Listener listener) Determines whether the specified listener is registered to this resource.
void	unregister(L listener) Unregisters a listener from this resource.

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

postRegister, postUnregister, preRegister, preUnregister

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.Resource

equals, hashCode

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

postRegister, postUnregister, preRegister, preUnregister

Constructor Detail

ForwardingResource

protected ForwardingResource()

Constructor for use by subclasses.

Method Detail

delegate

protected abstract Resource<L> delegate()

Specified by:

delegate in class ForwardingRegistrable

register

public void register(L listener)

Description copied from interface: Resource

Registers a listener to this resource.

Warning: Does not invoke listener registration hooks. Only ListenerManager.register(Listener) is responsible for proper hook method invocation during the registration process.

Specified by:

register in interface Resource<L extends Listener>

Parameters:

listener - the listener to be registered, not null

unregister

public void unregister(L listener)

Description copied from interface: Resource

Unregisters a listener from this resource.

Warning: Does not invoke listener unregistration hooks. Only ListenerManager.unregister(Listener) is responsible for proper hook method invocation during the unregistration process.

Specified by:

unregister in interface Resource<L extends Listener>

Parameters:

listener - the listener to be unregistered, not null

registered

public <U extends Listener> java.util.Collection<U> registered(java.lang.Class<U> type)

Description copied from interface: Resource

Returns all registered listeners assignable to the specified listener type. A listener is assignable to a listener type if it is an instance of that type.

Specified by:

registered in interface Resource<L extends Listener>

Parameters:

type - the listener type of the registered listeners, not null

registered

public boolean registered(Listener listener)

Description copied from interface: Resource

Determines whether the specified listener is registered to this resource.

Specified by:

registered in interface Resource<L extends Listener>

Parameters:

listener - the listener to be checked, not null

Returns:

true if the specified listener is registered to this resource, false otherwise

getName

public java.lang.String getName()

Description copied from interface: Resource

Returns a fully qualified name of this resource.

Specified by:

getName in interface Nameable

Specified by:

getName in interface Resource<L extends Listener>

Returns:

the fully qualified name