pahagon-mongo-abd 0.14.1

data/lib/mongo/query.rb

@@ -0,0 +1,118 @@
+# --
+# Copyright (C) 2008-2009 10gen Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ++
+
+require 'mongo/collection'
+require 'mongo/message'
+require 'mongo/types/code'
+
+module Mongo
+
+  # A query against a collection. A query's selector is a hash. See the
+  # Mongo documentation for query details.
+  class Query
+
+    attr_accessor :number_to_skip, :number_to_return, :order_by, :snapshot
+    # If true, $explain will be set in QueryMessage that uses this query.
+    attr_accessor :explain
+    # Either +nil+ or a hash (preferably an OrderedHash).
+    attr_accessor :hint
+    attr_reader :selector   # writer defined below
+
+    # sel :: A hash describing the query. See the Mongo docs for details.
+    #
+    # return_fields :: If not +nil+, a single field name or an array of
+    #                  field names. Only those fields will be returned.
+    #                  (Called :fields in calls to Collection#find.)
+    #
+    # number_to_skip :: Number of records to skip before returning
+    #                   records. Default is 0.
+    #
+    # number_to_return :: Max number of records to return. (Called :limit
+    #                     in calls to Collection#find.) Default is 0 (all
+    #                     records).
+    #
+    # order_by :: If not +nil+, specifies record sort order. May be a
+    #             String, Hash, OrderedHash, or Array. If a string, the
+    #             results will be ordered by that field in ascending
+    #             order. If an array, it should be an array of field names
+    #             which will all be sorted in ascending order. If a hash,
+    #             it may be either a regular Hash or an OrderedHash. The
+    #             keys should be field names, and the values should be 1
+    #             (ascending) or -1 (descending). Note that if it is a
+    #             regular Hash then sorting by more than one field
+    #             probably will not be what you intend because key order
+    #             is not preserved. (order_by is called :sort in calls to
+    #             Collection#find.)
+    #
+    # hint :: If not +nil+, specifies query hint fields. Must be either
+    #                +nil+ or a hash (preferably an OrderedHash). See
+    #                Collection#hint.
+    def initialize(sel={}, return_fields=nil, number_to_skip=0, number_to_return=0, order_by=nil, hint=nil, snapshot=nil)
+      @number_to_skip, @number_to_return, @order_by, @hint, @snapshot =
+        number_to_skip, number_to_return, order_by, hint, snapshot
+      @explain = nil
+      self.selector = sel
+      self.fields = return_fields
+    end
+
+    # Set query selector hash. If sel is Code/string, it will be used as a
+    # $where clause. (See Mongo docs for details.)
+    def selector=(sel)
+      @selector = case sel
+                  when nil
+                    {}
+                  when Code
+                    {"$where" => sel}
+                  when String
+                    {"$where" => Code.new(sel)}
+                  when Hash
+                    sel
+                  end
+    end
+
+    # Set fields to return. If +val+ is +nil+ or empty, all fields will be
+    # returned.
+    def fields=(val)
+      @fields = val
+      @fields = nil if @fields && @fields.empty?
+    end
+
+    def fields
+      case @fields
+      when String
+        {@fields => 1}
+      when Array
+        if @fields.length == 0
+          nil
+        else
+          h = {}
+          @fields.each { |field| h[field] = 1 }
+          h
+        end
+      else                  # nil, anything else
+        nil
+      end
+    end
+
+    def contains_special_fields
+      (@order_by != nil && @order_by.length > 0) || @explain || @hint || @snapshot
+    end
+
+    def to_s
+      "find(#{@selector.inspect})" + (@order_by ? ".sort(#{@order_by.inspect})" : "")
+    end
+  end
+end

data/lib/mongo/types/binary.rb

