Design/id_notes

   1
   2                          Stem::Id Design Notes
   3
   4 The Stem::Id module generates unique Id strings for use as names in Stem
   5 addresses. Its most common use is by parent Cells which clone themselves
   6 and need a unique Target. The parent Cell uses its Cell name and the new
   7 Target to register the cloned Cell.
   8
   9 A typical use is by a Stem::SockMsg Cell which creates a Stem::Id object
  10 during its own construction. When this parent Cell accepts a socket
  11 connection, it clones itself and needs to register this new Cell with a
  12 unique address.  The parent Cell calls the next method of its Stem::Id
  13 object to get a unique Id which is uses for the Target address of the
  14 cloned Cell. Then the cloned Cell is registered with the parent Cell
  15 name and the new Target name. This address is then sent to other Cells
  16 so they can communicate with this new Cell.
  17
  18 This module is only used internally and should not be configured.