Rogue Wave Views
Maps Package API Reference Guide
Product Documentation:

Rogue Wave Views
Documentation Home
List of all members | Public Member Functions | Friends
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

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
displayThe IlvDisplay that can be necessary for dialog box creation.
userNameThe name of the user (that will be used to create the IldDbms).
passwordThe password of the user (that will be used to create the IldDbms).
oracleSidNameThe sid (that will be used to create the IldDbms).
dblinkDriverNameThe DbLink oracle driver (can be oracle9, oracle10 or oracle11). The function IldNewDbms uses this parameter as its first parameter (dbmsName).
dblinkDriverNameThe DbLink Driver name for oracle. It can be "oracle9", "oracle10" or "oracle11"
statusThe error status raised by this function call.
Returns
The IldDbms that the method has to create.
See also
IlvSDOLayer::DbmsUpdate()
IldNewDbms

© Copyright 2016, Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave is a registered trademark of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.