mongo 2.5.1 → 2.5.2

data/lib/mongo/operation/insert/legacy.rb

@@ -0,0 +1,72 @@
+# Copyright (C) 2015-2018 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/update/legacy/result'
+
+module Mongo
+  module Operation
+    class Insert
+
+      # A MongoDB insert operation sent as a legacy wire protocol message.
+      #
+      # @api private
+      #
+      # @since 2.5.2
+      class Legacy
+        include Specifiable
+        include Executable
+        include Idable
+
+        # Execute the operation.
+        #
+        # @example
+        #   operation.execute(server)
+        #
+        # @param [ Mongo::Server ] server The server to send the operation to.
+        #
+        # @return [ Mongo::Operation::Insert::Result ] The operation result.
+        #
+        # @since 2.5.2
+        def execute(server)
+          result = Result.new(dispatch_message(server), @ids)
+          process_result(result, server)
+          result.validate!
+        end
+
+        private
+
+        def selector
+          send(IDENTIFIER).first
+        end
+
+        def message(server)
+          opts = !!options[:continue_on_error] ? { :flags => [:continue_on_error] } : {}
+          Protocol::Insert.new(db_name, coll_name, documents, opts)
+        end
+
+        def gle
+          wc = write_concern ||  WriteConcern.get(WriteConcern::DEFAULT)
+          if gle_message = wc.get_last_error
+            Protocol::Query.new(
+                db_name,
+                Database::COMMAND,
+                gle_message,
+                options.merge(limit: -1)
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mongo/operation/insert/op_msg.rb

@@ -0,0 +1,61 @@
+# Copyright (C) 2018 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 Insert
+
+      # A MongoDB insert operation sent as an op message.
+      #
+      # @api private
+      #
+      # @since 2.5.2
+      class OpMsg
+        include Specifiable
+        include Executable
+        include Idable
+        include SessionsSupported
+        include BypassDocumentValidation
+
+        # Execute the operation.
+        #
+        # @example
+        #   operation.execute(server)
+        #
+        # @param [ Mongo::Server ] server The server to send the operation to.
+        #
+        # @return [ Mongo::Operation::Insert::Result ] The operation result.
+        #
+        # @since 2.5.2
+        def execute(server)
+          result = Result.new(dispatch_message(server), @ids)
+          process_result(result, server)
+        end
+
+        private
+
+        def selector(server)
+          { insert: coll_name,
+            Protocol::Msg::DATABASE_IDENTIFIER => db_name,
+            ordered: ordered? }
+        end
+
+        def message(server)
+          section = { type: 1, payload: { identifier: IDENTIFIER, sequence: send(IDENTIFIER) } }
+          Protocol::Msg.new(flags, { validating_keys: true }, command(server), section)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,64 @@
+# Copyright (C) 2014-2018 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 Insert
+
+      # Defines custom behaviour of results for an insert.
+      #
+      # According to the CRUD spec, reporting the inserted ids
+      # is optional. It can be added to this class later, if needed.
+      #
+      # @since 2.0.0
+      class Result < Operation::Result
+
+        # Get the ids of the inserted documents.
+        #
+        # @since 2.0.0
+        attr_reader :inserted_ids
+
+        # Initialize a new result.
+        #
+        # @example Instantiate the result.
+        #   Result.new(replies, inserted_ids)
+        #
+        # @param [ Protocol::Message ] replies The wire protocol replies.
+        # @param [ Array<Object> ] ids The ids of the inserted documents.
+        #
+        # @since 2.0.0
+        def initialize(replies, ids)
+          @replies = [*replies] if replies
+          @inserted_ids = ids
+        end
+
+        # Gets the id of the document inserted.
+        #
+        # @example Get id of the document inserted.
+        #   result.inserted_id
+        #
+        # @return [ Object ] The id of the document inserted.
+        #
+        # @since 2.0.0
+        def inserted_id
+          inserted_ids.first
+        end
+
+        def bulk_result
+          BulkResult.new(@replies, @inserted_ids)
+        end
+      end
+    end
+  end
+end

data/lib/mongo/operation/kill_cursors.rb

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2017 MongoDB, Inc.
+# Copyright (C) 2015-2018 MongoDB, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -12,28 +12,39 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+require 'mongo/operation/kill_cursors/command'
+require 'mongo/operation/kill_cursors/op_msg'
+require 'mongo/operation/kill_cursors/legacy'
+
 module Mongo
   module Operation
 
-    # A MongoDB kill cursors operation.
-    #
-    # @example Create the kill cursors operation.
-    #   Mongo::Operation::KillCursor.new({ :cursor_ids => [1, 2] })
+    # A MongoDB killcursors operation.
     #
-    # Initialization:
-    #   param [ Hash ] spec The specifications for the operation.
-    #
-    #   option spec :cursor_ids [ Array ] The ids of cursors to kill.
+    # @api private
     #
     # @since 2.0.0
     class KillCursors
       include Specifiable
-      include Executable
-
-      private
 
-      def message(server)
-        Protocol::KillCursors.new(coll_name, db_name, cursor_ids)
+      # Execute the operation.
+      #
+      # @example
+      #   operation.execute(server)
+      #
+      # @param [ Mongo::Server ] server The server to send the operation to.
+      #
+      # @return [ Mongo::Operation::Result ] The operation result.
+      #
+      # @since 2.0.0
+      def execute(server)
+        if server.features.op_msg_enabled?
+          OpMsg.new(spec).execute(server)
+        elsif server.features.find_command_enabled?
+          Command.new(spec).execute(server)
+        else
+          Legacy.new(spec).execute(server)
+        end
       end
     end
   end

data/lib/mongo/operation/{takes_write_concern.rb → kill_cursors/command.rb}

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2017 MongoDB, Inc.
+# Copyright (C) 2018 MongoDB, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -14,20 +14,22 @@
 
 module Mongo
   module Operation
+    class KillCursors
 
-    # Adds behaviour for updating the selector for operations
-    # that may take a write concern.
-    #
-    # @since 2.4.0
-    module TakesWriteConcern
+      # A MongoDB killcursors operation sent as a command message.
+      #
+      # @api private
+      #
+      # @since 2.5.2
+      class Command
+        include Specifiable
+        include Executable
+        include Limited
 
-      private
+        private
 
-      def update_selector_for_write_concern(sel, server)
-        if write_concern && server.features.collation_enabled?
-          sel.merge(writeConcern: write_concern.options)
-        else
-          sel
+        def message(server)
+          Protocol::Query.new(db_name, Database::COMMAND, selector(server), options)
         end
       end
     end

data/lib/mongo/operation/kill_cursors/legacy.rb

@@ -0,0 +1,37 @@
+# Copyright (C) 2014-2018 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 KillCursors
+
+      # A MongoDB killcursors operation sent as a legacy wire protocol message.
+      #
+      # @api private
+      #
+      # @since 2.5.2
+      class Legacy
+        include Specifiable
+        include Executable
+
+        private
+
+        def message(server)
+          Protocol::KillCursors.new(coll_name, db_name, cursor_ids)
+        end
+      end
+    end
+  end
+end
+

data/lib/mongo/operation/kill_cursors/op_msg.rb

@@ -0,0 +1,37 @@
+# Copyright (C) 2018 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 KillCursors
+
+      # A MongoDB killcursors operation sent as an op message.
+      #
+      # @api private
+      #
+      # @since 2.5.2
+      class OpMsg
+        include Specifiable
+        include Executable
+        include SessionsSupported
+
+        private
+
+        def message(server)
+          Protocol::Msg.new(flags, options, command(server))
+        end
+      end
+    end
+  end
+end

data/lib/mongo/operation/list_collections.rb

@@ -0,0 +1,49 @@
+# Copyright (C) 2015-2018 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/list_collections/command'
+require 'mongo/operation/list_collections/op_msg'
+require 'mongo/operation/list_collections/result'
+
+module Mongo
+  module Operation
+
+    # A MongoDB listcollections operation.
+    #
+    # @api private
+    #
+    # @since 2.0.0
+    class ListCollections
+      include Specifiable
+
+      # Execute the operation.
+      #
+      # @example
+      #   operation.execute(server)
+      #
+      # @param [ Mongo::Server ] server The server to send the operation to.
+      #
+      # @return [ Mongo::Operation::ListCollections::Result ] The operation result.
+      #
+      # @since 2.0.0
+      def execute(server)
+        if server.features.op_msg_enabled?
+          OpMsg.new(spec).execute(server)
+        else
+          Command.new(spec).execute(server)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,60 @@
+# Copyright (C) 2018 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 ListCollections
+
+      # A MongoDB listcollections operation sent as a command message.
+      #
+      # @api private
+      #
+      # @since 2.5.2
+      class Command
+        include Specifiable
+        include Executable
+        include Limited
+        include ReadPreferenceSupported
+
+        # Execute the operation.
+        #
+        # @example
+        #   operation.execute(server)
+        #
+        # @param [ Mongo::Server ] server The server to send the operation to.
+        #
+        # @return [ Mongo::Operation::ListCollections::Result ] The operation result.
+        #
+        # @since 2.5.2
+        def execute(server)
+          result = Result.new(dispatch_message(server))
+          process_result(result, server)
+          result.validate!
+        end
+
+        private
+
+        def selector(server)
+          (spec[SELECTOR] || {}).merge(
+              listCollections: 1, filter: { name: { '$not' => /system\.|\$/ }}
+          )
+        end
+
+        def message(server)
+          Protocol::Query.new(db_name, Database::COMMAND, command(server), options(server))
+        end
+      end
+    end
+  end
+end