Represents a database API. The point you have to start with. More...
|SAPI (bool unloadAPI=false)|
|Defaut constructor. |
|SAPI (SAClient_t eSAClient, bool unloadAPI=false) SQLAPI_THROW(SAException)|
|Initializes the object with specific DBMS API type. |
|A destructor. More...|
|void||setClient (SAClient_t eSAClient) SQLAPI_THROW(SAException)|
|Assigns an DBMS client for the API class. More...|
|SAClient_t||Client () const|
|Returns the current DBMS client assigned for the connection. |
|long||ClientVersion () const SQLAPI_THROW(SAException)|
|Returns the DBMS client API version number. More...|
|IsaAPI *||NativeAPI () const SQLAPI_THROW(SAException)|
|Returns a native DBMS client API object. More...|
|bool||isUnloadAPI () const|
|Returns native API unload flag value. |
|Public Member Functions inherited from SAOptions|
|Defaut constructor. |
|virtual SAString &||setOption (const SAString &sOptionName)|
|Sets a string value of a specific option. More...|
|virtual SAString||Option (const SAString &sOptionName) const|
|Returns a string value of a specific option. |
|virtual int||TotalOptions () const|
|Returns the count of options. |
|virtual SAString||OptionName (int nIndex) const|
|Returns the string value of an option. |
Represents a database API. The point you have to start with.
The SAPI class represents a database API. You may need to have a DBMS API initialized before you can operate on the database - furthermore the SAConnection needs to be connected. It is important to note that DBMS API objects are not initialized during construction - it is up to the user to explicitly call SAPI::setClient method for the object after it is created and before it is used. DBMS API connection object is normally shared by the other objects those require a DBMS aceccing (e.g. SAConnection object).
Constructor & Destructor Documentation
Implicitly closes and deassosiates all linked SAConnection.
Uninitializes DBMC API library.
Member Function Documentation
Assigns an DBMS client for the API class.
eSAClient One of the following values from SAClient_t enum.
- You can set a client in constructor, in this case you don't need to use setClient method. The main destination of this method is to initialize DBMS API (for example, to check a client availability and version).
If you are calling setClient method when the related connection is set to another client the previous connection will be disconnected and new client will be set.
Returns the DBMS client API version number.
- The long number of a client API version.
- The higher word contains the major client version (the XX value in the XX.YY version number); the lower word contains the minor client version (the YY value in the XX.YY version number).
If an DBMS client was not set calling ClientVersion method will throw an exception.
|IsaAPI * SAPI::NativeAPI||(||)||const|
Returns a native DBMS client API object.
- A pointer to a base class ISAPI from which a family of DBMS implementation-specific classes are derived.
- Use this method if you want to call client specific API functions which are not directly supported by the Library. The method returns a pointer to the set of native API functions available for an DBMS client you currently use. To use the database API directly you have to downcast this ISAPI pointer to the appropriate type and use its implementation-specific members.
See Server Specific Guide section to know what type cast you have to make and what additional header file you have to include to work with specific DBMS client API. Note that for some DBMS using appropriate type casting depends on an API version (that generally mean that you have to explicitly check client version before casting, see SAPI::ClientVersion method).
To get more information about DBMS API functions see this DBMS specific documentation.
Please be aware of the complications associated with making direct API calls, as the internal logic of the SQLAPI++ Library is not used. Besides, making direct API calls reduces an application's portability.