Sha256: 7046bab068a219c06630b6343e507b124f0c8b41fbd637d10185da76ca51aa7d

Contents?: true

Size: 1.31 KB

Versions: 10

Compression:

Stored size: 1.31 KB

Contents

# encoding: utf-8
module Mongoid # :nodoc:
  module Relations #:nodoc:

    # Superclass for all builder objects. Builders are responsible for either
    # looking up a relation's target from the database, or creating them from a
    # supplied attributes hash.
    class Builder

      attr_reader :metadata, :object, :loading

      # Instantiate the new builder for a relation.
      #
      # @example Create the builder.
      #   Builder.new(metadata, { :field => "value })
      #
      # @param [ Metdata ] metadata The metadata for the relation.
      # @param [ Hash, BSON::ObjectId ] object The attributes to build from or
      #   id to query with.
      #
      # @since 2.0.0.rc.1
      def initialize(metadata, object, loading = false)
        @metadata, @object = metadata, object
        @loading = loading
      end

      protected
      # Do we need to perform a database query? It will be so if the object we
      # have is not a document.
      #
      # @example Should we query the database?
      #   builder.query?
      #
      # @return [ true, false ] Whether a database query should happen.
      #
      # @since 2.0.0.rc.1
      def query?
        return true unless object.respond_to?(:to_a)
        obj = object.to_a.first
        !obj.is_a?(Mongoid::Document) && !obj.nil?
      end
    end
  end
end

Version data entries

10 entries across 10 versions & 1 rubygems

Version Path
mongoid-2.2.0 lib/mongoid/relations/builder.rb
mongoid-2.1.9 lib/mongoid/relations/builder.rb
mongoid-2.1.8 lib/mongoid/relations/builder.rb
mongoid-2.1.7 lib/mongoid/relations/builder.rb
mongoid-2.1.6 lib/mongoid/relations/builder.rb
mongoid-2.1.5 lib/mongoid/relations/builder.rb
mongoid-2.1.4 lib/mongoid/relations/builder.rb
mongoid-2.1.3 lib/mongoid/relations/builder.rb
mongoid-2.1.2 lib/mongoid/relations/builder.rb
mongoid-2.1.1 lib/mongoid/relations/builder.rb