Ferreteria/v0.6/code/sys/Requests

From Woozle Writes Code
< Ferreteria‎ | v0.6
Revision as of 02:13, 11 March 2025 by Woozle (talk | contribs)
Jump to navigation Jump to search
Request subsystems

There are (currently) the following types of request:

  • Requests to a database engine:
    • AdminRq is for administration operations: backup, restore, user management, etc.
    • CommRq is for data (should probably be renamed)
  • Input requests:

The purpose of engine requests is to allow consolidation of all the pieces needed to perform operations without knowing what engine or connection they will be used on.

Sequence of Events

  • At execution time, something calls InputReq->Go()
  • ...which then calls the Engine object or a helper to do the operation, e.g. Schema->DoImport()
    • ...which is where the thing is actually done, e.g. SQL code is sent to the DB Engine through the Connection.

...but this also happens somewhere:

  • DbConn->DoAdminRequest() calls AdminRq->AskEngine() with itself as the argument.
  • AdminRq->AskEngine() does any necessary calculations, then calls the appropriate Engine object or sub-object to do the operation (e.g. Schema->DoExport).