PortableGroup::FactoryRegistry Interface Reference

import "PortableGroup.idl";

List of all members.

Public Member Functions

void register_factory (in RoleName role, in _TypeId type_id, in FactoryInfo factory_info) raises (MemberAlreadyPresent, TypeConflict)
void unregister_factory (in RoleName role, in Location the_location) raises (MemberNotFound)
void unregister_factory_by_role (in RoleName role)
void unregister_factory_by_location (in Location the_location)
FactoryInfos list_factories_by_role (in RoleName role, out _TypeId type_id)
FactoryInfos list_factories_by_location (in Location the_location)


Detailed Description

Interface to allow generic factories for replicas to register themselves. Factories are distinguished by the role to be played by the created-object (role) and the location at which they create the object (FactoryInfo.the_location)

Because this is an extension to the FT CORBA specification applications that wish to adhere to the specification as written should use the type id as the role name when interacting with the FactoryRegistry.


Member Function Documentation

FactoryInfos PortableGroup::FactoryRegistry::list_factories_by_location in Location  the_location  ) 
 

List all the factories that create a objects at a given location. If no factories are registered for this location, an empty list is returned. This is not an error.

Parameters:
location where the factories create objects.

FactoryInfos PortableGroup::FactoryRegistry::list_factories_by_role in RoleName  role,
out _TypeId  type_id
 

List all the factories that create objects that fill a given role If the role is unknown, an empty list is returned. This is not an error.

Parameters:
role the type of object the factories create.
type_id what type of object is created to fill this role.

void PortableGroup::FactoryRegistry::register_factory in RoleName  role,
in _TypeId  type_id,
in FactoryInfo  factory_info
raises (MemberAlreadyPresent, TypeConflict)
 

register a factory to create objects of the given type at the location given in the FactoryInfo.

Parameters:
role the role the object-to-be-created plays.
type_id type id of the object-to-be-created.
factory_info information about the factory including its location.
Exceptions:
MemberAlreadyPresent if there is already a factory for this type of object at this location.
TypeConflict if the specified type_id is different from the type_id previously registered for this role.

void PortableGroup::FactoryRegistry::unregister_factory in RoleName  role,
in Location  the_location
raises (MemberNotFound)
 

Remove the registration of a factory.

Parameters:
role the role played by the object formerly created by this factory.
location where the factory formerly created objects.
Exceptions:
MemberNotPresent if no factory is available for the given role at this location.

void PortableGroup::FactoryRegistry::unregister_factory_by_location in Location  the_location  ) 
 

Remove the registration of all factories that create objects at a particular location. If the location is unknown the registry is unchanged. This is not an error.

Parameters:
location where the factories formerly created objects.

void PortableGroup::FactoryRegistry::unregister_factory_by_role in RoleName  role  ) 
 

Remove the registration of all factories that create a particular type of object. If no factories exist for the given type, the registry is unchanged. This is not an error.

Parameters:
type_id the type of object formerly created by the factories to be unregistered.


The documentation for this interface was generated from the following file:
Generated on Wed Nov 23 16:35:19 2005 for TAO_PortableGroup by  doxygen 1.4.5