mongo_persist

Library to add MongoDB Persistance to normal Ruby objects

Example

class Order

include MongoPersist
attr_accessor :po_number
fattr(:order_products) { [] }
def products
  order_products.map { |x| x.product }
end

end

class OrderProduct

include MongoPersist
attr_accessor :unit_price, :quantity, :product
mongo_reference_attributes ['product']

end

class Product

include MongoPersist
attr_accessor :name

end

products = [Product.new(:name => ‘Leather Couch’),Product.new(:name => ‘Maroon Chair’)].each { |x| x.mongo_save! }

orders = [] orders << Order.new(:po_number => 1234, :order_products => [OrderProduct.new(:unit_price => 1000, :quantity => 1, :product => products)]).mongo_save! orders << Order.new(:po_number => 1235, :order_products => [OrderProduct.new(:unit_price => 200, :quantity => 2, :product => products)]).mongo_save!

# objects are saved to MongoDB as JSON objects

# get all order objects back from Mongo # you get back the ruby objects you put in, not raw JSON objects Order.collection.find_objects

# Since on OrderProduct, the product attribute was marked as a reference attribute, the product is stored in MongoDB only as a reference to the product obj # When you read the Order/OrderProduct back out, MongoPersist takes care of fetching the Product object again. You don’t have to do anything. Order.collection.find_one_object.products.first # An object of class Product Order.collection.find_one_object.products.first.name # Leather Couch

# Because the product is stored as a reference, if you update that product elsewhere and save to Mongo, later reads of Orders with that product will be correctly updated products.name = ‘White Leather Couch’ products.mongo_save! Order.collection.find_one_object.products.first.name # White Leather Couch

Note on Patches/Pull Requests

  • Fork the project.

  • Make your feature addition or bug fix.

  • Add tests for it. This is important so I don’t break it in a future version unintentionally.

  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but

    bump version in a commit by itself I can ignore when I pull)
    
  • Send me a pull request. Bonus points for topic branches.

Copyright © 2009 Mike Harris. See LICENSE for details.