org.objectweb.fractal.julia.control.binding
Class InterceptorBindingMixin

java.lang.Object
  org.objectweb.fractal.julia.control.binding.InterceptorBindingMixin

All Implemented Interfaces:

BindingController

public abstract class InterceptorBindingMixin

extends Object

implements BindingController

Provides output interceptors management to a BindingController. This mixin is only useful for the ContainerBindingControllerMixin, since the CompositeBindingMixin and the OptimizedCompositeBindingMixin already manage interceptors.

Requirements

• the component to which this controller object belongs must provide the Component interface. Moreover this mixin does nothing if the component does not provide interface introspection functions.

Field Summary

Component

_this_weaveableC The weaveableC field required by this mixin.

Method Summary

abstract void	_super_bindFc(String clientItfName, Object serverItf) The bindFc method overriden by this mixin.
abstract Object	_super_lookupFc(String clientItfName) The lookupFc method overriden by this mixin.
abstract void	_super_unbindFc(String clientItfName) The unbindFc method overriden by this mixin.
void	bindFc(String clientItfName, Object serverItf) Gets the interceptor of the given client interface, updates its getFcItfDelegate, and then calls the overriden method with the interceptor as server interface (if there is an interceptor for the client interface).
Object	lookupFc(String clientItfName) Calls the overriden method and returns the corresponding getFcItfDelegate (if the result is an Interceptor).
void	unbindFc(String clientItfName) Gets the interceptor of the given client interface, updates its getFcItfDelegate, and then calls the overriden method (if there is an interceptor for the client interface).

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.objectweb.fractal.api.control.BindingController

listFc

Field Detail

_this_weaveableC

public Component _this_weaveableC

The weaveableC field required by this mixin. This field is supposed to reference the Component interface of the component to which this controller object belongs.

Method Detail

lookupFc

public Object lookupFc(String clientItfName)
                throws NoSuchInterfaceException

Calls the overriden method and returns the corresponding getFcItfDelegate (if the result is an Interceptor).

Specified by:

lookupFc in interface BindingController

Parameters:

clientItfName - the name of a client interface of the component to which this interface belongs.

Returns:

the server interface to which the given interface is bound, or null if it is not bound.

Throws:

NoSuchInterfaceException - if the component to which this interface belongs does not have a client interface whose name is equal to the given name.

bindFc

public void bindFc(String clientItfName,
                   Object serverItf)
            throws NoSuchInterfaceException,
                   IllegalBindingException,
                   IllegalLifeCycleException

Gets the interceptor of the given client interface, updates its getFcItfDelegate, and then calls the overriden method with the interceptor as server interface (if there is an interceptor for the client interface).

Specified by:

bindFc in interface BindingController

Parameters:

clientItfName - the name of a client interface of the component to which this interface belongs.

serverItf - a server interface.

Throws:

NoSuchInterfaceException - if there is no such client interface.

IllegalBindingException - if the binding cannot be created.

IllegalLifeCycleException - if this component has a LifeCycleController interface, but it is not in an appropriate state to perform this operation.

unbindFc

public void unbindFc(String clientItfName)
              throws NoSuchInterfaceException,
                     IllegalBindingException,
                     IllegalLifeCycleException

Gets the interceptor of the given client interface, updates its getFcItfDelegate, and then calls the overriden method (if there is an interceptor for the client interface).

Specified by:

unbindFc in interface BindingController

Parameters:

clientItfName - the name of a client interface of the component to which this interface belongs.

Throws:

NoSuchInterfaceException - if there is no such client interface.

IllegalBindingException - if the binding cannot be removed.

IllegalLifeCycleException - if this component has a LifeCycleController interface, but it is not in an appropriate state to perform this operation.

_super_lookupFc

public abstract Object _super_lookupFc(String clientItfName)
                                throws NoSuchInterfaceException

The lookupFc method overriden by this mixin.

Parameters:

clientItfName - the name of a client interface of the component to which this interface belongs.

Returns:

the server interface to which the given interface is bound, or null if it is not bound.

Throws:

NoSuchInterfaceException - if the component to which this interface belongs does not have a client interface whose name is equal to the given name.

_super_bindFc

public abstract void _super_bindFc(String clientItfName,
                                   Object serverItf)
                            throws NoSuchInterfaceException,
                                   IllegalBindingException,
                                   IllegalLifeCycleException

The bindFc method overriden by this mixin.

Parameters:

clientItfName - the name of a client interface of the component to which this interface belongs.

serverItf - a server interface.

Throws:

NoSuchInterfaceException - if there is no such client interface.

IllegalBindingException - if the binding cannot be created.

IllegalLifeCycleException - if this component has a LifeCycleController interface, but it is not in an appropriate state to perform this operation.

_super_unbindFc

public abstract void _super_unbindFc(String clientItfName)
                              throws NoSuchInterfaceException,
                                     IllegalBindingException,
                                     IllegalLifeCycleException

The unbindFc method overriden by this mixin.

Parameters:

clientItfName - the name of a client interface of the component to which this interface belongs.

Throws:

NoSuchInterfaceException - if there is no such client interface.

IllegalBindingException - if the binding cannot be removed.

IllegalLifeCycleException - if this component has a LifeCycleController interface, but it is not in an appropriate state to perform this operation.