org.objectweb.fractal.api.control
Interface BindingController

public interface BindingController

A component interface to control the bindings of the component to which it belongs. It is implicitely assumed here that the component's type system makes a distinction between "client" and "server" interfaces.

Method Summary

void	bindFc(String clientItfName, Object serverItf) Binds the client interface whose name is given to a server interface.
String[]	listFc() Returns the names of the client interfaces of the component to which this interface belongs.
Object	lookupFc(String clientItfName) Returns the interface to which the given client interface is bound.
void	unbindFc(String clientItfName) Unbinds the given client interface.

Method Detail

listFc

public String[] listFc()

Returns the names of the client interfaces of the component to which this interface belongs.

Returns:

the names of the client interfaces of the component to which this interface belongs.

lookupFc

public Object lookupFc(String clientItfName)
                throws NoSuchInterfaceException

Returns the interface to which the given client interface is bound. More precisely, returns the server interface to which the client interface whose name is given is bound. This server interface is necessarily in the same address space as the client interface (see bindFc).

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

Binds the client interface whose name is given to a server interface. More precisely, binds the client interface of the component to which this interface belongs, and whose name is equal to the given name, to the given server interface. The given server interface must be in the same address space as the client interface.

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

Unbinds the given client interface. More precisely, unbinds the client interface of the component to which this interface belongs, and whose name is equal to the given name.

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.