home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR9 / WIZTOO.ZIP / REGWIZ.TXT < prev    next >
Text File  |  1993-09-23  |  5KB  |  94 lines
  1. //  File:   REGWIZ.TXT
  2.  
  3. //                                                   September 20, 1993
  4. //                                                   Fairfield, Iowa
  5.  
  6. //          Aerosoft  (R)  Register Wizard            Version 1.0
  7. //          Copyright (c)  Aerosoft 1993     All rights reserved.
  8.  
  9. //          This software source code is FREEWARE.  You may be use the
  10. //          source code or redistribute the source code free of charge.
  11. //          However, you cannot sell this source code or any alteration of
  12. //          the source code.
  13.  
  14. This file documents some design notes about the program.  See file REGWIZ.MAN 
  15. for a description of the operation of the REGWIZ program.  Before reviewing
  16. this document please read REGWIZ.MAN for an explanation of the concept of a
  17. Register Channel.  Note that an object listening to a channel is called a
  18. server while an object sending data is called a client.
  19.  
  20. REGWIZ reads an input file specifying register channels and it generates
  21. four files that can be used to implement these channels.
  22.  
  23. This translation is done in two steps:  the register channel specs are
  24. deciphered and stored in a database.  The channel specs database is then
  25. used to generate the output files.
  26.  
  27. REGWIZ uses two principle objects to decipher the channel specs: InStream 
  28. and ChannelSpecs.  InStream reads each channel spec entry into a buffer
  29. and provides parsing member functions for extracting tokens from an entry.
  30. There are three kinds of tokens: numbers, labels, and 1-char delimiters.
  31. ChannelSpecs provides a database holding each deciphered channel entry.
  32.  
  33. A deciphered channel spec consists of six parts:
  34.  
  35.     return type specifier  (only int, long, float, double, and void are legal)
  36.     function name
  37.     proto-list             (the argument list including the arguments' type
  38.                             specifiers)
  39.     arg-list               (a list of argument names without type specifiers)
  40.     default return value
  41.     max receivers          (the max number of objects that can be connected to
  42.                             the channel)
  43.                             
  44. Member function GetNextChannelSpec deciphers a spec.  It relies upon the
  45. parsing functions of InStream to do this.  It scans left to right looking for
  46. each component of a channel spec. 
  47.  
  48. NOTE: InStream skips nested parenthesis that may be found inside and argument list.
  49.       This simplifies the work that GetNextChannelSpec must do.
  50.       
  51. Once the channel specs have been deciphered, code generation is a simple matter
  52. of taking each spec and generating "cookbook" code.  This code is as follows:
  53.  
  54.     1) CHNNLDEF.H declares a class for every channel specified.  Each class
  55.        declares a pure-virtual member function.  This approach lets C++'s
  56.        polymorphism route channel messages to the appropriate objects.
  57.        
  58.     2) REGISTER.H declares the class Register and a global object, oRegister.
  59.        All client messages are routed thru object oRegister.  For each
  60.        channel there are four member functions:
  61.        
  62.             Connect, Disconnect, ChannelStatus, Execute<channel name>
  63.             
  64.        Connect and Disconnect are used by servers to control message
  65.        routing to themselves.  Execute<> is used by a client to forward
  66.        a message.  Anyone can use ChannelStatus -- examples are checking whether
  67.        a connect or disconnect was successful or checking whether a channel has
  68.        anyone connected.
  69.        
  70.        Register uses function overloading to map from a channel class to
  71.        the corresponding channel list.  This is done for Connect, Disconnect,
  72.        ChannelStatus, and Execute<>.
  73.        
  74.        There is a separate ChannelList object for each channel.  This is done for
  75.        future enhancement when templates are supported.  Then, channel list pointers
  76.        can refer to channel classes rather than being "void" pointers.
  77.        
  78.     3) REGISTER.CPP defines object oRegister and it's member functions.
  79.     
  80.     4) APP.CPP contains code templates.  It is available to assist programmers in
  81.        writing code for clients and servers.
  82.  
  83.  
  84. When writing code for a client or server, include file CHNNLDEF.H Classes that 
  85. define objects servers must be derived from the corresponding register 
  86. channel's class.  If an object receives data from more than one channel, then 
  87. use multiple inheritance. 
  88.  
  89. Build your application by including module REGISTER.CPP in your project. 
  90.  
  91. Review the example program provided to get a better understanding about the use
  92. of the Register Wizard.
  93.  
  94.