mongoid_denormalize - GitLite

KO | EN

gitlite — search

#hacktoberfest #ai #llm #android #machine-learning #deep-learning #linux #docker #macos #windows #vue #awesome-list #mcp #openai

mongoid_denormalize

(★ 96)

Helper module for denormalizing association attributes in Mongoid models.

파일 탐색기

최종 버전 다운로드 (.zip)

- - version.rb
- - denormalize.rake
  - railtie.rb
- mongoid_denormalize.rb
- mongoid.yml
- mongoid_denormalize_spec.rb
- spec_helper.rb
.gitignore
.rspec
Gemfile
Gemfile.lock
Guardfile
LICENSE
mongoid_denormalize.gemspec
perf.rb
Rakefile
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/logandk/mongoid_denormalize

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd mongoid_denormalize

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Ruby

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Ruby bundle 명령어를 쓰려면 Ruby가 필요합니다.

bundle install

Gemfile에 명시된 루비 라이브러리를 설치합니다.

✅ bundle install이 에러 없이 끝나면 README에 안내된 실행 명령어(예: rails server)로 마저 실행해보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

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](http://www.mongodb.org/display/DOCS/MongoDB+Data+Modeling+and+Rails#MongoDBDataModelingandRails-ANoteonDenormalization)*.

Extracted from [coookin'](http://coookin.com), 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 => "john@doe.com")
    >> comment = Comment.create(:body => "Lorem ipsum...", :user => user)
    >> user.comments << comment
    >> comment.user_name
    "John Doe"
    >> comment.user_email
    "john@doe.com"
    >> 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
    denormalize :name, :from => :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.

You can also use `bundle exec guard` for test driven development, if desired.

A MongoDB server is required to run the specs. Docker is an easy option:

docker run --name mongo3 -d -p 27017:27017 mongo

Contributors
-------
* hubsmoke (https://github.com/hubsmoke)
* Leo Lou (https://github.com/l4u)
* Austin Bales (https://github.com/arbales)
* Isaac Cambron (https://github.com/icambron)
* Shannon Carey (https://github.com/rehevkor5)
* Sebastien Azimi (https://github.com/suruja)
* HuffMoody (https://github.com/HuffMoody)

Credits
-------

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