mongo 1.12.5 → 2.0.0.beta

data/lib/mongo/operation/kill_cursors.rb

@@ -0,0 +1,39 @@
+# Copyright (C) 2014-2015 MongoDB, 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
+  module Operation
+
+    # A MongoDB kill cursors operation.
+    #
+    # @example Create the kill cursors operation.
+    #   Mongo::Operation::KillCursor.new({ :cursor_ids => [1, 2] })
+    #
+    # @param [ Hash ] spec The specifications for the operation.
+    #
+    # @option spec :cursor_ids [ Array ] The ids of cursors to kill.
+    #
+    # @since 2.0.0
+    class KillCursors
+      include Executable
+      include Specifiable
+
+      private
+
+      def message
+        Protocol::KillCursors.new(cursor_ids)
+      end
+    end
+  end
+end

data/lib/mongo/operation/limited.rb

@@ -0,0 +1,37 @@
+# Copyright (C) 2014-2015 MongoDB, 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
+  module Operation
+
+    # Adds behaviour for commands so ensure the limit option is always -1.
+    #
+    # @since 2.0.0
+    module Limited
+
+      # Limited operations are commands that always require a limit of -1. In
+      # these cases we always overwrite the limit value.
+      #
+      # @example Get the options.
+      #   limited.options
+      #
+      # @return [ Hash ] The options with a -1 limit.
+      #
+      # @since 2.0.0
+      def options
+        super.merge(:limit => -1)
+      end
+    end
+  end
+end

data/lib/mongo/operation/list_collections/result.rb

@@ -0,0 +1,116 @@
+# Copyright (C) 2014-2015 MongoDB, 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
+  module Operation
+    module Read
+      class ListCollections
+
+        # Defines custom behaviour of results when using the
+        # listCollections command.
+        #
+        # @since 2.0.0
+        class Result < Operation::Result
+
+          # The field name for the cursor document in a listCollections result.
+          #
+          # @since 2.0.0
+          CURSOR = 'cursor'.freeze
+
+          # The cursor id field in the cursor document.
+          #
+          # @since 2.0.0
+          CURSOR_ID = 'id'.freeze
+
+          # The namespace field in the cursor document.
+          #
+          # @since 2.0.0
+          NAMESPACE = 'ns'.freeze
+
+          # The field name for the first batch of a cursor.
+          #
+          # @since 2.0.0
+          FIRST_BATCH = 'firstBatch'.freeze
+
+          # Get the cursor id for the result.
+          #
+          # @example Get the cursor id.
+          #   result.cursor_id
+          #
+          # @note Even though the wire protocol has a cursor_id field for all
+          #   messages of type reply, it is always zero when using the
+          #   listCollections command and must be retrieved from the cursor
+          #   document itself.
+          #
+          # @return [ Integer ] The cursor id.
+          #
+          # @since 2.0.0
+          def cursor_id
+            cursor_document ? cursor_document[CURSOR_ID] : super
+          end
+
+          # Get the namespace for the cursor.
+          #
+          # @example Get the namespace.
+          #   result.namespace
+          #
+          # @return [ String ] The namespace.
+          #
+          # @since 2.0.0
+          def namespace
+            cursor_document ? cursor_document[NAMESPACE] : super
+          end
+
+          # Get the documents for the listCollections result. It is the 'firstBatch'
+          #   field in the 'cursor' field of the first document returned.
+          #
+          # @example Get the documents.
+          #   result.documents
+          #
+          # @return [ Array<BSON::Document> ] The documents.
+          #
+          # @since 2.0.0
+          def documents
+            cursor_document[FIRST_BATCH]
+          end
+
+          # Validate the result. In the case where an unauthorized client tries
+          # to run the command we need to generate the proper error.
+          #
+          # @example Validate the result.
+          #   result.validate!
+          #
+          # @param [ Hash ] spec The spec used to run the command.
+          #
+          # @return [ Result ] Self if successful.
+          #
+          # @since 2.0.0
+          def validate!
+            !successful? ? raise(Error::OperationFailure.new(parser.message)) : self
+          end
+
+          private
+
+          def cursor_document
+            @cursor_document ||= first_document[CURSOR]
+          end
+
+          def first_document
+            @first_document ||= reply.documents[0]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mongo/operation/list_indexes/result.rb

