/** * Copyright (C) 2020-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. */ #pragma once #include "mongo/db/api_parameters_gen.h" #include "mongo/db/operation_context.h" namespace mongo { /** * Decorates operation context with methods to retrieve apiVersion, apiStrict, and * apiDeprecationErrors. */ class APIParameters { public: static constexpr StringData kAPIVersionFieldName = "apiVersion"_sd; static constexpr StringData kAPIStrictFieldName = "apiStrict"_sd; static constexpr StringData kAPIDeprecationErrorsFieldName = "apiDeprecationErrors"_sd; static const OperationContext::Decoration get; static APIParameters fromClient(const APIParametersFromClient& apiParamsFromClient); static APIParameters fromBSON(const BSONObj& cmdObj); // For use with unordered_map. struct Hash { std::size_t operator()(const APIParameters& params) const; }; void appendInfo(BSONObjBuilder* builder) const; BSONObj toBSON() const; const boost::optional& getAPIVersion() const { return _apiVersion; } void setAPIVersion(StringData apiVersion) { _apiVersion = apiVersion.toString(); } const boost::optional& getAPIStrict() const { return _apiStrict; } void setAPIStrict(bool apiStrict) { _apiStrict = apiStrict; } const boost::optional& getAPIDeprecationErrors() const { return _apiDeprecationErrors; } void setAPIDeprecationErrors(bool apiDeprecationErrors) { _apiDeprecationErrors = apiDeprecationErrors; } bool getParamsPassed() const { return _apiVersion || _apiStrict || _apiDeprecationErrors; } private: boost::optional _apiVersion; boost::optional _apiStrict; boost::optional _apiDeprecationErrors; }; inline bool operator==(const APIParameters& lhs, const APIParameters& rhs) { return lhs.getAPIVersion() == rhs.getAPIVersion() && lhs.getAPIStrict() == rhs.getAPIStrict() && lhs.getAPIDeprecationErrors() == rhs.getAPIDeprecationErrors(); } inline bool operator!=(const APIParameters& lhs, const APIParameters& rhs) { return !(lhs == rhs); } /** * Temporarily remove the user's API parameters from an OperationContext. */ class IgnoreAPIParametersBlock { public: IgnoreAPIParametersBlock() = delete; IgnoreAPIParametersBlock(const IgnoreAPIParametersBlock&) = delete; IgnoreAPIParametersBlock& operator=(const IgnoreAPIParametersBlock&) = delete; explicit IgnoreAPIParametersBlock(OperationContext* opCtx) : _opCtx(opCtx) { _apiParams = APIParameters::get(_opCtx); APIParameters::get(_opCtx) = APIParameters(); } void release() { if (_released) { return; } APIParameters::get(_opCtx) = _apiParams; _released = true; } ~IgnoreAPIParametersBlock() { release(); } private: OperationContext* _opCtx; APIParameters _apiParams; bool _released = false; }; } // namespace mongo