links to this page:    
View this PageEdit this PageUploads to this PageHistory of this PageTop of the SwikiRecent ChangesSearch the SwikiHelp Guide
What is meant by transparent access?
Last updated at 4:40 am UTC on 20 September 2016
The best Object-oriented applications are ones which model a pure domain engine, separate and free from concerns about presentation or persistence. Transparency refers to the ability for the application to maintain a pure domain code free of those concerns. High-transparency is the primary purpose of Magma's to exist. There is no need for applications to mark objects dirty, no code-generation, no attribute-column associating.

Developers are free to implement complex object models with impunity. Domain code remains pure, and independent of storage.

Read Transparency

Beyond the initial request for the #root object of the repository from a MagmaSession, your application program is free to explore that persistent root object normally; e.g., by sending messages. Although the size of the persistent root may be many times the size of available RAM, Magma will page in requested portions and out portions no longer referenced by the program (Magma uses weak collections for its caching, so your program only consumes as much memory as the objects it references).


Proxies are used to truncate the portions of the domain model that are not currently in memory. When a proxy is sent a message, it's #doesNotUnderstand: method is invoked to retrieve the real object from the repository and become the proxy to it – so that all other objects referencing it will not reference the real object.

Write Transparency

Write-transparency is high in that Magma determines new and changed portions of the model automatically. The only requirement is that the application program commit changes to the model via atomic transactions. Transactions are a common semantic in databases for preserving integrity of changes. A number of commit-strategies allow Magma to be suitable for a variety of programs and users.


This level of transparency allows existing objects which have never been designed to reside in a database to reside in Magma. For example, no Morph knows anything about Magma, but Morphs may be stored, shared and collaborated via Magma.