@@ -0,0 +1,38 @@
+# --
+# Copyright (C) 2008-2009 10gen Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ++
+
+require 'mongo/util/byte_buffer'
+
+module Mongo
+
+  # An array of binary bytes with a Mongo subtype value.
+  class Binary < ByteBuffer
+
+    SUBTYPE_BYTES = 0x02
+    SUBTYPE_UUID = 0x03
+    SUBTYPE_MD5 = 0x05
+    SUBTYPE_USER_DEFINED = 0x80
+
+    # One of the SUBTYPE_* constants. Default is SUBTYPE_BYTES.
+    attr_accessor :subtype
+
+    def initialize(initial_data=[], subtype=SUBTYPE_BYTES)
+      super(initial_data)
+      @subtype = subtype
+    end
+
+  end
+end

data/lib/mongo/types/code.rb

@@ -0,0 +1,30 @@
+# --
+# Copyright (C) 2008-2009 10gen Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ++
+
+module Mongo
+
+  # JavaScript code to be evaluated by MongoDB
+  class Code < String
+    # Hash mapping identifiers to their values
+    attr_accessor :scope
+
+    def initialize(code, scope={})
+      super(code)
+      @scope = scope
+    end
+
+  end
+end

data/lib/mongo/types/dbref.rb

@@ -0,0 +1,33 @@
+# --
+# Copyright (C) 2008-2009 10gen Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ++
+
+module Mongo
+
+  class DBRef
+
+    attr_reader :namespace, :object_id
+
+    def initialize(namespace, object_id)
+      @namespace, @object_id =
+        namespace, object_id
+    end
+
+    def to_s
+      "ns: #{namespace}, id: #{object_id}"
+    end
+
+  end
+end

data/lib/mongo/types/objectid.rb

@@ -0,0 +1,143 @@
+# --
+# Copyright (C) 2008-2009 10gen Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ++
+
+require 'mutex_m'
+require 'socket'
+require 'digest/md5'
+
+module Mongo
+
+  # Representation of an ObjectId for Mongo.
+  class ObjectID
+    # This is the legacy byte ordering for Babble. Versions of the Ruby
+    # driver prior to 0.14 used this byte ordering when converting ObjectID
+    # instances to and from strings. If you have string representations of
+    # ObjectIDs using the legacy byte ordering make sure to use the
+    # to_s_legacy and from_string_legacy methods, or convert your strings
+    # with ObjectID#legacy_string_convert
+    BYTE_ORDER = [7, 6, 5, 4, 3, 2, 1, 0, 11, 10, 9, 8]
+
+    LOCK = Object.new
+    LOCK.extend Mutex_m
+
+    @@index = 0
+
+    def self.legal?(str)
+      len = BYTE_ORDER.length * 2
+      str =~ /([0-9a-f]+)/i
+      match = $1
+      str && str.length == len && match == str
+    end
+
+    # +data+ is an array of bytes. If nil, a new id will be generated.
+    def initialize(data=nil)
+      @data = data || generate
+    end
+
+    def eql?(other)
+      @data == other.instance_variable_get("@data")
+    end
+    alias_method :==, :eql?
+
+    def to_a
+      @data.dup
+    end
+
+    # Given a string representation of an ObjectID, return a new ObjectID
+    # with that value.
+    def self.from_string(str)
+      raise "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
+
+    # Create a new ObjectID given a string representation of an ObjectID
+    # using the legacy byte ordering. This method may eventually be
+    # removed. If you are not sure that you need this method you should be
+    # using the regular from_string.
+    def self.from_string_legacy(str)
+      raise "illegal ObjectID format" unless legal?(str)
+      data = []
+      BYTE_ORDER.each_with_index { |string_position, data_index|
+        data[data_index] = str[string_position * 2, 2].to_i(16)
+      }
+      self.new(data)
+    end
+
+    def to_s
+      str = ' ' * 24
+      12.times do |i|
+        str[i * 2, 2] = '%02x' % @data[i]
+      end
+      str
+    end
+
+    def inspect; to_s; end
+
+    # Get a string representation of this ObjectID using the legacy byte
+    # ordering. This method may eventually be removed. If you are not sure
+    # that you need this method you should be using the regular to_s.
+    def to_s_legacy
+      str = ' ' * 24
+      BYTE_ORDER.each_with_index { |string_position, data_index|
+        str[string_position * 2, 2] = '%02x' % @data[data_index]
+      }
+      str
+    end
+
+    # Convert a string representation of an ObjectID using the legacy byte
+    # ordering to the proper byte ordering. This method may eventually be
+    # removed. If you are not sure that you need this method it is probably
+    # unnecessary.
+    def self.legacy_string_convert(str)
+      legacy = ' ' * 24
+      BYTE_ORDER.each_with_index do |legacy_pos, pos|
+        legacy[legacy_pos * 2, 2] = str[pos * 2, 2]
+      end
+      legacy
+    end
+
+    private
+
+    def generate
+      oid = ''
+
+      # 4 bytes current time
+      time = Time.new.to_i
+      oid += [time].pack("N")
+
+      # 3 bytes machine
+      oid += Digest::MD5.digest(Socket.gethostname)[0, 3]
+
+      # 2 bytes pid
+      oid += [Process.pid % 0xFFFF].pack("n")
+
+      # 3 bytes inc
+      oid += [get_inc].pack("N")[1, 3]
+
+      oid.unpack("C12")
+    end
+
+    def get_inc
+      LOCK.mu_synchronize {
+        @@index = (@@index + 1) % 0xFFFFFF
+      }
+    end
+  end
+end

