Ice 3.7 Slice API Reference
Operations | List of all members
Ice::ObjectFactory Local Interface Reference

A factory for objects. More...

defined in <Ice/ObjectFactory.ice>

["deprecate:ObjectFactory has been deprecated, use ValueFactory instead."]
local interface ObjectFactory { ... }

Operations

Value create (string type)
 Create a new object for a given object type. More...
 
void destroy ()
 Called when the factory is removed from the communicator, or if the communicator is destroyed. More...
 

Detailed Description

A factory for objects.

Object factories are used when receiving "objects by value". An object factory must be implemented by the application writer and registered with the communicator.

Operation Documentation

◆ create()

Value create ( string  type)

Create a new object for a given object type.

The type is the absolute Slice type id, i.e., the id relative to the unnamed top-level Slice module. For example, the absolute Slice type id for interfaces of type Bar in the module Foo is "::Foo::Bar".

The leading "<code>::</code>" is required.

Parameters
typeThe object type.
Returns
The object created for the given type, or nil if the factory is unable to create the object.

◆ destroy()

void destroy ( )

Called when the factory is removed from the communicator, or if the communicator is destroyed.

See also
Communicator::destroy

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