mirror of
https://github.com/mongodb/mongo.git
synced 2024-12-01 01:21:03 +01:00
96 lines
3.1 KiB
C++
96 lines
3.1 KiB
C++
// commands.h
|
|
|
|
/* Copyright 2009 10gen 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.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include "../stdafx.h"
|
|
#include "jsobj.h"
|
|
|
|
namespace mongo {
|
|
|
|
class BSONObj;
|
|
class BSONObjBuilder;
|
|
class BufBuilder;
|
|
|
|
// db "commands" (sent via db.$cmd.findOne(...))
|
|
// subclass to make a command.
|
|
class Command {
|
|
public:
|
|
string name;
|
|
|
|
/* run the given command
|
|
implement this...
|
|
|
|
fromRepl - command is being invoked as part of replication syncing. In this situation you
|
|
normally do not want to log the command to the local oplog.
|
|
|
|
return value is true if succeeded. if false, set errmsg text.
|
|
*/
|
|
virtual bool run(const char *ns, BSONObj& cmdObj, string& errmsg, BSONObjBuilder& result, bool fromRepl) = 0;
|
|
|
|
/* Return true if only the admin ns has privileges to run this command. */
|
|
virtual bool adminOnly() {
|
|
return false;
|
|
}
|
|
|
|
/* Return true if slaves of a replication pair are allowed to execute the command
|
|
(the command directly from a client -- if fromRepl, always allowed).
|
|
*/
|
|
virtual bool slaveOk() = 0;
|
|
|
|
/* Return true if the client force a command to be run on a slave by
|
|
turning on the 'slaveok' option in the command query.
|
|
*/
|
|
virtual bool slaveOverrideOk() {
|
|
return false;
|
|
}
|
|
|
|
/* Override and return true to if true,log the operation (logOp()) to the replication log.
|
|
(not done if fromRepl of course)
|
|
|
|
Note if run() returns false, we do NOT log.
|
|
*/
|
|
virtual bool logTheOp() {
|
|
return false;
|
|
}
|
|
|
|
virtual void help( stringstream& help ) const;
|
|
|
|
/* Return true if authentication and security applies to the commands. Some commands
|
|
(e.g., getnonce, authenticate) can be done by anyone even unauthorized.
|
|
*/
|
|
virtual bool requiresAuth() { return true; }
|
|
|
|
Command(const char *_name);
|
|
virtual ~Command() {}
|
|
|
|
protected:
|
|
BSONObj getQuery( const BSONObj& cmdObj ){
|
|
if ( cmdObj["query"].type() == Object )
|
|
return cmdObj["query"].embeddedObject();
|
|
if ( cmdObj["q"].type() == Object )
|
|
return cmdObj["q"].embeddedObject();
|
|
return BSONObj();
|
|
}
|
|
};
|
|
|
|
bool runCommandAgainstRegistered(const char *ns, BSONObj& jsobj, BSONObjBuilder& anObjBuilder);
|
|
|
|
bool _runCommands(const char *ns, BSONObj& jsobj, stringstream& ss, BufBuilder &b, BSONObjBuilder& anObjBuilder, bool fromRepl, int queryOptions);
|
|
|
|
} // namespace mongo
|