This abstract class defines the standard interface for a data access class. This class provides data access to a collection of rows from a table and lets you open a database cursor for accessing rows one at a time.
Note: For backward compatibility with previous releases of VisualAge C++, in which IDAManager function was in a class called IPOManager, the following type definition is provided:
typedef IDAManager IPOManager;
Inherits from:
IBase
|
+----IVBase
|
+----IDAAsynchObject
|
+----IDAManager
Inherited by:
IDAManager | +----<class>Manager | +----<class>DataIdManager
Public Functions by Category
public: virtual ~IDAManager
Supported Platforms Windows OS/2 AIX Y Y Y
public: void refresh (const char* sqlSuffix = 0);This method, when implemented in a derived class such as <Class>ManagerBase, retrieves the rows specified in the suffix from the table. If no suffix is passed in, then it returns all the rows in the table. Rows are retrieved into a sequence in memory. Eligible input for suffixes includes "WHERE" clauses and "ORDER BY" clauses, for example.
Supported Platforms Windows OS/2 AIX Y Y Y
public: void select (const char* sqlSuffix = 0);This method, when implemented in a derived class such as <Class>ManagerBase, retrieves the rows specified in the clause from the table. When this method performs the selection, it adds "WHERE" to the clause (so do not pass in "WHERE" as part of the clause). Rows are retrieved into a sequence in memory.
Supported Platforms Windows OS/2 AIX Y Y Y
public: virtual void open(const char* suffix = 0);This method, when implemented in a derived class such as <Class>ManagerBase, opens a database cursor on a collection of rows, as specified in the suffix. If no suffix is passed in, then all rows in the table are in the collection. (For ESQL access, the cursor is static if no parameter is passed in; it is dynamic if you pass in a suffix.) If you call this method when a cursor is already open, then that cursor is closed and reopened at the top of the query.
Supported Platforms Windows OS/2 AIX Y Y Y public: virtual void close();This method, when implemented in a derived class such as <Class>ManagerBase, closes the cursor, if one is open.
Supported Platforms Windows OS/2 AIX Y Y Y public: virtual void deleteFetched();This method, when implemented in a derived class such as <Class>ManagerBase, deletes the currently-fetched row from the table.
Supported Platforms Windows OS/2 AIX Y Y Y public: virtual void updateFetched();This method, when implemented in a derived class such as <Class>ManagerBase, updates the currently-fetched row with new attribute values.
Supported Platforms Windows OS/2 AIX Y Y Y public: virtual IBoolean fetchNext();This method, when implemented in a derived class such as <Class>ManagerBase, moves the cursor to the next row and fetches it. Returns a boolean value of true if there is a next row to fetch, or false if the cursor is at the last row of the result set.
Supported Platforms Windows OS/2 AIX Y Y Y public: virtual unsigned fill(unsigned Number=0);This method, when implemented in a derived class such as <Class>ManagerBase, fetches the passed-in number of rows from the cursor's current position into an internal collection. In order to use this method a cursor must be open. If you pass in 0 (zero), it will fill with all remaining rows. This method returns an unsigned integer value indicating the number of rows fetched. Each time you call the fill method, it overwrites the collection from the last time fill was called.
Supported Platforms Windows OS/2 AIX Y Y Y public: virtual unsigned append(unsigned Number=0);This method, when implemented in a derived class such as <Class>ManagerBase, appends the passed-in number of rows from the cursor's current position to the internal collection that was created by the last fill call. In order to use this method, a cursor must be open and the fill method must have been used to create an internal collection. If you pass in 0 (zero), it will append all remaining rows to the collection. This method returns an unsigned integer value indicating the number of rows fetched. Each time you call the append method, it adds more rows to the end of the internal collection.
Supported Platforms Windows OS/2 AIX Y Y Y public: virtual IStandardNotifier* element() const;
This method, when implemented in a derived class such as <Class>ManagerBase, returns a pointer to the currently-fetched object.
Supported Platforms Windows OS/2 AIX Y Y Y public: IBoolean isOpen();Use this method to determine whether or not a cursor is open. It returns true is a cursor is open, or false if none is open.
Supported Platforms Windows OS/2 AIX Y Y Y public: IBoolean isFetched();Use this method to determine if a row is fetched into the cached object. It returns true if a row is fetched, or false is none is fetched.
Supported Platforms Windows OS/2 AIX Y Y Y public: IBoolean isAfterLastRow();Use this method to determine whether the cursor is currently located after the last row in the table (that is, it has reached the end of the table). It returns true if the cursor is located after the last row, or false if it is located anywhere else (for example, before the first row).
Supported Platforms Windows OS/2 AIX Y Y Y
Public Data by Category
public: static const INotificationId itemsId; static const INotificationId selectCompleteId; static const INotificationId refreshCompleteId; static const INotificationId objectsDatastoreId; static const INotificationId defaultDatastoreId; static const INotificationId readOnlyId; static const INotificationId openCompleteId; static const INotificationId closeCompleteId; static const INotificationId fetchNextCompleteId; static const INotificationId noMoreDataId; static const INotificationId fetchNextIntoCompleteId; static const INotificationId deleteFetchedCompleteId; static const INotificationId updateFetchedCompleteId; static const INotificationId elementId; static const INotificationId fillCompleteId; static const INotificationId appendCompleteId; static const INotificationId appendCollectionCompleteId; static const INotificationId openId; static const INotificationId fetchedId; static const INotificationId afterLastRowId;
Supported Platforms Windows OS/2 AIX Y Y Y
Protected Functions by Category
IDAManager(IStandardNotifier *cachedObj, _seqType *seq); IDAManager(const IDAManager& partCopy, IStandardNotifier *cachedObj, _seqType *seq);
Supported Platforms Windows OS/2 AIX Y Y Y
Protected Operators
IDAManager& operator= (const IDAManager& aIDAManager);
Supported Platforms Windows OS/2 AIX Y Y Y
