getProperties abstract method
Create a new object adapter with endpoints. This operation sets
the property name.Endpoints, and then calls
{@link #createObjectAdapter}. It is provided as a convenience
function.
Calling this operation with an empty name will result in a
UUID being generated for the name.
@param name The object adapter name.
@param endpoints The endpoints for the object adapter.
@return The new object adapter.
@see #createObjectAdapter
@see ObjectAdapter
@see Properties
Create a new object adapter with a router. This operation
creates a routed object adapter.
Calling this operation with an empty name will result in a
UUID being generated for the name.
@param name The object adapter name.
@param rtr The router.
@return The new object adapter.
@see #createObjectAdapter
@see ObjectAdapter
@see Properties
Add an object factory to this communicator. Installing a
factory with an id for which a factory is already registered
throws AlreadyRegisteredException.
When unmarshaling an Ice object, 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 object was marshaled:
If the object 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 object 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.
Implementation
// ObjectAdapter createObjectAdapterWithEndpoints(String name, String endpoints);
/// Create a new object adapter with a router. This operation
/// creates a routed object adapter.
/// Calling this operation with an empty name will result in a
/// UUID being generated for the name.
/// @param name The object adapter name.
/// @param rtr The router.
/// @return The new object adapter.
/// @see #createObjectAdapter
/// @see ObjectAdapter
/// @see Properties
// ObjectAdapter createObjectAdapterWithRouter(String name, Router rtr);
/// Add an object factory to this communicator. Installing a
/// factory with an id for which a factory is already registered
/// throws AlreadyRegisteredException.
/// When unmarshaling an Ice object, 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 object was marshaled:
/// If the object 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 object uses the "compact" format, Ice immediately raises
/// NoValueFactoryException.
/// The following order is used to locate a factory for a type:
/// <ol>
/// <li>The Ice run-time looks for a factory registered
/// specifically for the type.</li>
/// <li>If no instance has been created, the Ice run-time looks
/// for the default factory, which is registered with an empty type id.
/// </li>
/// <li>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.
/// </li>
/// </ol>
/// @param factory The factory to add.
/// @param id The type id for which the factory can create instances, or
/// an empty string for the default factory.
/// @see #findObjectFactory
/// @see ObjectFactory
/// @see ValueFactoryManager#add
// TODO: void addObjectFactory(ObjectFactory factory, String id);
/// Find an object factory registered with this communicator.
/// @param id The type id for which the factory can create instances,
/// or an empty string for the default factory.
/// @return The object factory, or null if no object factory was
/// found for the given id.
/// @see #addObjectFactory
/// @see ObjectFactory
/// @see ValueFactoryManager#find
// TODO: ObjectFactory findObjectFactory(String id);
/// Get the implicit context associated with this communicator.
/// @return The implicit context associated with this communicator;
/// returns null when the property Ice.ImplicitContext is not set
/// or is set to None.
// ImplicitContext getImplicitContext();
/// Get the properties for this communicator.
/// @return This communicator's properties.
/// @see Properties
Properties getProperties();