mirror of https://gitee.com/bigwinds/arangodb
129 lines
5.2 KiB
C++
129 lines
5.2 KiB
C++
////////////////////////////////////////////////////////////////////////////////
|
|
/// @brief abstract base class for tasks
|
|
///
|
|
/// @file
|
|
///
|
|
/// DISCLAIMER
|
|
///
|
|
/// Copyright 2014 ArangoDB GmbH, Cologne, Germany
|
|
/// Copyright 2004-2014 triAGENS GmbH, Cologne, Germany
|
|
///
|
|
/// 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.
|
|
///
|
|
/// Copyright holder is ArangoDB GmbH, Cologne, Germany
|
|
///
|
|
/// @author Dr. Frank Celler
|
|
/// @author Achim Brandt
|
|
/// @author Copyright 2014, ArangoDB GmbH, Cologne, Germany
|
|
/// @author Copyright 2009-2013, triAGENS GmbH, Cologne, Germany
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
#include "Task.h"
|
|
|
|
#include "Basics/json.h"
|
|
#include "Scheduler/Scheduler.h"
|
|
|
|
using namespace triagens::rest;
|
|
using namespace std;
|
|
|
|
// -----------------------------------------------------------------------------
|
|
// --SECTION-- private variables
|
|
// -----------------------------------------------------------------------------
|
|
|
|
namespace {
|
|
std::atomic_uint_fast64_t NEXT_TASK_ID(static_cast<uint64_t>(TRI_microtime() *
|
|
100000.0));
|
|
}
|
|
|
|
// -----------------------------------------------------------------------------
|
|
// --SECTION-- constructors / destructors
|
|
// -----------------------------------------------------------------------------
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// @brief constructs a new task
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
Task::Task(std::string const &id, std::string const &name)
|
|
: _scheduler(nullptr),
|
|
_taskId(NEXT_TASK_ID.fetch_add(1, memory_order_seq_cst)),
|
|
_loop(0), // TODO(fc) XXX this should be an "invalid" marker!
|
|
_id(id),
|
|
_name(name) {}
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// @brief constructs a new task
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
Task::Task(std::string const &name) : Task("", name) {}
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// @brief destroys a task
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
Task::~Task() {}
|
|
|
|
// -----------------------------------------------------------------------------
|
|
// --SECTION-- public methods
|
|
// -----------------------------------------------------------------------------
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// @brief get a JSON representation of the task
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
TRI_json_t *Task::toJson() const { // TODO(fc) XXX this should be VPack
|
|
TRI_json_t *json = TRI_CreateObjectJson(TRI_UNKNOWN_MEM_ZONE);
|
|
|
|
if (json != nullptr) {
|
|
TRI_Insert3ObjectJson(
|
|
TRI_UNKNOWN_MEM_ZONE, json, "id",
|
|
TRI_CreateStringCopyJson(TRI_UNKNOWN_MEM_ZONE, this->id().c_str(),
|
|
this->id().size()));
|
|
TRI_Insert3ObjectJson(
|
|
TRI_UNKNOWN_MEM_ZONE, json, "name",
|
|
TRI_CreateStringCopyJson(TRI_UNKNOWN_MEM_ZONE, this->name().c_str(),
|
|
this->name().size()));
|
|
|
|
this->getDescription(json);
|
|
}
|
|
|
|
return json;
|
|
}
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// @brief whether or not the task is user-defined
|
|
/// note: this function may be overridden
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
bool Task::isUserDefined() const { return false; }
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// @brief allow thread to run on slave event loop
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
bool Task::needsMainEventLoop() const { return false; }
|
|
|
|
// -----------------------------------------------------------------------------
|
|
// --SECTION-- protected methods
|
|
// -----------------------------------------------------------------------------
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// @brief get a task specific description in JSON format
|
|
/// this does nothing for basic tasks, but derived classes may override it
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
void Task::getDescription(TRI_json_t *json) const {}
|
|
|
|
// -----------------------------------------------------------------------------
|
|
// --SECTION-- END-OF-FILE
|
|
// -----------------------------------------------------------------------------
|