Class: BSON::ObjectID
- Inherits:
-
Object
- Object
- BSON::ObjectID
- Defined in:
- lib/bson/types/objectid.rb
Overview
Generates MongoDB object ids.
Constant Summary collapse
- @@lock =
Mutex.new
- @@index =
0
Class Method Summary collapse
-
.create_pk(doc) ⇒ Mongo::ObjectID, Object
Adds a primary key to the given document if needed.
-
.from_string(str) ⇒ Mongo::ObjectID
Given a string representation of an ObjectID, return a new ObjectID with that value.
-
.from_time(time) ⇒ Mongo::ObjectID
Create an object id from the given time.
-
.legal?(str) ⇒ Boolean
Determine if the supplied string is legal.
Instance Method Summary collapse
-
#eql?(object_id) ⇒ Boolean
(also: #==)
Check equality of this object id with another.
-
#generation_time ⇒ Time
Return the UTC time at which this ObjectID was generated.
-
#hash ⇒ Integer
Get a unique hashcode for this object.
-
#initialize(data = nil) ⇒ ObjectID
constructor
Create a new object id.
- #inspect ⇒ Object
-
#to_a ⇒ Array
Get an array representation of the object id.
-
#to_json(escaped = false) ⇒ String
Convert to MongoDB extended JSON format.
-
#to_s ⇒ String
Get a string representation of this object id.
Constructor Details
#initialize(data = nil) ⇒ ObjectID
Create a new object id. If no parameter is given, an id corresponding to the ObjectID BSON data type will be created. This is a 12-byte value consisting of a 4-byte timestamp, a 3-byte machine id, a 2-byte process id, and a 3-byte counter.
43 44 45 |
# File 'lib/bson/types/objectid.rb', line 43 def initialize(data=nil) @data = data || generate end |
Class Method Details
.create_pk(doc) ⇒ Mongo::ObjectID, Object
Adds a primary key to the given document if needed.
82 83 84 |
# File 'lib/bson/types/objectid.rb', line 82 def self.create_pk(doc) doc.has_key?(:_id) || doc.has_key?('_id') ? doc : doc.merge!(:_id => self.new) end |
.from_string(str) ⇒ Mongo::ObjectID
Given a string representation of an ObjectID, return a new ObjectID with that value.
115 116 117 118 119 120 121 122 |
# File 'lib/bson/types/objectid.rb', line 115 def self.from_string(str) raise InvalidObjectID, "illegal ObjectID format" unless legal?(str) data = [] 12.times do |i| data[i] = str[i * 2, 2].to_i(16) end self.new(data) end |
.from_time(time) ⇒ Mongo::ObjectID
Create an object id from the given time. This is useful for doing range queries; it works because MongoDB’s object ids begin with a timestamp.
72 73 74 |
# File 'lib/bson/types/objectid.rb', line 72 def self.from_time(time) self.new([time.to_i,0,0].pack("NNN").unpack("C12")) end |
.legal?(str) ⇒ Boolean
Determine if the supplied string is legal. Legal strings will consist of 24 hexadecimal characters.
53 54 55 56 57 58 |
# File 'lib/bson/types/objectid.rb', line 53 def self.legal?(str) len = 24 str =~ /([0-9a-f]+)/i match = $1 str && str.length == len && match == str end |
Instance Method Details
#eql?(object_id) ⇒ Boolean Also known as: ==
Check equality of this object id with another.
89 90 91 |
# File 'lib/bson/types/objectid.rb', line 89 def eql?(object_id) @data == object_id.instance_variable_get("@data") end |
#generation_time ⇒ Time
Return the UTC time at which this ObjectID was generated. This may be used in lieu of a created_at timestamp since this information is always encoded in the object id.
152 153 154 |
# File 'lib/bson/types/objectid.rb', line 152 def generation_time Time.at(@data.pack("C4").unpack("N")[0]).utc end |
#hash ⇒ Integer
Get a unique hashcode for this object. This is required since we’ve defined an #eql? method.
98 99 100 |
# File 'lib/bson/types/objectid.rb', line 98 def hash @data.hash end |
#inspect ⇒ Object
135 136 137 |
# File 'lib/bson/types/objectid.rb', line 135 def inspect "BSON::ObjectID('#{to_s}')" end |
#to_a ⇒ Array
Get an array representation of the object id.
105 106 107 |
# File 'lib/bson/types/objectid.rb', line 105 def to_a @data.dup end |
#to_json(escaped = false) ⇒ String
Convert to MongoDB extended JSON format. Since JSON includes type information, but lacks an ObjectID type, this JSON format encodes the type using an $oid key.
143 144 145 |
# File 'lib/bson/types/objectid.rb', line 143 def to_json(escaped=false) "{\"$oid\": \"#{to_s}\"}" end |
#to_s ⇒ String
Get a string representation of this object id.
127 128 129 130 131 132 133 |
# File 'lib/bson/types/objectid.rb', line 127 def to_s str = ' ' * 24 12.times do |i| str[i * 2, 2] = '%02x' % @data[i] end str end |