# Copyright (C) 2018-2019 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 # Shared behavior of operations that write (update, insert, delete). # # @since 2.5.2 module Write include ResponseHandling # Execute the operation. # # @example # operation.execute(server, client: nil) # # @param [ Mongo::Server ] server The server to send the operation to. # @param [ Mongo::Client ] client The client that will be used to # perform auto-encryption if it is necessary to encrypt the command # being executed (optional). # # @return [ Mongo::Operation::Result ] The operation result. # # @since 2.5.2 def execute(server, client:) validate! op = if server.features.op_msg_enabled? self.class::OpMsg.new(spec) elsif !acknowledged_write? self.class::Legacy.new(spec) else self.class::Command.new(spec) end result = op.execute(server, client: client) validate_result(result, server) end # Execute the bulk write operation. # # @example # operation.bulk_execute(server, client: nil) # # @param [ Mongo::Server ] server The server to send the operation to. # @param [ Mongo::Client ] client The client that will be used to # perform auto-encryption if it is necessary to encrypt the command # being executed (optional). # # @return [ Mongo::Operation::Delete::BulkResult, # Mongo::Operation::Insert::BulkResult, # Mongo::Operation::Update::BulkResult ] The bulk result. # # @since 2.5.2 def bulk_execute(server, client:) if server.features.op_msg_enabled? self.class::OpMsg.new(spec).execute(server, client: client).bulk_result else self.class::Command.new(spec).execute(server, client: client).bulk_result end end private def validate! if !acknowledged_write? if collation raise Error::UnsupportedCollation.new( Error::UnsupportedCollation::UNACKNOWLEDGED_WRITES_MESSAGE) end if array_filters raise Error::UnsupportedArrayFilters.new( Error::UnsupportedArrayFilters::UNACKNOWLEDGED_WRITES_MESSAGE) end end end end end end