From Woozle Writes Code
Jump to navigation Jump to search

Navigation: PortBank : PortRow : PortCard


Each PortCard represents a single row of data in a particular format. The base formats (which correspond those used by PortRows) are:

  • root (caBase)
    • single integer key (k1i) (cK1I):
      • Native (calc), which is used only for internal calculations (no I/O)
      • I/O (cIO):
        • Storage (stor): I/O Row which converts to and from SQL (or, in theory, any other database-storage format)
        • Display (disp): I/O Row which converts to and from HTML (or, in theory, any other display markup)

Once loaded with data from a given Row, a PortCard is never re-loaded with data from a different row; it always corresponds to the same row, although individual fields may be modified for output purposes. Loading a new row into a Card requires creating a new Card.

Key Methods

  • caPortIORow::TransloadInput() : tell I/O row to convert its data to native format and load to calc row
  • caPortIORow::TransloadOutput() : tell I/O row to convert data in calc row to native and load to itself
  • data\rows\tDBAccess::GetMySpec() : data\spec\cQuery : fetches a Storage Card's Spec object for access to data operations
  • data\spec\cTable::Table(data\rows\cStor $o = NULL) : data\cTabloid : fetches the Table object specified by the Spec
  • data\card\cK1I::DoUpdate(array $arChg) : data\cUpdateStatus : calls tUpdatable::DoUpdate() with a calculated $sqlWhere
  • data\tUpdatable::DoUpdate(array $arChg, string $sqlWhere) : cUpdateStatus : updates the changed fields (specified in $arChg) for rows specified by $sqlWhere in the current table in the database


  • 2023-03-19 Having the calc, stor, and disp classes below k1i in the hierarchy seems like a bad idea. Maybe one or both of those splits need to be traits.