Interface OCI::ConFactoryRegistry

interface ConFactoryRegistry

A registry for Connector factories.

See Also:
Connector
ConFactory


Operation Index

add_factory
Adds a Connector factory to the registry.
equivalent
Checks whether two IORs are equivalent.
get_factories
Returns a sequence of all registered Connector factories.
get_factory
Returns a suitable Connector factory for an IOR.
get_factory_with_policies
Returns a suitable Connector factory for an IOR.
hash
Calculates an hash value for an IOR.

Operations

add_factory
void add_factory(in ConFactory factory);

Adds a Connector factory to the registry.

Parameters:
factory - The Connector factory to add.

equivalent
boolean equivalent(in IOR ior1,
                   in IOR ior2);

Checks whether two IORs are equivalent. It calls the equivalent operation of all registered Connector factories. Two IORs are considered equivalent, if all these calls return TRUE.

Parameters:
ior1 - The first IOR to check for equivalence.
ior2 - The second IOR to check for equivalence.
Returns:
TRUE if the IORs are equivalent, FALSE otherwise.

get_factories
ConFactorySeq get_factories();

Returns a sequence of all registered Connector factories.

Returns:
A sequence with all registered Connector factories.

get_factory
ConFactory get_factory(in IOR ior);

Returns a suitable Connector factory for an IOR.

Parameters:
ior - The IOR to for which a Connector factory is requested.
Returns:
The Connector factory. A nil object reference is returned if no Connector factory is registered which is able to create a Connector for the given IOR.

get_factory_with_policies
ConFactory get_factory_with_policies(in IOR ior,
                                     in CORBA::PolicyList policies);

Returns a suitable Connector factory for an IOR. The Connector factory returned must satisfy a list of policies.

Parameters:
ior - The IOR for which a Connector factory is requested.
policies - The list of policies which have to be satisfied.
Returns:
The Connector factory. A nil object reference is returned if no Connector factory is registered which is able to create a Connector for the given IOR with the given list of policies.

hash
unsigned long hash(in IOR ior,
                   in unsigned long maximum);

Calculates an hash value for an IOR. This hash value is based on the return values of the hash operations of all registered Connector factories.

Parameters:
ior - The IOR to calculate an hash value for.
maximum - The maximum hash value that is allowed.
Returns:
The hash value.


Generated by the ORBacus IDL-to-HTML translator (non-commercial)