@@ -0,0 +1,118 @@
+# Copyright (C) 2014-2015 MongoDB, 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
+  module Operation
+    module Read
+      class ListIndexes
+
+        # Defines custom behaviour of results when using the
+        # listIndexes command.
+        #
+        # @since 2.0.0
+        class Result < Operation::Result
+
+          # The field name for the cursor document in a listIndexes result.
+          #
+          # @since 2.0.0
+          CURSOR = 'cursor'.freeze
+
+          # The cursor id field in the cursor document.
+          #
+          # @since 2.0.0
+          CURSOR_ID = 'id'.freeze
+
+          # The namespace field in the cursor document.
+          #
+          # @since 2.0.0
+          NAMESPACE = 'ns'.freeze
+
+          # The field name for the first batch of a cursor.
+          #
+          # @since 2.0.0
+          FIRST_BATCH = 'firstBatch'.freeze
+
+          # Get the cursor id for the result.
+          #
+          # @example Get the cursor id.
+          #   result.cursor_id
+          #
+          # @note Even though the wire protocol has a cursor_id field for all
+          #   messages of type reply, it is always zero when using the
+          #   listIndexes command and must be retrieved from the cursor
+          #   document itself.
+          #
+          # @return [ Integer ] The cursor id.
+          #
+          # @since 2.0.0
+          def cursor_id
+            cursor_document ? cursor_document[CURSOR_ID] : super
+          end
+
+          # Get the namespace for the cursor.
+          #
+          # @example Get the namespace.
+          #   result.namespace
+          #
+          # @return [ String ] The namespace.
+          #
+          # @since 2.0.0
+          def namespace
+            cursor_document ? cursor_document[NAMESPACE] : super
+          end
+
+          # Get the documents for the listIndexes result. This is the 'firstBatch'
+          # field in the 'cursor' field of the first document returned.
+          #
+          # @example Get the documents.
+          #   result.documents
+          #
+          # @return [ Array<BSON::Document> ] The documents.
+          #
+          # @since 2.0.0
+          def documents
+            cursor_document[FIRST_BATCH]
+          end
+
+          # Validate the result. In the case where the database or collection
+          # does not exist on the server we will get an error, and it's better
+          # to raise a meaningful exception here than the ambiguous one when
+          # the error occurs.
+          #
+          # @example Validate the result.
+          #   result.validate!
+          #
+          # @raise [ NoNamespace ] If the ns doesn't exist.
+          #
+          # @return [ Result ] Self if successful.
+          #
+          # @since 2.0.0
+          def validate!
+            !successful? ? raise(Error::OperationFailure.new(parser.message)) : self
+          end
+
+          private
+
+          def cursor_document
+            @cursor_document ||= first_document[CURSOR]
+          end
+
+          def first_document
+            @first_document ||= reply.documents[0]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mongo/operation/map_reduce.rb

