Permalink
Switch branches/tags
Nothing to show
Find file
Fetching contributors…
Cannot retrieve contributors at this time
41 lines (27 sloc) 1.31 KB
= merb_datamapper
A plugin for the Merb framework that provides DataMapper access
== Features
* Automatic connection to a data-store through DataMapper, via database.yml
* Easy use of multiple repositories.
* Generators for models, controllers and migrations.
* Sessions stored in a data-store managed by DataMapper
* wraps actions in DataMapper repository blocks, to enable the IdentityMap
=== Sessions
To use sessions:
1. set the session store to datamapper in init.rb:
Merb::Config.use { |c|
c[:session_store] = 'datamapper'
}
2. add the dependency in init.rb:
use_orm :datamapper
Sessions can be configured by a few plugin options:
[:session_storage_name] The name of the table to use to store the sessions (defaults to 'session')
[:session_repository_name] The repository to use for sessions. (defaults to <tt>:default</tt>)
=== Repository Blocks
Repository Blocks are a DataMapper feature, which enables the use of the
DataMapper IdentityMap, which can help with certain DataMapper features such as
strategic eager loading. Read on http://www.datamapper.org for more information
on these features.
If, for whatever reason, it doesn't suit you, it can be disabled via setting the
<tt>:use_reposity_block</tt> option to <tt>false</tt>.
Merb::Plugins[:merb_datamapper][:use_reposity_block] = false