/**
* Copyright (C) 2015 MongoDB Inc.
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License, version 3,
* as published by the Free Software Foundation.
*
* 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
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General 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 GNU Affero General 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
#include
#include "mongo/base/status.h"
#include "mongo/db/json.h"
#include "mongo/db/logical_time.h"
#include "mongo/db/operation_context.h"
#include "mongo/db/repl/optime.h"
#include "mongo/db/repl/read_concern_level.h"
#include "mongo/util/time_support.h"
namespace mongo {
class BSONObj;
namespace repl {
class ReadConcernArgs {
public:
static const std::string kReadConcernFieldName;
static const std::string kAfterOpTimeFieldName;
static const std::string kAfterClusterTimeFieldName;
static const std::string kAtClusterTimeFieldName;
static const std::string kLevelFieldName;
static const OperationContext::Decoration get;
ReadConcernArgs();
ReadConcernArgs(boost::optional level);
ReadConcernArgs(boost::optional opTime, boost::optional level);
ReadConcernArgs(boost::optional clusterTime,
boost::optional level);
/**
* Format:
* {
* find: "coll"
* filter: ,
* readConcern: { // optional
* level: "[majority|local|linearizable|available|snapshot]",
* afterOpTime: { ts: , term: },
* afterClusterTime: ,
* atClusterTime:
* }
* }
*/
Status initialize(const BSONObj& cmdObj) {
return initialize(cmdObj[kReadConcernFieldName]);
}
/**
* Initializes the object from the readConcern element in a command object.
* Use this if you are already iterating over the fields in the command object.
* This method correctly handles missing BSONElements.
*/
Status initialize(const BSONElement& readConcernElem);
/**
* Upconverts the readConcern level to 'snapshot', or returns a non-ok status if this
* readConcern cannot be upconverted.
*/
Status upconvertReadConcernLevelToSnapshot();
/**
* Appends level and afterOpTime.
*/
void appendInfo(BSONObjBuilder* builder) const;
/**
* Returns true if any of clusterTime, opTime or level arguments are set.
*/
bool isEmpty() const;
/**
* Returns default kLocalReadConcern if _level is not set.
*/
ReadConcernLevel getLevel() const;
/**
* Returns readConcernLevel before upconverting, or same as getLevel() if not upconverted.
*/
ReadConcernLevel getOriginalLevel() const;
/**
* Checks whether _level is explicitly set.
*/
bool hasLevel() const;
/**
* Returns the opTime. Deprecated: will be replaced with getArgsAfterClusterTime.
*/
boost::optional getArgsOpTime() const;
boost::optional getArgsAfterClusterTime() const;
boost::optional getArgsAtClusterTime() const;
BSONObj toBSON() const;
std::string toString() const;
private:
/**
* Read data after the OpTime of an operation on this replica set. Deprecated.
* The only user is for read-after-optime calls using the config server optime.
*/
boost::optional _opTime;
/**
* Read data after cluster-wide cluster time.
*/
boost::optional _afterClusterTime;
/**
* Read data at a particular cluster time.
*/
boost::optional _atClusterTime;
boost::optional _level;
/**
* If the read concern was upconverted, the original read concern level.
*/
boost::optional _originalLevel;
};
} // namespace repl
} // namespace mongo