home *** CD-ROM | disk | FTP | other *** search
/ Borland Programmer's Resource / Borland_Programmers_Resource_CD_1995.iso / code / kdbf / example / favrest.cpp < prev    next >
Encoding:
C/C++ Source or Header  |  1995-05-19  |  5.4 KB  |  182 lines
  1. /****************************************************************************
  2. *                                                                           
  3. * FILE: FAVREST.CPP
  4. *
  5. * DESCRIPTION:  This file contains the member functions for the class
  6. *               FavoriteRestaurant used in the sample program for the   
  7. *               C++ Database Framework.
  8. *               
  9. *
  10. ****************************************************************************/
  11.  
  12. #ifdef _MSC_VER
  13. #include <memory.h>
  14. #else
  15. #include <mem.h>
  16. #endif
  17. #include <string.h>
  18. #include "demo.h"
  19.  
  20. /****************************************************************************
  21. *          
  22. * CLASS:  FavoriteRestaurant
  23. *                                                                
  24. * MEMBER FUNCTION: FavoriteRestaurant (constructor)
  25. *
  26. * DESCRIPTION:  This function creates an instance of the FavoriteRestaurant
  27. *               class.
  28. *               
  29. * RETURNS: NONE
  30. *
  31. ****************************************************************************/
  32.  
  33. // the code for the constructor is inline and may be found in DEMO.H
  34.  
  35. /****************************************************************************
  36. *          
  37. * CLASS:  FavoriteRestaurant
  38. *                                                                
  39. * MEMBER FUNCTION: getRecord
  40. *
  41. * DESCRIPTION:  This function gets the current record from the database
  42. *               and assigns the field values to the data members in the
  43. *               class.
  44. * 
  45. *    NOTE:
  46. *
  47. *    Since BLOB fields are not stored in the table's .DB file, getting the
  48. *    record does not get the BLOB field's contents. Two functions are needed
  49. *    to get a record and a BLOB field. First, one must get the record and
  50. *    then the BLOB fields must be retrieved. Between the call to getRecord()
  51. *    and openBlobRead() the BLOBs record could be deleted, or the BLOB could
  52. *    be changed. If this happens, openBlobRead() will return 
  53. *    PXERR_BLOBMODIFIED.  To prevent updates to BLOBs while the record is
  54. *    being read, you can lock the record prior to calling getRecord() 
  55. *    and release the lock after getting the BLOB fields.  
  56. *
  57. *    RETURNS: PXERR_, if one occurs.
  58. *
  59. ****************************************************************************/
  60. Retcode FavoriteRestaurant::getRecord()
  61. {
  62.   BRecord     *currentRecord;
  63.   LOCKHANDLE  recordLockHandle;
  64.   BOOL        isBlank;      
  65.  
  66.   //
  67.   // See if the table was opened.
  68.   //
  69.   if(!isOpen)
  70.   {
  71.      return(lastError = ERROR_TABLENOTOPEN);
  72.   }
  73.   //
  74.   // If the application is running in a multiuser environment, check to 
  75.   // see if another user has changed the table.
  76.   //
  77.   if(cursorPtr->hasChanged() == TRUE)
  78.   {
  79.     //
  80.     // Refresh the table's buffers.
  81.     //
  82.     cursorPtr->refresh();
  83.   }
  84.   //
  85.   // Reduce the amount of pointer dereference.
  86.   //
  87.   currentRecord = cursorPtr->genericRec;
  88.   //
  89.   // Close any BLOB fields that might be open in this table.
  90.   //
  91.   currentRecord->closeBlob(FAV_MENU_FIELD, FALSE);  
  92.   // 
  93.   // Lock the record.
  94.   //
  95.   recordLockHandle = cursorPtr->lockRecord();
  96.  
  97.   //
  98.   // Check if the record is locked and the network is initialized. 
  99.   //
  100.   if((cursorPtr->lastError != PXSUCCESS) &&
  101.     (cursorPtr->lastError != PXERR_NONETINIT))
  102.   {
  103.     //
  104.     // Return any errors that occurred. 
  105.     //
  106.     return(lastError = cursorPtr->lastError);
  107.   }
  108.  
  109.   lastError = AbstractRestaurant::getRecord();
  110.   //
  111.   // Check if successful. 
  112.   //
  113.   if (lastError == PXSUCCESS)
  114.   {
  115.     //
  116.     // Use the BCursor gereric record to extract fields from the record.
  117.     //
  118.     currentRecord->getField(FAV_NAME_FIELD, name, MAX_NAME_LEN + 1, isBlank); 
  119.     currentRecord->getField(FAV_TYPE_FIELD, type, MAX_TYPE_LEN + 1, isBlank); 
  120.  
  121.     //
  122.     // Create PRIVATE BLOBs for the memo field.  This will prevent
  123.     // other users from changing the BLOB or deleting the 
  124.     // record with which the BLOB is associated.
  125.     //
  126.     currentRecord->openBlobRead(FAV_MENU_FIELD, TRUE);
  127.  
  128.   }
  129.   //
  130.   // Unlock the record.
  131.   //
  132.   cursorPtr->unlockRecord(recordLockHandle);
  133.  
  134.   return(lastError);
  135. }
  136.  
  137. /****************************************************************************
  138. *          
  139. * CLASS:  FavoriteRestaurant
  140. *                                                                
  141. * MEMBER FUNCTION: getMenu
  142. *
  143. * DESCRIPTION:  This function retrieves the menu field from the table.
  144. *               
  145. * RETURNS: PXERR_, if one occurs.
  146. *
  147. ****************************************************************************/
  148.  
  149. Retcode FavoriteRestaurant::getMenu(char *buffer, unsigned int sizeOfBuffer, 
  150.   long offset, unsigned int &bytesRead) 
  151. {
  152.   //
  153.   // Specify a particular field and use the generic getBlobField function.
  154.   //
  155.   lastError = getBlobField(FAV_MENU_FIELD, buffer, sizeOfBuffer, offset,
  156.     bytesRead);
  157.  
  158.   return(lastError);
  159. }
  160.  
  161. /****************************************************************************
  162. *          
  163. * CLASS: FavoriteRestaurant
  164. *                                                                
  165. * MEMBER FUNCTION: sizeOfMenuBlob
  166. *
  167. * DESCRIPTION: This function returns the size of the Menu memo field.
  168. *               
  169. * RETURNS: Number of bytes in the Menu memo field.
  170. *
  171. ****************************************************************************/
  172.  
  173. long FavoriteRestaurant::sizeOfMenuBlob()
  174. {
  175.   //
  176.   // Return the BLOB size. Error checking is done in base function.
  177.   //
  178.   return(getBlobSize(FAV_MENU_FIELD));
  179.  
  180. }
  181.  
  182.