Ice 3.7 C++11 API Reference
|
A value factory manager maintains a collection of value factories. More...
#include <Ice/Ice.h>
Public Member Functions | |
virtual void | add (ValueFactory factory, const ::std::string &id)=0 |
Add a value factory. More... | |
virtual ::Ice::ValueFactory | find (const ::std::string &id) const noexcept=0 |
Find an value factory registered with this communicator. More... | |
virtual | ~ValueFactoryManager () |
A value factory manager maintains a collection of value factories.
An application can supply a custom implementation during communicator initialization, otherwise Ice provides a default implementation.
|
virtual |
|
pure virtual |
Add a value factory.
Attempting to add a factory with an id for which a factory is already registered throws AlreadyRegisteredException.
When unmarshaling an Ice value, the Ice run time reads the most-derived type id off the wire and attempts to create an instance of the type using a factory. If no instance is created, either because no factory was found, or because all factories returned nil, the behavior of the Ice run time depends on the format with which the value was marshaled:
If the value uses the "sliced" format, Ice ascends the class hierarchy until it finds a type that is recognized by a factory, or it reaches the least-derived type. If no factory is found that can create an instance, the run time throws NoValueFactoryException.
If the value uses the "compact" format, Ice immediately raises NoValueFactoryException.
The following order is used to locate a factory for a type:
The Ice run-time looks for a factory registered specifically for the type.
If no instance has been created, the Ice run-time looks for the default factory, which is registered with an empty type id.
If no instance has been created by any of the preceding steps, the Ice run-time looks for a factory that may have been statically generated by the language mapping for non-abstract classes.
factory | The factory to add. |
id | The type id for which the factory can create instances, or an empty string for the default factory. |
|
pure virtualnoexcept |
Find an value factory registered with this communicator.
id | The type id for which the factory can create instances, or an empty string for the default factory. |