@@ -0,0 +1,96 @@
+# Copyright (C) 2014-2015 MongoDB, 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/operation/map_reduce/result'
+
+module Mongo
+  module Operation
+
+    # A MongoDB map reduce operation.
+    #
+    # @note A map/reduce operation can behave like a read and
+    #   return a result set, or can behave like a write operation and
+    #   output results to a user-specified collection.
+    #
+    # @example Create the map/reduce operation.
+    #   MapReduce.new({
+    #     :selector => {
+    #       :mapreduce => 'test_coll',
+    #       :map => '',
+    #       :reduce => ''
+    #     },
+    #     :db_name  => 'test_db'
+    #   })
+    #
+    # @param [ Hash ] spec The specifications for the operation.
+    #
+    # @option spec :selector [ Hash ] The map reduce selector.
+    # @option spec :db_name [ String ] The name of the database on which
+    #   the operation should be executed.
+    # @option spec :options [ Hash ] Options for the map reduce command.
+    #
+    # @since 2.0.0
+    class MapReduce
+      include Executable
+      include Specifiable
+      include Limited
+      include ReadPreferrable
+
+      # The error message for needing a primary.
+      #
+      # @since 2.0.
+      ERROR_MESSAGE = "If 'out' is specified as a collection, the primary server must be used.".freeze
+
+      # Execute the map/reduce operation.
+      #
+      # @example Execute the operation.
+      #   operation.execute(context)
+      #
+      # @params [ Mongo::Server::Context ] The context for this operation.
+      #
+      # @return [ Result ] The operation response, if there is one.
+      #
+      # @since 2.0.0
+      def execute(context)
+        unless context.standalone? || context.mongos? || context.primary? || secondary_ok?
+          raise Error::NeedPrimaryServer.new(ERROR_MESSAGE)
+        end
+        execute_message(context)
+      end
+
+      private
+
+      def execute_message(context)
+        context.with_connection do |connection|
+          Result.new(connection.dispatch([ message(context) ])).validate!
+        end
+      end
+
+      # Whether this operation can be executed on a replica set secondary server.
+      # The map reduce operation may not be executed on a secondary if the user has specified
+      # an output collection to which the results will be written.
+      #
+      # @return [ true, false ] Whether the operation can be executed on a secondary.
+      #
+      # @since 2.0.0
+      def secondary_ok?
+        selector[:out] == 'inline'
+      end
+
+      def query_coll
+        Database::COMMAND
+      end
+    end
+  end
+end

data/lib/mongo/operation/map_reduce/result.rb

@@ -0,0 +1,122 @@
+# Copyright (C) 2014-2015 MongoDB, 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
+  module Operation
+    class MapReduce
+
+      # Defines custom behaviour of results in an aggregation context.
+      #
+      # @since 2.0.0
+      class Result < Operation::Result
+
+        # The counts field for the map/reduce.
+        #
+        # @since 2.0.0
+        COUNTS = 'counts'.freeze
+
+        # The result field for when output is a collection.
+        #
+        # @since 2.0.0
+        RESULT = 'result'.freeze
+
+        # The field name for a result without a cursor.
+        #
+        # @since 2.0.0
+        RESULTS = 'results'.freeze
+
+        # The time the operation took constant.
+        #
+        # @since 2.0.0
+        TIME = 'timeMillis'.freeze
+
+        # Gets the map/reduce counts from the reply.
+        #
+        # @example Get the counts.
+        #   result.counts
+        #
+        # @return [ Hash ] A hash of the result counts.
+        #
+        # @since 2.0.0
+        def counts
+          reply.documents[0][COUNTS]
+        end
+
+        # Get the documents from the map/reduce.
+        #
+        # @example Get the documents.
+        #   result.documents
+        #
+        # @return [ Array<BSON::Document> ] The documents.
+        #
+        # @since 2.0.0
+        def documents
+          reply.documents[0][RESULTS] || reply.documents[0][RESULT]
+        end
+
+        # If the result was a command then determine if it was considered a
+        # success.
+        #
+        # @note If the write was unacknowledged, then this will always return
+        #   true.
+        #
+        # @example Was the command successful?
+        #   result.successful?
+        #
+        # @return [ true, false ] If the command was successful.
+        #
+        # @since 2.0.0
+        def successful?
+          !documents.nil?
+        end
+
+        # Get the execution time of the map/reduce.
+        #
+        # @example Get the execution time.
+        #   result.time
+        #
+        # @return [ Integer ] The executiong time in milliseconds.
+        #
+        # @since 2.0.0
+        def time
+          reply.documents[0][TIME]
+        end
+
+        # Validate the result by checking for any errors.
+        #
+        # @note This only checks for errors with writes since authentication is
+        #   handled at the connection level and any authentication errors would
+        #   be raised there, before a Result is ever created.
+        #
+        # @example Validate the result.
+        #   result.validate!
+        #
+        # @raise [ Error::OperationFailure ] If an error is in the result.
+        #
+        # @return [ Result ] The result if verification passed.
+        #
+        # @since 2.0.0
+        def validate!
+          documents.nil? ? raise(Error::OperationFailure.new(parser.message)) : self
+        end
+
+        private
+
+        def first_document
+          @first_document ||= reply.documents[0]
+        end
+      end
+    end
+  end
+end