Commit | Line | Data |
4536f655 |
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. |