Generated interfaces and classes

This section describes classes generated by the VisiBroker for C++ IDL compiler, their uses, and their features.

Generated interfaces and classes overview

The VisiBroker IDL compiler generates classes that make it easier for you to develop client applications and object servers. Many of these generated classes are available for CORBA classes.

•

•

•

•

The <interface_name> class is generated for a particular IDL interface and is intended for use by client applications. This class provides all of the methods defined for a particular IDL interface. When a client uses an object reference to invoke methods on the object, the stub methods are actually invoked. The stub methods allow a client operation request to be packaged, sent to the object implementation, and the results to be reflected. This entire process is transparent to the client application.

When a client uses a local object reference to invoke methods on the local object, there is no stub method involved.

Note

You should never modify the contents of a stub class generated by the IDL compiler.

<Interface_name>ObjectWrapper

This class does not apply to local interfaces. For non-local interfaces, this class is used to derive typed object wrappers and is generated for all your non-local interfaces when you invoke the idl2cpp command with the
-obj_wrapper option. For more information about the -obj_wrapper option, see “Programmer tools for C++” in the VisiBroker for C++ Developer's Guide.

static void add(CORBA::ORB_ptr orb,
CORBA::ObjectFactory factory,
VISObjectWrapper::Location loc);

static void remove(CORBA::ORB_ptr orb,
CORBA::ObjectFactory factory,
VISObjectWrapper::Location loc);

Removes an un-typed object wrapper from a server application.


Parameter	Description
orb	The ORB the client wishes to use, returned by the ORB_init method.
factory	The factory method for the object wrapper class that you want to remove.
loc	The location of the object wrapper being removed, which should be one of the following values:VISObjectWrapper::Client, VISObjectWrapper::Server VISObjectWrapper::Both

_POA_<class_name>

The _POA_<class_name> class is an abstract base class generated by the IDL compiler, which is used to derive an object implementation class. Object implementations are usually derived from a servant class, which provides the necessary methods for receiving and interpreting client operation requests.

_tie_<class_name>

The _tie_<class_name> class is generated by the IDL compiler to aid in the creation of delegation implementations. The tie class allows you to create an object implementation that delegates all operation requests to another object. This allows you to use existing objects that you do not wish to inherit from the CORBA::Object class.

<class_name>_var

The <class_name>_var class is generated for an IDL interface and provides simplified memory management semantics.