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.
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.
|
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.
clientItfName
- the name of a client interface of the component to
which this interface belongs.serverItf
- a server interface.
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.
listFc
public String[] listFc()
Returns the names of the client interfaces of the component to which this
interface belongs.
- 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
).
clientItfName
- the name of a client interface of the component to
which this interface belongs.
- the server interface to which the given interface is bound, or
null if it is not bound.
NoSuchInterfaceException
- if the component to which this interface
belongs does not have a client interface whose name is equal to the
given name.