/** * Copyright (C) 2018-present MongoDB, Inc. * * This program is free software: you can redistribute it and/or modify * it under the terms of the Server Side Public License, version 1, * as published by MongoDB, Inc. * * 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 * Server Side Public License for more details. * * You should have received a copy of the Server Side Public License * along with this program. If not, see * . * * As a special exception, the copyright holders give permission to link the * code of portions of this program with the OpenSSL library under certain * conditions as described in each individual source file and distribute * linked combinations including the program with the OpenSSL library. You * must comply with the Server Side Public License in all respects for * all of the code used other than as permitted herein. If you modify file(s) * with this exception, you may extend this exception to your version of the * file(s), but you are not obligated to do so. If you do not wish to do so, * delete this exception statement from your version. If you delete this * exception statement from all source files in the program, then also delete * it in the license file. */ #include "mongo/platform/basic.h" #include "mongo/db/query/find_and_modify_request.h" #include "mongo/base/status_with.h" #include "mongo/bson/bsonobjbuilder.h" #include "mongo/bson/util/bson_extract.h" #include "mongo/db/command_generic_argument.h" #include "mongo/db/query/hint_parser.h" #include "mongo/db/write_concern.h" #include "mongo/idl/idl_parser.h" namespace mongo { namespace { const char kQueryField[] = "query"; const char kSortField[] = "sort"; const char kHintField[] = "hint"; const char kCollationField[] = "collation"; const char kArrayFiltersField[] = "arrayFilters"; const char kRuntimeConstantsField[] = "runtimeConstants"; const char kLet[] = "let"; const char kRemoveField[] = "remove"; const char kUpdateField[] = "update"; const char kNewField[] = "new"; const char kFieldProjectionField[] = "fields"; const char kUpsertField[] = "upsert"; const char kWriteConcernField[] = "writeConcern"; const char kBypassDocumentValidationField[] = "bypassDocumentValidation"; const std::vector emptyArrayFilters{}; const std::vector _knownFields{kQueryField, kSortField, kCollationField, kArrayFiltersField, kRemoveField, kUpdateField, kNewField, kFieldProjectionField, kUpsertField, kWriteConcernField, kBypassDocumentValidationField, FindAndModifyRequest::kLegacyCommandName, FindAndModifyRequest::kCommandName}; } // unnamed namespace FindAndModifyRequest::FindAndModifyRequest(NamespaceString fullNs, BSONObj query, boost::optional update) : _ns(std::move(fullNs)), _query(query.getOwned()), _update(std::move(update)) {} FindAndModifyRequest FindAndModifyRequest::makeUpdate(NamespaceString fullNs, BSONObj query, write_ops::UpdateModification update) { return FindAndModifyRequest(fullNs, query, std::move(update)); } FindAndModifyRequest FindAndModifyRequest::makeRemove(NamespaceString fullNs, BSONObj query) { FindAndModifyRequest request(fullNs, query, {}); return request; } BSONObj FindAndModifyRequest::toBSON(const BSONObj& commandPassthroughFields) const { BSONObjBuilder builder; builder.append(kCommandName, _ns.coll()); builder.append(kQueryField, _query); if (_update) { _update->serializeToBSON(kUpdateField, &builder); if (_isUpsert) { builder.append(kUpsertField, _isUpsert); } } else { builder.append(kRemoveField, true); } if (_fieldProjection) { builder.append(kFieldProjectionField, _fieldProjection.get()); } if (_sort) { builder.append(kSortField, _sort.get()); } if (_hint) { builder.append(kHintField, _hint.get()); } if (_collation) { builder.append(kCollationField, _collation.get()); } if (_arrayFilters) { BSONArrayBuilder arrayBuilder(builder.subarrayStart(kArrayFiltersField)); for (auto arrayFilter : _arrayFilters.get()) { arrayBuilder.append(arrayFilter); } arrayBuilder.doneFast(); } if (_runtimeConstants) { BSONObjBuilder rtcBuilder(builder.subobjStart(kRuntimeConstantsField)); _runtimeConstants->serialize(&rtcBuilder); rtcBuilder.doneFast(); } if (_letParameters) { if (auto letParams = _letParameters.get(); !letParams.isEmpty()) { builder.append(kLet, _letParameters.get()); } } if (_shouldReturnNew) { builder.append(kNewField, _shouldReturnNew); } if (_writeConcern) { builder.append(kWriteConcernField, _writeConcern->toBSON()); } if (_bypassDocumentValidation) { builder.append(kBypassDocumentValidationField, _bypassDocumentValidation); } IDLParserErrorContext::appendGenericCommandArguments( commandPassthroughFields, _knownFields, &builder); return builder.obj(); } StatusWith FindAndModifyRequest::parseFromBSON(NamespaceString fullNs, const BSONObj& cmdObj) { BSONObj query; BSONObj fields; BSONObj updateObj; BSONObj sort; BSONObj hint; boost::optional update; BSONObj collation; bool shouldReturnNew = false; bool isUpsert = false; bool isRemove = false; bool bypassDocumentValidation = false; bool arrayFiltersSet = false; std::vector arrayFilters; boost::optional runtimeConstants; BSONObj letParameters; bool writeConcernOptionsSet = false; WriteConcernOptions writeConcernOptions; for (auto&& field : cmdObj.getFieldNames>()) { if (field == kQueryField) { auto queryElement = cmdObj[kQueryField]; if (queryElement.type() != Object) { return {ErrorCodes::Error(31160), str::stream() << "'" << kQueryField << "' parameter must be an object, found " << queryElement.type()}; } query = queryElement.embeddedObject(); } else if (field == kSortField) { auto sortElement = cmdObj[kSortField]; if (sortElement.type() != Object) { return {ErrorCodes::Error(31174), str::stream() << "'" << kSortField << "' parameter must be an object, found " << sortElement.type()}; } sort = sortElement.embeddedObject(); } else if (field == kHintField) { hint = parseHint(cmdObj[kHintField]); } else if (field == kRemoveField) { isRemove = cmdObj[kRemoveField].trueValue(); } else if (field == kUpdateField) { update = write_ops::UpdateModification::parseFromBSON(cmdObj[kUpdateField]); } else if (field == kNewField) { shouldReturnNew = cmdObj[kNewField].trueValue(); } else if (field == kFieldProjectionField) { auto projectionElement = cmdObj[kFieldProjectionField]; if (projectionElement.type() != Object) { return {ErrorCodes::Error(31175), str::stream() << "'" << kFieldProjectionField << "' parameter must be an object, found " << projectionElement.type()}; } fields = projectionElement.embeddedObject(); } else if (field == kUpsertField) { isUpsert = cmdObj[kUpsertField].trueValue(); } else if (field == kBypassDocumentValidationField) { bypassDocumentValidation = cmdObj[kBypassDocumentValidationField].trueValue(); } else if (field == kCollationField) { BSONElement collationElt; Status collationEltStatus = bsonExtractTypedField(cmdObj, kCollationField, BSONType::Object, &collationElt); if (!collationEltStatus.isOK() && (collationEltStatus != ErrorCodes::NoSuchKey)) { return collationEltStatus; } if (collationEltStatus.isOK()) { collation = collationElt.embeddedObject(); } } else if (field == kArrayFiltersField) { BSONElement arrayFiltersElt; Status arrayFiltersEltStatus = bsonExtractTypedField( cmdObj, kArrayFiltersField, BSONType::Array, &arrayFiltersElt); if (!arrayFiltersEltStatus.isOK() && (arrayFiltersEltStatus != ErrorCodes::NoSuchKey)) { return arrayFiltersEltStatus; } if (arrayFiltersEltStatus.isOK()) { arrayFiltersSet = true; for (auto arrayFilter : arrayFiltersElt.embeddedObject()) { if (arrayFilter.type() != BSONType::Object) { return {ErrorCodes::TypeMismatch, str::stream() << "Each array filter must be an object, found " << arrayFilter.type()}; } arrayFilters.push_back(arrayFilter.embeddedObject()); } } } else if (field == kRuntimeConstantsField) { runtimeConstants = RuntimeConstants::parse(IDLParserErrorContext(kRuntimeConstantsField), cmdObj.getObjectField(kRuntimeConstantsField)); } else if (field == kLet) { BSONElement letElt; if (Status letEltStatus = bsonExtractTypedField(cmdObj, kLet, BSONType::Object, &letElt); !letEltStatus.isOK()) { return letEltStatus; } letParameters = letElt.embeddedObject(); } else if (field == kWriteConcernField) { BSONElement writeConcernElt; Status writeConcernEltStatus = bsonExtractTypedField( cmdObj, kWriteConcernField, BSONType::Object, &writeConcernElt); if (!writeConcernEltStatus.isOK()) { return writeConcernEltStatus; } auto sw = WriteConcernOptions::parse(writeConcernElt.embeddedObject()); if (!sw.isOK()) { return sw.getStatus(); } else { writeConcernOptionsSet = true; writeConcernOptions = sw.getValue(); } } else if (!isGenericArgument(field) && !std::count(_knownFields.begin(), _knownFields.end(), field)) { return {ErrorCodes::Error(51177), str::stream() << "BSON field '" << field << "' is an unknown field."}; } } if (!isRemove && !update) { return {ErrorCodes::FailedToParse, "Either an update or remove=true must be specified"}; } if (isRemove) { if (update) { return {ErrorCodes::FailedToParse, "Cannot specify both an update and remove=true"}; } if (isUpsert) { return {ErrorCodes::FailedToParse, "Cannot specify both upsert=true and remove=true"}; } if (shouldReturnNew) { return {ErrorCodes::FailedToParse, "Cannot specify both new=true and remove=true;" " 'remove' always returns the deleted document"}; } if (arrayFiltersSet) { return {ErrorCodes::FailedToParse, "Cannot specify arrayFilters and remove=true"}; } } if (update && update->type() == write_ops::UpdateModification::Type::kPipeline && arrayFiltersSet) { return {ErrorCodes::FailedToParse, "Cannot specify arrayFilters and a pipeline update"}; } FindAndModifyRequest request(std::move(fullNs), query, std::move(update)); request.setFieldProjection(fields); request.setSort(sort); request.setHint(hint); request.setCollation(collation); request.setBypassDocumentValidation(bypassDocumentValidation); request.setLetParameters(letParameters); if (arrayFiltersSet) { request.setArrayFilters(std::move(arrayFilters)); } if (runtimeConstants) { request.setRuntimeConstants(*runtimeConstants); } if (writeConcernOptionsSet) { request.setWriteConcern(std::move(writeConcernOptions)); } if (!isRemove) { request.setShouldReturnNew(shouldReturnNew); request.setUpsert(isUpsert); } return request; } void FindAndModifyRequest::setFieldProjection(BSONObj fields) { _fieldProjection = fields.getOwned(); } void FindAndModifyRequest::setSort(BSONObj sort) { _sort = sort.getOwned(); } void FindAndModifyRequest::setHint(BSONObj hint) { _hint = hint.getOwned(); } void FindAndModifyRequest::setCollation(BSONObj collation) { _collation = collation.getOwned(); } void FindAndModifyRequest::setArrayFilters(const std::vector& arrayFilters) { _arrayFilters = std::vector(); for (auto arrayFilter : arrayFilters) { _arrayFilters->emplace_back(arrayFilter.getOwned()); } } void FindAndModifyRequest::setQuery(BSONObj query) { _query = query.getOwned(); } void FindAndModifyRequest::setUpdateObj(BSONObj updateObj) { _update.emplace(updateObj.getOwned()); } void FindAndModifyRequest::setShouldReturnNew(bool shouldReturnNew) { dassert(_update); _shouldReturnNew = shouldReturnNew; } void FindAndModifyRequest::setUpsert(bool upsert) { dassert(_update); _isUpsert = upsert; } void FindAndModifyRequest::setWriteConcern(WriteConcernOptions writeConcern) { _writeConcern = std::move(writeConcern); } void FindAndModifyRequest::setBypassDocumentValidation(bool bypassDocumentValidation) { _bypassDocumentValidation = bypassDocumentValidation; } const NamespaceString& FindAndModifyRequest::getNamespaceString() const { return _ns; } BSONObj FindAndModifyRequest::getQuery() const { return _query; } BSONObj FindAndModifyRequest::getFields() const { return _fieldProjection.value_or(BSONObj()); } const boost::optional& FindAndModifyRequest::getUpdate() const { return _update; } BSONObj FindAndModifyRequest::getSort() const { return _sort.value_or(BSONObj()); } BSONObj FindAndModifyRequest::getHint() const { return _hint.value_or(BSONObj()); } BSONObj FindAndModifyRequest::getCollation() const { return _collation.value_or(BSONObj()); } const std::vector& FindAndModifyRequest::getArrayFilters() const { if (_arrayFilters) { return _arrayFilters.get(); } return emptyArrayFilters; } bool FindAndModifyRequest::shouldReturnNew() const { return _shouldReturnNew; } bool FindAndModifyRequest::isUpsert() const { return _isUpsert; } bool FindAndModifyRequest::isRemove() const { return !static_cast(_update); } bool FindAndModifyRequest::getBypassDocumentValidation() const { return _bypassDocumentValidation; } } // namespace mongo