gov.cca.ports.ServiceProvider Interface Reference

ServiceProvider interface implements a non-singleton service Port. More...

Inheritance diagram for gov.cca.ports.ServiceProvider:

Inheritance graph
[legend]
Collaboration diagram for gov.cca.ports.ServiceProvider:

Collaboration graph
[legend]

List of all members.

Public Member Functions

string createService (in string portType) throws cca.CCAException
 Create the Port for the Service, informing the framework through "addProvidesPort()" on the originating component.
void destroyService (in string portName) throws cca.CCAException
 Informs the originating component that the instance of the provided service is no longer needed.


Detailed Description

ServiceProvider interface implements a non-singleton service Port.

It is a port type that can be exported as normal or to the framework exclusively by using the ServiceRegistry port. This is the Port interface that is implemented by a component wishing to provide a service for other components. The behavior is as follows:

1. The component registers for a ServiceRegistry Port (above) and does a "getPort()" to get it.

2. It adds a ServiceProvider Port to the ServiceRegistry.

3. When called the component's implementation of ServiceProvider.createService() must create the Port asked for, and addProvidesPort to register it on the component. createService() returns the Port instance name for this Port just provided.

4. The framework connects the originating component to the component requesting the service.


Member Function Documentation

string gov.cca.ports.ServiceProvider.createService ( in string  portType  )  throws cca.CCAException

Create the Port for the Service, informing the framework through "addProvidesPort()" on the originating component.

Returns:
the name of the port created.

void gov.cca.ports.ServiceProvider.destroyService ( in string  portName  )  throws cca.CCAException

Informs the originating component that the instance of the provided service is no longer needed.

The ServiceProvider can now safely removePort on the named port.


The documentation for this interface was generated from the following file:

Generated on Mon Sep 14 18:29:47 2009 for cca-spec-babel by  doxygen 1.5.9