data/lib/mongo/types/regexp_of_holding.rb

@@ -0,0 +1,40 @@
+# --
+# Copyright (C) 2008-2009 10gen Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ++
+
+module Mongo
+
+  # A Regexp that can hold on to extra options and ignore them. Mongo
+  # regexes may contain option characters beyond 'i', 'm', and 'x'. (Note
+  # that Mongo only uses those three, but that regexes coming from other
+  # languages may store different option characters.)
+  #
+  # Note that you do not have to use this class at all if you wish to
+  # store regular expressions in Mongo. The Mongo and Ruby regex option
+  # flags are the same. Storing regexes is discouraged, in any case.
+  class RegexpOfHolding < Regexp
+
+    attr_accessor :extra_options_str
+
+    # +str+ and +options+ are the same as Regexp. +extra_options_str+
+    # contains all the other flags that were in Mongo but we do not use or
+    # understand.
+    def initialize(str, options, extra_options_str)
+      super(str, options)
+      @extra_options_str = extra_options_str
+    end
+  end
+
+end

data/lib/mongo/util/bson.rb

@@ -0,0 +1,546 @@
+# --
+# Copyright (C) 2008-2009 10gen Inc.
+#
+# This program is free software: you can redistribute it and/or modify it
+# under the terms of the GNU Affero General Public License, version 3, as
+# published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License
+# for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <http://www.gnu.org/licenses/>.
+# ++
+
+require 'base64'
+require 'mongo/util/byte_buffer'
+require 'mongo/util/ordered_hash'
+require 'mongo/types/binary'
+require 'mongo/types/dbref'
+require 'mongo/types/objectid'
+require 'mongo/types/regexp_of_holding'
+
+# A BSON seralizer/deserializer.
+class BSON
+
+  include Mongo
+
+  MINKEY = -1
+  EOO = 0
+  NUMBER = 1
+  STRING = 2
+  OBJECT = 3
+  ARRAY = 4
+  BINARY = 5
+  UNDEFINED = 6
+  OID = 7
+  BOOLEAN = 8
+  DATE = 9
+  NULL = 10
+  REGEX = 11
+  REF = 12
+  CODE = 13
+  SYMBOL = 14
+  CODE_W_SCOPE = 15
+  NUMBER_INT = 16
+  TIMESTAMP = 17
+  NUMBER_LONG = 18
+  MAXKEY = 127
+
+  if RUBY_VERSION >= '1.9'
+    def self.to_utf8(str)
+      str.encode("utf-8")
+    end
+  else
+    def self.to_utf8(str)
+      str                       # TODO Ruby 1.8 punt for now
+    end
+  end
+
+  def self.serialize_cstr(buf, val)
+    buf.put_array(to_utf8(val.to_s).unpack("C*") + [0])
+  end
+
+  def initialize()
+    @buf = ByteBuffer.new
+  end
+
+  def to_a
+    @buf.to_a
+  end
+
+  begin
+    require 'mongo_ext/cbson'
+    def serialize(obj, check_keys=false)
+      @buf = ByteBuffer.new(CBson.serialize(obj, check_keys))
+    end
+  rescue LoadError
+    def serialize(obj, check_keys=false)
+      raise "Document is null" unless obj
+
+      @buf.rewind
+      # put in a placeholder for the total size
+      @buf.put_int(0)
+
+      # Write key/value pairs. Always write _id first if it exists.
+      if obj.has_key? '_id'
+        serialize_key_value('_id', obj['_id'], check_keys)
+      elsif obj.has_key? :_id
+        serialize_key_value('_id', obj[:_id], check_keys)
+      end
+
+      obj.each {|k, v| serialize_key_value(k, v, check_keys) unless k == '_id' || k == :_id }
+
+      serialize_eoo_element(@buf)
+      @buf.put_int(@buf.size, 0)
+      self
+    end
+  end
+
+  def serialize_key_value(k, v, check_keys)
+    k = k.to_s
+    if check_keys
+      if k[0] == ?$
+        raise InvalidName.new("key #{k} must not start with '$'")
+      end
+      if k.include? ?.
+        raise InvalidName.new("key #{k} must not contain '.'")
+      end
+    end
+    type = bson_type(v)
+    case type
+    when STRING, SYMBOL
+      serialize_string_element(@buf, k, v, type)
+    when NUMBER, NUMBER_INT
+      serialize_number_element(@buf, k, v, type)
+    when OBJECT
+      serialize_object_element(@buf, k, v, check_keys)
+    when OID
+      serialize_oid_element(@buf, k, v)
+    when ARRAY
+      serialize_array_element(@buf, k, v, check_keys)
+    when REGEX
+      serialize_regex_element(@buf, k, v)
+    when BOOLEAN
+      serialize_boolean_element(@buf, k, v)
+    when DATE
+      serialize_date_element(@buf, k, v)
+    when NULL
+      serialize_null_element(@buf, k)
+    when REF
+      serialize_dbref_element(@buf, k, v)
+    when BINARY
+      serialize_binary_element(@buf, k, v)
+    when UNDEFINED
+      serialize_null_element(@buf, k)
+    when CODE_W_SCOPE
+      serialize_code_w_scope(@buf, k, v)
+    else
+      raise "unhandled type #{type}"
+    end
+  end
+
+  begin
+    require 'mongo_ext/cbson'
+    def deserialize(buf=nil)
+      if buf.is_a? String
+        @buf = ByteBuffer.new(buf) if buf
+      else
+        @buf = ByteBuffer.new(buf.to_a) if buf
+      end
+      @buf.rewind
+      CBson.deserialize(@buf.to_s)
+    end
+  rescue LoadError
+    def deserialize(buf=nil)
+      # If buf is nil, use @buf, assumed to contain already-serialized BSON.
+      # This is only true during testing.
+      if buf.is_a? String
+        @buf = ByteBuffer.new(buf) if buf
+      else
+        @buf = ByteBuffer.new(buf.to_a) if buf
+      end
+      @buf.rewind
+      @buf.get_int                # eat message size
+      doc = OrderedHash.new
+      while @buf.more?
+        type = @buf.get
+        case type
+        when STRING, CODE
+          key = deserialize_cstr(@buf)
+          doc[key] = deserialize_string_data(@buf)
+        when SYMBOL
+          key = deserialize_cstr(@buf)
+          doc[key] = deserialize_string_data(@buf).intern
+        when NUMBER
+          key = deserialize_cstr(@buf)
+          doc[key] = deserialize_number_data(@buf)
+        when NUMBER_INT
+          key = deserialize_cstr(@buf)
+          doc[key] = deserialize_number_int_data(@buf)
+        when NUMBER_LONG
+          key = deserialize_cstr(@buf)
+          doc[key] = deserialize_number_long_data(@buf)
+        when OID
+          key = deserialize_cstr(@buf)
+          doc[key] = deserialize_oid_data(@buf)
+        when ARRAY
+          key = deserialize_cstr(@buf)
+          doc[key] = deserialize_array_data(@buf)
+        when REGEX
+          key = deserialize_cstr(@buf)
+          doc[key] = deserialize_regex_data(@buf)
+        when OBJECT
+          key = deserialize_cstr(@buf)
+          doc[key] = deserialize_object_data(@buf)
+        when BOOLEAN
+          key = deserialize_cstr(@buf)
+          doc[key] = deserialize_boolean_data(@buf)
+        when DATE
+          key = deserialize_cstr(@buf)
+          doc[key] = deserialize_date_data(@buf)
+        when NULL
+          key = deserialize_cstr(@buf)
+          doc[key] = nil
+        when UNDEFINED
+          key = deserialize_cstr(@buf)
+          doc[key] = nil
+        when REF
+          key = deserialize_cstr(@buf)
+          doc[key] = deserialize_dbref_data(@buf)
+        when BINARY
+          key = deserialize_cstr(@buf)
+          doc[key] = deserialize_binary_data(@buf)
+        when CODE_W_SCOPE
+          key = deserialize_cstr(@buf)
+          doc[key] = deserialize_code_w_scope_data(@buf)
+        when TIMESTAMP
+          key = deserialize_cstr(@buf)
+          doc[key] = [deserialize_number_int_data(@buf),
+                      deserialize_number_int_data(@buf)]
+        when EOO
+          break
+        else
+          raise "Unknown type #{type}, key = #{key}"
+        end
+      end
+      @buf.rewind
+      doc
+    end
+  end
+
+  # For debugging.
+  def hex_dump
+    str = ''
+    @buf.to_a.each_with_index { |b,i|
+      if (i % 8) == 0
+        str << "\n" if i > 0
+        str << '%4d:  ' % i
+      else
+        str << ' '
+      end
+      str << '%02X' % b
+    }
+    str
+  end
+
+  def deserialize_date_data(buf)
+    unsigned = buf.get_long()
+    # see note for deserialize_number_long_data below
+    milliseconds = unsigned >= 2 ** 64 / 2 ? unsigned - 2**64 : unsigned
+    Time.at(milliseconds.to_f / 1000.0).utc # at() takes fractional seconds
+  end
+
+  def deserialize_boolean_data(buf)
+    buf.get == 1
+  end
+
+  def deserialize_number_data(buf)
+    buf.get_double
+  end
+
+  def deserialize_number_int_data(buf)
+    # sometimes ruby makes me angry... why would the same code pack as signed
+    # but unpack as unsigned
+    unsigned = buf.get_int
+    unsigned >= 2**32 / 2 ? unsigned - 2**32 : unsigned
+  end
+
+  def deserialize_number_long_data(buf)
+    # same note as above applies here...
+    unsigned = buf.get_long
+    unsigned >= 2 ** 64 / 2 ? unsigned - 2**64 : unsigned
+  end
+
+  def deserialize_object_data(buf)
+    size = buf.get_int
+    buf.position -= 4
+    object = BSON.new().deserialize(buf.get(size))
+    if object.has_key? "$ref"
+      DBRef.new(object["$ref"], object["$id"])
+    else
+      object
+    end
+  end
+
+  def deserialize_array_data(buf)
+    h = deserialize_object_data(buf)
+    a = []
+    h.each { |k, v| a[k.to_i] = v }
+    a
+  end
+
+  def deserialize_regex_data(buf)
+    str = deserialize_cstr(buf)
+    options_str = deserialize_cstr(buf)
+    options = 0
+    options |= Regexp::IGNORECASE if options_str.include?('i')
+    options |= Regexp::MULTILINE if options_str.include?('m')
+    options |= Regexp::EXTENDED if options_str.include?('x')
+    options_str.gsub!(/[imx]/, '') # Now remove the three we understand
+    RegexpOfHolding.new(str, options, options_str)
+  end
+
+  def deserialize_string_data(buf)
+    len = buf.get_int
+    bytes = buf.get(len)
+    str = bytes[0..-2]
+    if str.respond_to? "pack"
+      str = str.pack("C*")
+    end
+    if RUBY_VERSION >= '1.9'
+      str.force_encoding("utf-8")
+    end
+    str
+  end
+
+  def deserialize_code_w_scope_data(buf)
+    buf.get_int
+    len = buf.get_int
+    code = buf.get(len)[0..-2]
+    if code.respond_to? "pack"
+      code = code.pack("C*")
+    end
+    if RUBY_VERSION >= '1.9'
+      code.force_encoding("utf-8")
+    end
+
+    scope_size = buf.get_int
+    buf.position -= 4
+    scope = BSON.new().deserialize(buf.get(scope_size))
+
+    Code.new(code, scope)
+  end
+
+  def deserialize_oid_data(buf)
+    ObjectID.new(buf.get(12))
+  end
+
+  def deserialize_dbref_data(buf)
+    ns = deserialize_string_data(buf)
+    oid = deserialize_oid_data(buf)
+    DBRef.new(ns, oid)
+  end
+
+  def deserialize_binary_data(buf)
+    len = buf.get_int
+    type = buf.get
+    len = buf.get_int if type == Binary::SUBTYPE_BYTES
+    Binary.new(buf.get(len), type)
+  end
+
+  def serialize_eoo_element(buf)
+    buf.put(EOO)
+  end
+
+  def serialize_null_element(buf, key)
+    buf.put(NULL)
+    self.class.serialize_cstr(buf, key)
+  end
+
+  def serialize_dbref_element(buf, key, val)
+    oh = OrderedHash.new
+    oh['$ref'] = val.namespace
+    oh['$id'] = val.object_id
+    serialize_object_element(buf, key, oh, false)
+  end
+
+  def serialize_binary_element(buf, key, val)
+    buf.put(BINARY)
+    self.class.serialize_cstr(buf, key)
+
+    bytes = val.to_a
+    num_bytes = bytes.length
+    subtype = val.respond_to?(:subtype) ? val.subtype : Binary::SUBTYPE_BYTES
+    if subtype == Binary::SUBTYPE_BYTES
+      buf.put_int(num_bytes + 4)
+      buf.put(subtype)
+      buf.put_int(num_bytes)
+      buf.put_array(bytes)
+    else
+      buf.put_int(num_bytes)
+      buf.put(subtype)
+      buf.put_array(bytes)
+    end
+  end
+
+  def serialize_boolean_element(buf, key, val)
+    buf.put(BOOLEAN)
+    self.class.serialize_cstr(buf, key)
+    buf.put(val ? 1 : 0)
+  end
+
+  def serialize_date_element(buf, key, val)
+    buf.put(DATE)
+    self.class.serialize_cstr(buf, key)
+    millisecs = (val.to_f * 1000).to_i
+    buf.put_long(millisecs)
+  end
+
+  def serialize_number_element(buf, key, val, type)
+    if type == NUMBER
+      buf.put(type)
+      self.class.serialize_cstr(buf, key)
+      buf.put_double(val)
+    else
+      if val > 2**64 / 2 - 1 or val < -2**64 / 2
+        raise RangeError.new("MongoDB can only handle 8-byte ints")
+      end
+      if val > 2**32 / 2 - 1 or val < -2**32 / 2
+        buf.put(NUMBER_LONG)
+        self.class.serialize_cstr(buf, key)
+        buf.put_long(val)
+      else
+        buf.put(type)
+        self.class.serialize_cstr(buf, key)
+        buf.put_int(val)
+      end
+    end
+  end
+
+  def serialize_object_element(buf, key, val, check_keys, opcode=OBJECT)
+    buf.put(opcode)
+    self.class.serialize_cstr(buf, key)
+    buf.put_array(BSON.new.serialize(val, check_keys).to_a)
+  end
+
+  def serialize_array_element(buf, key, val, check_keys)
+    # Turn array into hash with integer indices as keys
+    h = OrderedHash.new
+    i = 0
+    val.each { |v| h[i] = v; i += 1 }
+    serialize_object_element(buf, key, h, check_keys, ARRAY)
+  end
+
+  def serialize_regex_element(buf, key, val)
+    buf.put(REGEX)
+    self.class.serialize_cstr(buf, key)
+
+    str = val.to_s.sub(/.*?:/, '')[0..-2] # Turn "(?xxx:yyy)" into "yyy"
+    self.class.serialize_cstr(buf, str)
+
+    options = val.options
+    options_str = ''
+    options_str << 'i' if ((options & Regexp::IGNORECASE) != 0)
+    options_str << 'm' if ((options & Regexp::MULTILINE) != 0)
+    options_str << 'x' if ((options & Regexp::EXTENDED) != 0)
+    options_str << val.extra_options_str if val.respond_to?(:extra_options_str)
+    # Must store option chars in alphabetical order
+    self.class.serialize_cstr(buf, options_str.split(//).sort.uniq.join)
+  end
+
+  def serialize_oid_element(buf, key, val)
+    buf.put(OID)
+    self.class.serialize_cstr(buf, key)
+
+    buf.put_array(val.to_a)
+  end
+
+  def serialize_string_element(buf, key, val, type)
+    buf.put(type)
+    self.class.serialize_cstr(buf, key)
+
+    # Make a hole for the length
+    len_pos = buf.position
+    buf.put_int(0)
+
+    # Save the string
+    start_pos = buf.position
+    self.class.serialize_cstr(buf, val)
+    end_pos = buf.position
+
+    # Put the string size in front
+    buf.put_int(end_pos - start_pos, len_pos)
+
+    # Go back to where we were
+    buf.position = end_pos
+  end
+
+  def serialize_code_w_scope(buf, key, val)
+    buf.put(CODE_W_SCOPE)
+    self.class.serialize_cstr(buf, key)
+
+    # Make a hole for the length
+    len_pos = buf.position
+    buf.put_int(0)
+
+    buf.put_int(val.length + 1)
+    self.class.serialize_cstr(buf, val)
+    buf.put_array(BSON.new.serialize(val.scope).to_a)
+
+    end_pos = buf.position
+    buf.put_int(end_pos - len_pos, len_pos)
+    buf.position = end_pos
+  end
+
+  def deserialize_cstr(buf)
+    chars = ""
+    while true
+      b = buf.get
+      break if b == 0
+      chars << b.chr
+    end
+    if RUBY_VERSION >= '1.9'
+      chars.force_encoding("utf-8") # Mongo stores UTF-8
+    end
+    chars
+  end
+
+  def bson_type(o)
+    case o
+    when nil
+      NULL
+    when Integer
+      NUMBER_INT
+    when Numeric
+      NUMBER
+    when ByteBuffer
+      BINARY
+    when Code
+      CODE_W_SCOPE
+    when String
+      STRING
+    when Array
+      ARRAY
+    when Regexp
+      REGEX
+    when ObjectID
+      OID
+    when DBRef
+      REF
+    when true, false
+      BOOLEAN
+    when Time
+      DATE
+    when Hash
+      OBJECT
+    when Symbol
+      SYMBOL
+    else
+      raise "Unknown type of object: #{o.class.name}"
+    end
+  end
+
+end