mm_uses_uuid 0.0.6 → 0.0.8

data/README.md

@@ -61,15 +61,36 @@ class Group
   
   many :people, :class_name => 'Person'
   
-  uuid_lsn 0xf
+  uuid_lsn 0x0
 end
 ```
 
-Once this value is set you can use `MongoMapper.find_by_uuid(...)` to find by id (or a list of ids) and it will automatically detect the class by inspecting
-the last character of the UUIDs you pass. So for the example above, all UUIDs generated for new Group objects will end in 'f'
-and, if you pass a UUID ending in 'f' to `MongoMapper.find`, it will pass that request on to `Group.find()`.
+Once this value is set you can use `UuidModel.find(...)` to find by id (or a list of ids) and it will automatically detect the class by inspecting
+the last character of the UUIDs you pass. So for the example above, all UUIDs generated for new Group objects will end in '0'
+and, if you pass a UUID ending in '0' to `UuidModel.find`, it will pass that request on to `Group.find()`. Clearly, this method only allows you
+to target 16 collections at most as the last nibble can only have values of 0 to 15.
+
+This method can be useful if you need to implement a polymorphic many-to-many association but you don't want to use [Single Collection Inheritance][1]
+because the polymorphic values have significantly different behaviours and attributes. The following example shows how to do this:
 
-This method can be useful if you need to store long lists of ids, but don't want to incur any additional complexity and storage by storing
-the collection name as well. However, because we only use one nibble, this method can only be used for 16 distinct collections.
+```
+class Person
+  include MongoMapper::Document
+  plugin  MmUsesUuid
+  
+  key :name
+  key :age
+  
+  key  :interest_ids, Array
+  many :interests, :in => :interest_ids, :class_name => 'UuidModel' #values can be a Group or a Person
+  
+  belongs_to :group
+  
+  uuid_lsn 0xf
+end
+```
 
 Copyright (c) 2011 PeepAll Ltd, released under the MIT license
+
+
+[1]: http://mongomapper.com/documentation/plugins/single-collection-inheritance.html

data/lib/mm_uses_uuid/version.rb

@@ -1,3 +1,3 @@
 module MmUsesUuid
-  VERSION = "0.0.6"
+  VERSION = "0.0.8"
 end

data/lib/mm_uses_uuid.rb

@@ -19,11 +19,26 @@ class BsonUuid
   end
 end
 
-module MongoMapper
+class MongoMapper::Plugins::Associations::InArrayProxy
+
+  def find_target
+    return [] if ids.blank?
+    if klass == UuidModel
+      UuidModel.find(*criteria[:_id])
+    else
+      all
+    end
+  end
+  
+end
+
+class UuidModel
+  
+  include MongoMapper::Document
   
   @@lsn_class ||= []
   
-  def self.find_by_uuid(*args)
+  def self.find(*args)
     args.flatten!
     ids_by_class = {}
     args.each do |id|
@@ -35,7 +50,7 @@ module MongoMapper
     end
     ids_by_class.map {|klass, ids| klass.find(ids)} .flatten
   end
-  
+
 end
 
 module MmUsesUuid
@@ -75,7 +90,7 @@ module MmUsesUuid
     end
     
     def add_class_lsn(klass, lsn_integer)
-      MongoMapper.class_eval "@@lsn_class[#{lsn_integer}] = #{klass}"
+      UuidModel.class_eval "@@lsn_class[#{lsn_integer}] = #{klass}"
     end
 
   end
@@ -111,7 +126,7 @@ module MmUsesUuid
     
     def make_uuid
       uuid = SecureRandom.uuid.gsub!('-', '')
-      lsn_class = MongoMapper.class_variable_get('@@lsn_class')
+      lsn_class = UuidModel.class_variable_get('@@lsn_class')
       if replacement_lsn = lsn_class.index(self.class)
         uuid[-1] = replacement_lsn.to_s(16)
       end

data/spec/mm_uses_uuid_spec.rb

@@ -21,6 +21,9 @@ describe MmUsesUuid do
       key :name
       key :age
       
+      key  :interest_ids, Array
+      many :interests, :in => :interest_ids, :class_name => 'UuidModel' # this allows many-to-many polymorphic interests without the need for groups and people to be stored in a single collection
+      
       belongs_to :group
       
       uuid_lsn 0xf
@@ -43,7 +46,11 @@ describe MmUsesUuid do
       "33333333-3333-4333-y333-333333333333"
     )
     @group  = Group.create(name: 'mongo_mapper fanclub')
-    @person = Person.create(name: 'Jon', age: 33)
+    
+    @person = Person.new(name: 'Jon', age: 33)
+    @person.interests << @group
+    @person.interests << @person #I'm very self-centred
+    @person.save
   end
   
   it "should cause newly initialized objects to have a BSON::Binary uuid" do
@@ -57,7 +64,12 @@ describe MmUsesUuid do
   end
 
   it "should perform a find on the right collection if MongoMapper.find is used" do
-    MongoMapper.find_by_uuid(@person.id, @group.id).map(&:name).should include(@person.name, @group.name)
+    UuidModel.find(@person.id, @group.id).map(&:name).should include(@person.name, @group.name)
+  end
+  
+  it "should support polymorphic many to many associations that use LSN encoding" do
+    person = Person.find_by_name 'Jon'
+    person.interests.map(&:name).should include(@person.name, @group.name)
   end
 
   it "should not set a new uuid if one as passed as a param" do

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 0
-  - 6
-  version: 0.0.6
+  - 8
+  version: 0.0.8
 platform: ruby
 authors: 
 - Jonathan Chambers