| | 1 | [[TOC(heading=Generic Database Messages Section Contents, HowTos/HowToUseGenericDatabaseMessages*)]] |
| | 2 | |
| | 3 | = How To Use Generic Database Messages = |
| | 4 | |
| | 5 | One of the most compelling features of Model-Glue:Unity is its automated database capabilities. By using the Reactor framework, Model-Glue:Unity automates the creation and execution of common database tasks, such as single table CRUD (create, read, update, delete) and basic listing (SELECT). |
| | 6 | |
| | 7 | The framework accomplishes this by automatically loading a controller (the "!DataController") that listens for what are known as the "Generic Database Messages" (GDMs) These are a set of commands you can use inside your !ModelGlue.xml file to invoke automatic database functions. |
| | 8 | |
| | 9 | The GDMs also provide all data access functionality for event handlers created through the <scaffold> tag. |
| | 10 | |
| | 11 | The four GDMs that the !DataController is configured to listen for are as follows: |
| | 12 | |
| | 13 | 1. modelglue.!GenericList[[BR]][[BR]] When this message is broadcast, the !DataController will attempt to list records from a given table.[[BR]][[BR]] |
| | 14 | 1. modelglue.!GenericRead[[BR]][[BR]] When this message is broadcast, the !DataController will attempt to read a specific record from a given table.[[BR]][[BR]] |
| | 15 | 1. modelglue.!GenericCommit[[BR]][[BR]] When this message is broadcast, the !DataController will attempt to save a record to a given table.[[BR]][[BR]] |
| | 16 | 1. modelglue.!GenericDelete[[BR]][[BR]] When this message is broadcast, the !DataController will attempt to delete a record from a given table.[[BR]][[BR]] |
| | 17 | |