Class: TSQLDataStore

Declaration: SQLDataAccess.h

Taxonomy Categories:

Member Functions:

Interface Category:

API.

Inherits From:

TSQLProduct

Inherited By:

TSQLStandardDataStoreDB2 TSQLStandardDataStoreODBC TSQLStandardDataStoreOracle7 TSQLStandardDataStoreSybase10

Purpose:

TSQLDataStore is a concrete class that describes a data store, typically a DBMS such as Oracle 7 or AS/400.

Instantiation:

Allocate on the heap or the stack. Although this is a concrete class, SQLDAS clients typically use of one its derived classes to specify a particular datastore.

Deriving Classes:

Providers need to derive a new class for every new datastore that they want to support.

Concurrency:

Not multithread safe.

Resource Use:

No special requirements.

Other Considerations:

None.

Member Function: TSQLDataStore::TSQLDataStore

TSQLDataStore ()
TSQLDataStore (const TText & vendor, const TText & identifier, const TText & version, const TText & name, const TText & platform =TStandardText :: GetEmptyText ())
TSQLDataStore (const TSQLDataStore & source)

Interface Category:

API.

Purpose:

Default constructor.
Constructs a datastore for the specified product.
Copy constructor.

Calling Context:

Called by the stream-in operators and any other function that needs to construct an uninitialized object.
Call this function directly.
Called to copy an object.

Parameters:

Takes no parameters.
const TText & vendor -The vendor name.
const TText & identifier -The unique datastore identifier.
const TText & version -The datastore version.
const TText & name -The datastore name.
const TText & platform =TStandardText :: GetEmptyText () -The platform supporting the protocol, for example, AIX. The platform is normally not specified, because vendors try to ensure compatibility across platforms.
const TSQLDataStore & source -The object to copy.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TSQLDataStore::~TSQLDataStore

virtual ~ TSQLDataStore ()

Interface Category:

API.

Purpose:

Destructor.

Calling Context:

Called to destroy an object.

Parameters:

Takes no parameters.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TSQLDataStore::operator=

TSQLDataStore & operator =(const TSQLDataStore & right)

Interface Category:

API.

Purpose:

Assignment operator.

Calling Context:

Called when an object is assigned to another compatible object.

Parameters:

const TSQLDataStore & right -The datastore to be copied.

Return Value:

A non-const reference to the left-hand side object.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Click the icon to mail questions or corrections about this material to Taligent personnel.