org.ow2.jasmine.jade.fractal.api.control
Interface ReverseBindingController

All Known Implementing Classes:

BasicReverseBindingControllerMixin

public interface ReverseBindingController

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

Author:

Fabienne Boyer, Noel de palma

Method Summary

void	bindSource(java.lang.String serverItfName, java.lang.Object clientItf) Register a reverse binding.
java.lang.String[]	listSource() Return an array of reverse bindings name of the component to which this controller interface belongs.
java.lang.Object[]	lookupBindingSource(java.lang.String serverItfName) Lookup the reverse bindings of the component to which this controller interface belongs.
void	unbindSource(java.lang.String serverItfName, java.lang.Object clientItf) Unregister a reverse binding.

Method Detail

bindSource

void bindSource(java.lang.String serverItfName,
                java.lang.Object clientItf)
                throws org.objectweb.fractal.api.NoSuchInterfaceException,
                       org.objectweb.fractal.api.control.IllegalBindingException,
                       org.objectweb.fractal.api.control.IllegalLifeCycleException

Register a reverse binding.

Parameters:

serverItfName - the name of a server interface of the component to which this interface belongs.

clientItf - the client interface which is bound to the server interface.

Throws:

org.objectweb.fractal.api.NoSuchInterfaceException - if there is no such client interface.

org.objectweb.fractal.api.control.IllegalBindingException - if the binding cannot be registered.

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

unbindSource

void unbindSource(java.lang.String serverItfName,
                  java.lang.Object clientItf)
                  throws org.objectweb.fractal.api.NoSuchInterfaceException,
                         org.objectweb.fractal.api.control.IllegalBindingException,
                         org.objectweb.fractal.api.control.IllegalLifeCycleException

Unregister a reverse binding.

Parameters:

serverItfName - the name of a server interface of the component to which this interface belongs.

clientItf - the client interface which is bound to the server interface. client itf must implem hashcode & equals method

Throws:

org.objectweb.fractal.api.NoSuchInterfaceException - if there is no such client interface.

org.objectweb.fractal.api.control.IllegalBindingException - if the binding cannot be registered.

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

lookupBindingSource

java.lang.Object[] lookupBindingSource(java.lang.String serverItfName)
                                       throws org.objectweb.fractal.api.NoSuchInterfaceException

Lookup the reverse bindings of the component to which this controller interface belongs.

Parameters:

serverItfName - the name of a server interface of the component to which this controller interface belongs.

Returns:

an array of interfaces bound to the server interface

Throws:

org.objectweb.fractal.api.NoSuchInterfaceException - if there is no such interface.

listSource

java.lang.String[] listSource()

Return an array of reverse bindings name of the component to which this controller interface belongs.

Returns:

an array of String containing bindings name, null if no component is bound to the component this interface belongs.