Giter Club home page Giter Club logo

mongoid_denormalize's Introduction

Mongoid::Denormalize

Note: I am no longer actively maintaining this module, and I do not know whether it is compatible with newer versions of mongoid. If you would like to take ownership of this repository, please let me know.

Helper module for denormalizing association attributes in Mongoid models. Why denormalize? Read A Note on Denormalization.

Extracted from coookin', where it is used in production.

Installation

Add the gem to your Bundler Gemfile:

gem 'mongoid_denormalize'

Or install with RubyGems:

$ gem install mongoid_denormalize

Usage

In your model:

# Include the helper method
include Mongoid::Denormalize

# Define your denormalized fields
denormalize :name, :email, :from => :user

Example

class User
  include Mongoid::Document
  include Mongoid::Denormalize

  has_many :comments
  has_many :moderated_comments, :class_name => "Comment", :inverse_of => :moderator

  field :name
  field :email
  
  denormalize :name, :email, :to => :comments
end

class Comment
  include Mongoid::Document
  include Mongoid::Denormalize

  belongs_to :user
  belongs_to :moderator, :class_name => "User", :inverse_of => :moderated_comments

  field :body
  
  denormalize :name, :email, :from => :user
end

>> user = User.create(:name => "John Doe", :email => "[email protected]")
>> comment = Comment.create(:body => "Lorem ipsum...", :user => user)
>> user.comments << comment
>> comment.user_name
"John Doe"
>> comment.user_email
"[email protected]"
>> user.update_attributes(:name => "Bill")
>> comment.user_name
"Bill"

Options

Denormalization can happen in either or both directions. When using the :from option, the associated objects will fetch the values from the parent. When using the :to option, the parent will push the values to its children.

# Basic denormalization. Will set the user_name attribute of "self.comments" to the value of "self.name".
denormalize :name, :to => :comments

# Multiple children. Will set the user_name attribute of "self.posts" and "self.comments" with "self.name".
denormalize :name, :to => [:posts, :comments]

# Basic denormalization, obeying :inverse_of. Will set the moderator_name attribute of "self.moderated_comments"
denormalize :name, :email, :to => :moderated_comments

# With custom field name prefix. Will set the commenter_name attribute of "self.comments" (takes precedence over
# inverse_of).
denormalize :name, :to => :comments, :as => :commenter

# Basic denormalization. Will set the user_name attribute with the associated user's name.
denormalize :name, :from => :user

# Multiple fields. Will set the user_name and user_email attributes with the associated user's name and email.
denormalize :name, :email, :from => :user

# Basic denormalization. Will set the moderator_name attribute with the associated author user's name.
denormalize :name, :from => :moderator

When using :from, if the type of the denormalized field is anything but String (the default), you must specify the type with the :type option.

# in User
field :location, :type => Array
denormalize :location, :to => :posts

# in Post
denormalize :location, :type => Array, :from => :user

A few notes on behavior:

:from denormalizations are processed as before_save callbacks.

:to denormalizations are processed as after_save callbacks.

With :to, validations are not run on the object(s) containing the denormalized field(s) when they are saved.

Rake tasks

A rake task is included for verifying and repairing inconsistent denormalizations. This might be useful your records may be modified without Mongoid, or if you are using relational associations in combination with embedded records (see Known issues).

rake db:denormalize

This task will only update records that have outdated denormalized fields.

Known issues

Relational associations in combination with embedded records

It is not recommended nor supported to use mongoid_denormalize to perform denormalization to embedded records through a relational association because MongoDB/Mongoid do not support direct access to embedded fields via a relational association.

So, if User has_many :posts and User has_many :comments, but Comments are embedded_in :post, a user can't directly access a comment.

Contributing

Clone the repository and run Bundler with bundle install. Use rake -T to view available rake tasks.

Contributors

Credits

Copyright (c) 2010 Logan Raarup, released under the MIT license.

mongoid_denormalize's People

Contributors

logandk avatar hubsmoke avatar suruja avatar rehevkor5 avatar icambron avatar jbbarth avatar l4u avatar arbales avatar chrishol avatar

Watchers

James Cloos avatar Brendan Stennett avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.