Ice::ObjectFactory Local Interface Reference

A factory for objects. More...

Defined in <Ice/ObjectFactory.ice>

local interface ObjectFactory { ... }

Operations
Object	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 in several places, for example, when receiving "objects by value" and when Freeze restores a persistent object. Object factories must be implemented by the application writer, and registered with the communicator.

Operation Documentation

create()

Object 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 "<tt>::</tt>" is required.

Parameters

type	The 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:

• Ice/ObjectFactory.ice