supermario/base/SuperMarioProj.1994-02-09/Toolbox/DataAccessMgr/DatabaseAccessPriv.h

351 lines
14 KiB
C
Raw Normal View History

2019-06-29 15:17:50 +00:00
/*
File: DatabaseAccessPriv.h
Contains: Private header for the Data Access Manager (codename SnarfMan).
Written by: Jeff Miller
Copyright: © 1989-1990, 1992 by Apple Computer, Inc., all rights reserved.
Change History (most recent first):
<15> 3/13/92 JSM Renamed this file DatabaseAccessPriv.h from SnarfMan.h, keeping
all the old revisions.
<14> 7/26/91 stb remove glue for HOpenResFile. Inline is used now when
SystemSevenOrLater is defined.
<13> 7/15/91 dba get rid of MEMERR
<12> 6/14/91 JL Changed inclusion of DatabaseAccess to AppleEvents.
<11> 4/2/90 JSM Get rid of resArrayElem (same as ResListElem), add CURMAP, macro
version of pstrcpy, and glueless HOpenResFile.
<10> 3/28/90 JSM Add RESERR and MEMERR, remove TRUE and FALSE.
<9> 3/13/90 JSM Update interface to status functions, change endLastRowLen to
endLastRowInfo in asyncVars.
<8> 3/12/90 JSM Add support for separate completion routine 'proc', result
handlers now in 'proc' resource, remove some unneeded typedef
struct tags.
<7> 2/23/90 JSM Add support for separate results handlers ('rtt#' and 'rttc'
resources).
<6> 2/20/90 JSM Remove refNum from asyncVars.
<5> 2/5/90 JSM Include Folders.h.
<4> 1/18/90 JSM Add constants to get strings for results handlers from System
file.
<3> 1/4/90 JSM Change some variable names in response to suggestions from
documentation.
<2> 12/20/89 JSM Update to use public includes.
<2.4> 12/7/89 JSM Added support for buffering partial rows in DBGetQueryResults.
<2.3> 11/7/89 JSM Added status functions, keep track of ddevs with vRefNum and
dirID.
<2.2> 10/6/89 JSM Updated to make SnarfMan a PACK.
<2.1> 9/18/89 JSM Changed kStateDone to kAllDone, general cleanup.
<2.0> 8/29/89 JSM Updated for new version 2 API.
<1.9> 8/7/89 JSM Added block comments, support for kill and results-to-text.
<1.8> 7/26/89 JSM Added support for ddev flags.
<1.7> 7/19/89 JSM Changed 'type' to 'theType' in ResListElem, 'type' to 'dataType'
elsewhere.
<1.6> 7/15/89 JSM Async stuff works now.
<1.5> 6/22/89 JSM Updated async stuff.
<1.4> 6/9/89 JSM Added more stuff to support async, not quite working yet.
<1.3> 5/31/89 JSM Reduced fields in globals, change strings in DDEVElem to
pointers, added constants for offsets in query STR#.
<1.2> 5/18/89 JSM Added #defines for resource and file types, added version to
'qrsc' definition, changed ddev and qdef interface.
<1.1> 4/28/89 JSM Added high-level information.
<1.0> 4/11/89 JSM Added to EASE for the first time.
*/
/* include Mac header files */
#include <Types.h>
#include <stdio.h>
#include <Resources.h>
#include <OSUtils.h>
#include <ToolUtils.h>
#include <Memory.h>
#include <Errors.h>
#include <Files.h>
#include <Packages.h>
#include <SANE.h>
#include <Folders.h>
#include <AppleEvents.h> /* Snarf stuff */
#include <DDEV.h> /* Snarf stuff */
/* make it easy to call ddev */
typedef pascal OSErr (*DDEVPtr)(DDEVParams *op);
/* make it easy to call qdef */
typedef pascal OSErr (*QDEFPtr)(long *sessID, QueryHandle op);
/* make it easy to call status functions for DBStartQuery and DBGetQueryResults */
typedef pascal Boolean (*statusPtr)(short message, OSErr result, short dataLen,
short dataPlaces, short dataFlags, DBType dataType, Ptr dataPtr);
/* make it easy to call result handlers */
typedef pascal OSErr (*HandlerPtr)(DBType dataType, short theLen, short thePlaces,
short theFlags, Ptr theData, Handle theText);
/* macro to zero parameter block */
#define ClearParams(x) mymemclear((char*)&x, sizeof(DDEVParams))
/* macro to copy pascal strings */
#define pstrcpy(dest, src) BlockMove(src, dest, src[0]+1)
/* don't use the ResError() and CurResFile() traps */
#define RESERR *((short*)0xA60)
#define CURMAP *((short*)0xA5A)
#define DDEVTYPE 'ddev' /* file type of ddev file */
#define QDOCTYPE 'qery' /* file type of query documents */
#define DDEVRESTYPE 'ddev' /* resource type of ddev code */
#define DDEVFLAGRESTYPE 'dflg' /* resource type of ddev flags */
#define QRSCRESTYPE 'qrsc' /* resource type of query resource */
#define QDEFRESTYPE 'qdef' /* resource type of query def proc */
#define QUERYRESTYPE 'wstr' /* resource type of queries */
#define RTTLISTRESTYPE 'rtt#' /* results to text list */
#define RTTCODERESTYPE 'proc' /* results to text code */
#define COMPCODERESTYPE 'proc' /* completion routine code */
/* note - id -5728 is first owned resource for PACK 13 */
#define RTTLISTID -5728 /* 'rtt#' specifying default system handlers */
#define HANDLERSSTR -5728 /* STR# with strings for result handlers */
#define COMPCODERESID -5727 /* 'proc' resource with completion routine */
/* offsets into STR# for strings used by result handlers */
#define BOOLEANTRUESTR 1 /* typeBoolean - true */
#define BOOLEANFALSESTR 2 /* typeBoolean - false */
#define UNKNOWNSTR 3 /* typeUnknown */
#define COLBREAKSTR 4 /* typeColBreak */
#define ROWBREAKSTR 5 /* typeRowBreak */
/* offsets into STR# for ddevName, host, etc. in query document */
#define DDEVOFFSET 1 /* ddevName */
#define HOSTOFFSET 2 /* host */
#define USEROFFSET 3 /* user */
#define PASSWORDOFFSET 4 /* password */
#define CONNSTROFFSET 5 /* connStr */
/* arbitrary number for indicating an async high level call is done */
/* make sure this doesn't match any of the ddev messages! */
#define kAllDone 200
/************************************************/
/* Structure of package header. */
/* Used by InitDBPack to compare version nums. */
/************************************************/
typedef struct {
short bra; /* branch instruction to dispatcher */
ResType pack; /* 'PACK' */
short number; /* id of package */
short version; /* version */
}
PackHeader,
*PackHeaderPtr,
**PackHeaderHndl;
/************************************************/
/* Low memory global with a handle to our PACK. */
/* This is App2Packs (0xBC8) + 4 * (the package */
/* id - 8) = 0xBC8 + 4 * (13 - 8). */
/************************************************/
#define DataAccessMgrPack *((PackHeaderHndl*)(0xBC8 + 0x14))
/************************************************/
/* Structure for global variables. */
/* Under 7.0, a pointer to this structure is */
/* stored in the emSnarfGlobals low mem global. */
/************************************************/
typedef struct {
struct ddevElem **ddevRoot; /* root of ddev list */
struct snarfSessElem **snarfRoot; /* root of snarf ID list */
DBAsyncParmBlkPtr pbRoot; /* list of queued parameter blocks */
short numHandlers; /* number of handlers in array */
struct HandlerRecord **handlers; /* handle to array of result handlers */
Handle handlerRes; /* handle to 'proc' for result handlers */
Handle completionRes; /* handle to 'proc' for completion routine */
}
snarfGlob,
*snarfGlobPtr,
**snarfGlobHndl;
/************************************************/
/* Structure to keep track of ddevs. */
/* A list of handles to these structures is */
/* hung off ddevRoot in the globals. */
/************************************************/
typedef struct ddevElem {
struct ddevElem **next; /* next element in list */
Boolean exists; /* if ddev file deleted */
Boolean canAsync; /* true if can do async calls */
char *name; /* ddev name in STR resource */
char *fname; /* ddev file name */
short vRefNum; /* where located (System Folder) */
long dirID; /* dirID where located */
DDEVPtr *ddev; /* handle to (detached) ddev resource */
long ddevStorage; /* ddev private storage */
struct sessElem **sessRoot; /* list of active sessions */
}
ddevElem,
*ddevElemPtr,
**ddevElemHndl;
/************************************************/
/* Structure to keep track of sessions for an */
/* individual ddev. A list of handles to these */
/* structures is hung off sessRoot in each */
/* ddevElem. */
/************************************************/
typedef struct sessElem {
struct sessElem **next; /* next element in list */
struct ddevElem **parent; /* ddev who owns session */
long sessID; /* ID as seen by ddev */
}
sessElem,
*sessElemPtr,
**sessElemHndl;
/************************************************/
/* Structure to keep track of snarf IDs. */
/* A snarf ID is a unique identifier for */
/* sessions across all ddevs. A list of */
/* handles to these structures is hung off */
/* snarfRoot in the globals. */
/************************************************/
typedef struct snarfSessElem {
struct snarfSessElem **next; /* next element in list */
long snarfID; /* ID as seen by app */
long processID; /* parent process - not used yet! */
struct sessElem **sess; /* handle to session element */
ResultsRecord *oldResults; /* leftover results for DBGetQueryResults */
short currCol; /* number of cols in leftover results */
}
snarfSessElem,
*snarfSessElemPtr,
**snarfSessElemHndl;
/************************************************/
/* Partial structure of 'qrsc'. Since there */
/* are variable length arrays of 'wstr' IDs and */
/* resources, it only goes up to the start of */
/* the 'wstr' array. */
/************************************************/
typedef struct {
short version; /* version */
short qdefID; /* QDEF ID */
short strID; /* STR# with ddevName etc. */
short currQuery; /* current query */
short numQueries; /* number of queries that follow */
short queryArray[]; /* array of 'wstr' IDs */
/* After the variable 'wstr' array, it looks like (see resArrayList below):
short numRes;
resArrayElem res[numRes];
*/
}
queryRes,
*queryResPtr,
**queryResHndl;
/************************************************/
/* Structure of list of resource elements in a */
/* 'qrsc'. See queryRes structure above. */
/************************************************/
typedef struct {
short numRes; /* number of elements that follow */
ResListElem res[]; /* array of resource elements - same as in QueryRecord */
}
resArrayList,
*resArrayListPtr;
/************************************************/
/* Structure for async vars when making async */
/* calls to Data Access Mgr routines. A pointer*/
/* to this structure is hung off the reserved */
/* field in the DBAsyncParamBlockRec. Make */
/* sure this matches definition in */
/* DataAccessMgr.a. */
/************************************************/
typedef struct {
DBAsyncParmBlkPtr next; /* next pb in list */
DBAsyncParmBlkPtr asyncPB; /* async pb passed in to routine */
DDEVParamsPtr params; /* pointer to ddev parameters */
short currAction; /* current action - selector or kAllDone */
Boolean executing; /* true if call executing */
Boolean highlevel; /* true if this is a highlevel call */
ddevElemHndl ddevH; /* handle to ddev - need to keep for kill */
statusPtr statusProc; /* status function for high level stuff */
/* variables for DBInit */
Boolean firstsess; /* true if first session for ddev */
Boolean filler;
long *sessIDPtr; /* pointer to session ID */
/* variables for DBEnd */
snarfSessElemHndl snarf; /* handle to snarf session cell */
/* also used by DBGetQueryResults */
/* variables for DBGetConnInfo */
long *returnedIDPtr; /* pointer to returned sess ID */
long *versionPtr; /* pointer to version */
long *startPtr; /* pointer to start time */
OSErr *statePtr; /* pointer to state */
/* variables for DBGetSessionNum */
short *sessNumPtr; /* pointer to returned sess number */
/* variables for DBGetErr */
long *err1Ptr; /* pointer to error 1 */
long *err2Ptr; /* pointer to error 2 */
/* variables for DBGetItem */
DBType *dataTypePtr; /* pointer to type of data */
short *lenPtr; /* pointer to length of data */
short *placesPtr; /* pointer to places */
short *flagsPtr; /* pointer to flags */
/* variables for DBStartQuery */
QueryHandle query; /* query for DBSend */
Handle queryText; /* text for DBSend */
char queryState; /* state of query handle */
char textState; /* state of text handle */
/* variables for DBGetQueryResults */
long sessID; /* session ID */
ResultsRecord *results; /* to hold results */
ResultsRecord *oldResults; /* old results stored in snarf elem */
DBType dataType; /* data type of current column */
long timeout; /* timeout for DBGetItem */
short len, places, flags; /* stuff for current column */
long currOffset; /* current offset into data */
long oldCurrOffset; /* current offset into old data */
long endLastRowData; /* end of last row (data) */
long endLastRowInfo; /* end of last row (info) */
short currCol; /* current column */
Boolean firsttime; /* true if getting first column */
Boolean doingGetItemInfo; /* true if DBGetItem for info only */
}
asyncVars,
*asyncVarsPtr;
/************************************************/
/* Structure to keep track of result handlers. */
/* A handle to a dynamic array of these records */
/* is kept in the handlers field of the globals.*/
/* The array is sorted based on type. */
/************************************************/
typedef struct HandlerRecord {
DBType type; /* what data type this handler is for */
HandlerPtr theHandler; /* pointer to actual procedure */
struct HandlerRecord **next; /* for multiple handlers for one type */
THz hZone; /* current zone when InstallHandler called */
Boolean isSysHandler; /* TRUE if system handler */
char filler;
}
HandlerRecord,
*HandlerRecordPtr,
**HandlerRecordHandle;