IlvSDODbmsFactory Class Reference

An interface used to implement factories for DbLink IldDbms connections. More...

#include <ilviews/maps/format/oracle/sdodbmsfact.h>

Public Member Functions
virtual IldDbms *	makeDbms (IlvDisplay *display, const char *userName, const char *password, const char *oracleSidName, const char *dblinkDriverName, IlvMapsError &status)
	This method is called when an IlvSDOLayer requires an IldDbms. More...

Friends
class	IlvSDOLayer

Detailed Description

An interface used to implement factories for DbLink IldDbms connections.

Library: ilvdbmaps

Such factories are required to establish a connection when an .ilv file including an IlvSDOLayer is loaded by a Rogue Wave Views application. You can find an implementation of this factory in $ILVMAPSHOME/demos/oracle. The files are defdbmsfact.h and defdbmsfact.cpp: they define the IlvDefaultSDODbmsFactory class that you can use if you have the Rogue Wave Views Gadgets module (do not forget to call IlvSDOUtil::SetDbmsFactory() in this case).

See also

IlvSDOUtil::SetDbmsFactory().

Member Function Documentation

makeDbms()

virtual IldDbms* IlvSDODbmsFactory::makeDbms ( IlvDisplay *  display, const char *  userName, const char *  password, const char *  oracleSidName, const char *  dblinkDriverName, IlvMapsError &  status  )

virtual

This method is called when an IlvSDOLayer requires an IldDbms.

If this method returns a valid and connected IldDbms, you have to notify the other object waiting for this connection by calling IlvSDOLayer::DbmsUpdate(). You can override this method when subclassing this class (for example, to pop a dialog box to ask for the connection parameter) and use the IlvSDOUtil::SetDbmsFactory() function to install this new factory. When subclassing, do not call the superclass method makeDbms().

The connection string to create the IldDbms is the following: userName/password\@oracleSidName.

Parameters

display	The IlvDisplay that can be necessary for dialog box creation.
userName	The name of the user (that will be used to create the IldDbms).
password	The password of the user (that will be used to create the IldDbms).
oracleSidName	The sid (that will be used to create the IldDbms).
dblinkDriverName	The DbLink oracle driver (can be oracle9, oracle10 or oracle11). The function IldNewDbms() uses this parameter as its first parameter (dbmsName).
dblinkDriverName	The DbLink Driver name for oracle. It can be "oracle9", "oracle10" or "oracle11".
status	The error status raised by this function call.

Returns

The IldDbms that the method has to create.

See also

IlvSDOLayer::DbmsUpdate().

IldNewDbms().