Active Database (ADb)
ADb is a relational database system implemented in JavaScript. ADb's implementation is based on the ActiveRecord design pattern.
- Copyright: Copyright (c) 2006-2009 Andy Kant, http://andykant.com/
- Website: http://github.com/andykant/active-database
- License: MIT-style license
- Version: 1.0.0.20
- ADb.$type is based on $type from mootools.js, http://mootools.net (c) Valerio Proietti, MIT-style license.
- ADb.$xfn is equivalent to $xfn from xfn.js, http://github.com/andykant/extended-function-factory (c) Andy Kant, MIT-style license.
- ADb is not a transactional database system. This is primarily because there isn't a reasonable way to clone objects while maintaining their original context. Due to this, assume that changes made to a row have the potential be applied to the database immediately. However, always call the $save method on the row to ensure that the database is updated.
- ADb is a relational database system, but the relations are not enforced.
- It is not recommended to export tables with functions, textnodes, or elements because those objects cannot be exported. Likewise, any objects containing any of these datatypes will probably not export properly either. These datatypes will be exported as 'null' instead with the exception of functions used as default value generators.
- Primary keys are limited to a single column with one of the following datatypes: number, string, auto (auto-incremented number).
- Foreign key references in a table declaration should create a ADb.$ref object if the foreign key's table has not been initialized yet. ADb.$ref will ensure that the table has been initialized, and will then return the first matching entry.
- Columns of the datatype 'auto' should be passed 'null' when creating new rows.
- Any method or property marked as DESTRUCTIVE might cause unintentional results. Destructive methods might change the structure or data of a database or table. Changing the value for a destructive property might prevent the database from working correctly.
- Error messages are only enabled when ADb.$debug is set to 'true'. Error messages will be passed to Firebug if it is available.