mirror of https://gitee.com/bigwinds/arangodb
628 lines
19 KiB
C++
628 lines
19 KiB
C++
////////////////////////////////////////////////////////////////////////////////
|
|
/// DISCLAIMER
|
|
///
|
|
/// Copyright 2014-2018 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 Kaveh Vahedipour
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
#include "RestAgencyHandler.h"
|
|
|
|
#include <thread>
|
|
|
|
#include <velocypack/Builder.h>
|
|
#include <velocypack/velocypack-aliases.h>
|
|
|
|
#include "Agency/Agent.h"
|
|
#include "Basics/StaticStrings.h"
|
|
#include "Logger/Logger.h"
|
|
#include "Rest/HttpRequest.h"
|
|
#include "Rest/Version.h"
|
|
#include "StorageEngine/EngineSelectorFeature.h"
|
|
|
|
using namespace arangodb;
|
|
|
|
using namespace arangodb::basics;
|
|
using namespace arangodb::rest;
|
|
using namespace arangodb::consensus;
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
/// @brief ArangoDB server
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
RestAgencyHandler::RestAgencyHandler(GeneralRequest* request,
|
|
GeneralResponse* response, Agent* agent)
|
|
: RestBaseHandler(request, response), _agent(agent) {}
|
|
|
|
inline RestStatus RestAgencyHandler::reportErrorEmptyRequest() {
|
|
LOG_TOPIC(WARN, Logger::AGENCY)
|
|
<< "Empty request to public agency interface.";
|
|
generateError(rest::ResponseCode::NOT_FOUND, 404);
|
|
return RestStatus::DONE;
|
|
}
|
|
|
|
inline RestStatus RestAgencyHandler::reportTooManySuffices() {
|
|
LOG_TOPIC(WARN, Logger::AGENCY)
|
|
<< "Too many suffixes. Agency public interface takes one path.";
|
|
generateError(rest::ResponseCode::NOT_FOUND, 404);
|
|
return RestStatus::DONE;
|
|
}
|
|
|
|
inline RestStatus RestAgencyHandler::reportUnknownMethod() {
|
|
LOG_TOPIC(WARN, Logger::AGENCY)
|
|
<< "Public REST interface has no method " << _request->suffixes()[0];
|
|
generateError(rest::ResponseCode::NOT_FOUND, 405);
|
|
return RestStatus::DONE;
|
|
}
|
|
|
|
inline RestStatus RestAgencyHandler::reportMessage(rest::ResponseCode code,
|
|
std::string const& message) {
|
|
LOG_TOPIC(DEBUG, Logger::AGENCY) << message;
|
|
Builder body;
|
|
{
|
|
VPackObjectBuilder b(&body);
|
|
body.add("message", VPackValue(message));
|
|
}
|
|
generateResult(code, body.slice());
|
|
return RestStatus::DONE;
|
|
}
|
|
|
|
void RestAgencyHandler::redirectRequest(std::string const& leaderId) {
|
|
try {
|
|
std::string url = Endpoint::uriForm(_agent->config().poolAt(leaderId)) +
|
|
_request->requestPath();
|
|
_response->setResponseCode(rest::ResponseCode::TEMPORARY_REDIRECT);
|
|
_response->setHeaderNC(StaticStrings::Location, url);
|
|
LOG_TOPIC(DEBUG, Logger::AGENCY) << "Sending 307 redirect to " << url;
|
|
} catch (std::exception const&) {
|
|
reportMessage(rest::ResponseCode::SERVICE_UNAVAILABLE, "No leader");
|
|
}
|
|
}
|
|
|
|
RestStatus RestAgencyHandler::handleTransient() {
|
|
// Must be a POST request
|
|
if (_request->requestType() != rest::RequestType::POST) {
|
|
return reportMethodNotAllowed();
|
|
}
|
|
|
|
// Convert to velocypack
|
|
query_t query;
|
|
try {
|
|
query = _request->toVelocyPackBuilderPtr();
|
|
} catch (std::exception const& e) {
|
|
return reportMessage(rest::ResponseCode::BAD, e.what());
|
|
}
|
|
|
|
// Need Array input
|
|
if (!query->slice().isArray()) {
|
|
return reportMessage(rest::ResponseCode::BAD,
|
|
"Expecting array of arrays as body for writes");
|
|
}
|
|
|
|
// Empty request array
|
|
if (query->slice().length() == 0) {
|
|
return reportMessage(rest::ResponseCode::BAD, "Empty request");
|
|
}
|
|
|
|
// Leadership established?
|
|
if (_agent->size() > 1 && _agent->leaderID() == NO_LEADER) {
|
|
return reportMessage(rest::ResponseCode::SERVICE_UNAVAILABLE, "No leader");
|
|
}
|
|
|
|
trans_ret_t ret;
|
|
|
|
try {
|
|
ret = _agent->transient(query);
|
|
} catch (std::exception const& e) {
|
|
return reportMessage(rest::ResponseCode::BAD, e.what());
|
|
}
|
|
|
|
// We're leading and handling the request
|
|
if (ret.accepted) {
|
|
generateResult((ret.failed == 0) ? rest::ResponseCode::OK : rest::ResponseCode::PRECONDITION_FAILED,
|
|
ret.result->slice());
|
|
} else { // Redirect to leader
|
|
if (_agent->leaderID() == NO_LEADER) {
|
|
return reportMessage(rest::ResponseCode::SERVICE_UNAVAILABLE,
|
|
"No leader");
|
|
} else {
|
|
TRI_ASSERT(ret.redirect != _agent->id());
|
|
redirectRequest(ret.redirect);
|
|
}
|
|
}
|
|
|
|
return RestStatus::DONE;
|
|
}
|
|
|
|
RestStatus RestAgencyHandler::handleStores() {
|
|
if (_request->requestType() == rest::RequestType::GET) {
|
|
Builder body;
|
|
{
|
|
VPackObjectBuilder b(&body);
|
|
{
|
|
_agent->executeLockedRead([&]() {
|
|
body.add(VPackValue("spearhead"));
|
|
{
|
|
VPackArrayBuilder bb(&body);
|
|
_agent->spearhead().dumpToBuilder(body);
|
|
}
|
|
body.add(VPackValue("read_db"));
|
|
{
|
|
VPackArrayBuilder bb(&body);
|
|
_agent->readDB().dumpToBuilder(body);
|
|
}
|
|
body.add(VPackValue("transient"));
|
|
{
|
|
VPackArrayBuilder bb(&body);
|
|
_agent->transient().dumpToBuilder(body);
|
|
}
|
|
});
|
|
}
|
|
}
|
|
generateResult(rest::ResponseCode::OK, body.slice());
|
|
return RestStatus::DONE;
|
|
}
|
|
|
|
return reportMethodNotAllowed();
|
|
}
|
|
|
|
RestStatus RestAgencyHandler::handleStore() {
|
|
if (_request->requestType() == rest::RequestType::POST) {
|
|
auto query = _request->toVelocyPackBuilderPtr();
|
|
arangodb::consensus::index_t index = 0;
|
|
|
|
try {
|
|
index = query->slice().getUInt();
|
|
} catch (...) {
|
|
index = _agent->lastCommitted();
|
|
}
|
|
|
|
try {
|
|
query_t builder = _agent->buildDB(index);
|
|
generateResult(rest::ResponseCode::OK, builder->slice());
|
|
} catch (...) {
|
|
generateError(rest::ResponseCode::BAD, 400);
|
|
}
|
|
|
|
return RestStatus::DONE;
|
|
}
|
|
|
|
return reportMethodNotAllowed();
|
|
}
|
|
|
|
RestStatus RestAgencyHandler::handleWrite() {
|
|
if (_request->requestType() != rest::RequestType::POST) {
|
|
return reportMethodNotAllowed();
|
|
}
|
|
|
|
query_t query;
|
|
|
|
// Convert to velocypack
|
|
try {
|
|
query = _request->toVelocyPackBuilderPtr();
|
|
} catch (std::exception const& e) {
|
|
return reportMessage(rest::ResponseCode::BAD, e.what());
|
|
}
|
|
|
|
// Need Array input
|
|
if (!query->slice().isArray()) {
|
|
return reportMessage(rest::ResponseCode::BAD,
|
|
"Expecting array of arrays as body for writes");
|
|
}
|
|
|
|
// Empty request array
|
|
if (query->slice().length() == 0) {
|
|
return reportMessage(rest::ResponseCode::BAD, "Empty request.");
|
|
}
|
|
|
|
// Leadership established?
|
|
if (_agent->size() > 1 && _agent->leaderID() == NO_LEADER) {
|
|
return reportMessage(rest::ResponseCode::SERVICE_UNAVAILABLE, "No leader");
|
|
}
|
|
|
|
// Do write
|
|
write_ret_t ret;
|
|
try {
|
|
ret = _agent->write(query);
|
|
} catch (std::exception const& e) {
|
|
return reportMessage(rest::ResponseCode::BAD, e.what());
|
|
}
|
|
|
|
// We're leading and handling the request
|
|
if (ret.accepted) {
|
|
bool found;
|
|
std::string call_mode = _request->header("x-arangodb-agency-mode", found);
|
|
|
|
if (!found) {
|
|
call_mode = "waitForCommitted";
|
|
}
|
|
|
|
size_t precondition_failed = 0;
|
|
size_t forbidden = 0;
|
|
|
|
Builder body;
|
|
body.openObject();
|
|
Agent::raft_commit_t result = Agent::raft_commit_t::OK;
|
|
|
|
if (call_mode != "noWait") {
|
|
// Note success/error
|
|
body.add("results", VPackValue(VPackValueType::Array));
|
|
for (auto const& index : ret.indices) {
|
|
body.add(VPackValue(index));
|
|
}
|
|
for (auto const& a : ret.applied) {
|
|
switch (a) {
|
|
case APPLIED:
|
|
break;
|
|
case PRECONDITION_FAILED:
|
|
++precondition_failed;
|
|
break;
|
|
case FORBIDDEN:
|
|
++forbidden;
|
|
break;
|
|
default:
|
|
break;
|
|
}
|
|
}
|
|
body.close();
|
|
|
|
// Wait for commit of highest except if it is 0?
|
|
if (!ret.indices.empty() && call_mode == "waitForCommitted") {
|
|
arangodb::consensus::index_t max_index = 0;
|
|
try {
|
|
max_index = *std::max_element(ret.indices.begin(), ret.indices.end());
|
|
} catch (std::exception const& ex) {
|
|
LOG_TOPIC(WARN, Logger::AGENCY) << ex.what();
|
|
}
|
|
|
|
if (max_index > 0) {
|
|
result = _agent->waitFor(max_index);
|
|
}
|
|
}
|
|
}
|
|
|
|
body.close();
|
|
|
|
if (result == Agent::raft_commit_t::UNKNOWN) {
|
|
generateError(rest::ResponseCode::SERVICE_UNAVAILABLE, TRI_ERROR_HTTP_SERVICE_UNAVAILABLE);
|
|
} else if (result == Agent::raft_commit_t::TIMEOUT) {
|
|
generateError(rest::ResponseCode::REQUEST_TIMEOUT, 408);
|
|
} else {
|
|
if (forbidden > 0) {
|
|
generateResult(rest::ResponseCode::FORBIDDEN, body.slice());
|
|
} else if (precondition_failed > 0) { // Some/all requests failed
|
|
generateResult(rest::ResponseCode::PRECONDITION_FAILED, body.slice());
|
|
} else { // All good
|
|
generateResult(rest::ResponseCode::OK, body.slice());
|
|
}
|
|
}
|
|
|
|
} else { // Redirect to leader
|
|
if (_agent->leaderID() == NO_LEADER) {
|
|
return reportMessage(rest::ResponseCode::SERVICE_UNAVAILABLE,
|
|
"No leader");
|
|
} else {
|
|
TRI_ASSERT(ret.redirect != _agent->id());
|
|
redirectRequest(ret.redirect);
|
|
}
|
|
}
|
|
|
|
return RestStatus::DONE;
|
|
}
|
|
|
|
RestStatus RestAgencyHandler::handleTransact() {
|
|
if (_request->requestType() != rest::RequestType::POST) {
|
|
return reportMethodNotAllowed();
|
|
}
|
|
|
|
query_t query;
|
|
|
|
// Convert to velocypack
|
|
try {
|
|
query = _request->toVelocyPackBuilderPtr();
|
|
} catch (std::exception const& e) {
|
|
return reportMessage(rest::ResponseCode::BAD, e.what());
|
|
}
|
|
|
|
// Need Array input
|
|
if (!query->slice().isArray()) {
|
|
return reportMessage(rest::ResponseCode::BAD,
|
|
"Expecting array of arrays as body for writes");
|
|
}
|
|
|
|
// Empty request array
|
|
if (query->slice().length() == 0) {
|
|
return reportMessage(rest::ResponseCode::BAD, "Empty request");
|
|
}
|
|
|
|
// Leadership established?
|
|
if (_agent->size() > 1 && _agent->leaderID() == NO_LEADER) {
|
|
return reportMessage(rest::ResponseCode::SERVICE_UNAVAILABLE, "No leader");
|
|
}
|
|
|
|
// Do write
|
|
trans_ret_t ret;
|
|
try {
|
|
ret = _agent->transact(query);
|
|
} catch (std::exception const& e) {
|
|
return reportMessage(rest::ResponseCode::BAD, e.what());
|
|
}
|
|
|
|
// We're leading and handling the request
|
|
if (ret.accepted) {
|
|
// Wait for commit of highest except if it is 0?
|
|
if (ret.maxind > 0) {
|
|
_agent->waitFor(ret.maxind);
|
|
}
|
|
generateResult((ret.failed == 0) ? rest::ResponseCode::OK : rest::ResponseCode::PRECONDITION_FAILED,
|
|
ret.result->slice());
|
|
|
|
} else { // Redirect to leader
|
|
if (_agent->leaderID() == NO_LEADER) {
|
|
return reportMessage(rest::ResponseCode::SERVICE_UNAVAILABLE,
|
|
"No leader");
|
|
} else {
|
|
TRI_ASSERT(ret.redirect != _agent->id());
|
|
redirectRequest(ret.redirect);
|
|
}
|
|
}
|
|
|
|
return RestStatus::DONE;
|
|
}
|
|
|
|
RestStatus RestAgencyHandler::handleInquire() {
|
|
if (_request->requestType() != rest::RequestType::POST) {
|
|
return reportMethodNotAllowed();
|
|
}
|
|
|
|
query_t query;
|
|
|
|
// Get query from body
|
|
try {
|
|
query = _request->toVelocyPackBuilderPtr();
|
|
} catch (std::exception const& ex) {
|
|
LOG_TOPIC(DEBUG, Logger::AGENCY) << ex.what();
|
|
generateError(rest::ResponseCode::BAD, 400);
|
|
return RestStatus::DONE;
|
|
}
|
|
|
|
// Leadership established?
|
|
if (_agent->size() > 1 && _agent->leaderID() == NO_LEADER) {
|
|
return reportMessage(rest::ResponseCode::SERVICE_UNAVAILABLE, "No leader");
|
|
}
|
|
|
|
write_ret_t ret;
|
|
try {
|
|
ret = _agent->inquire(query);
|
|
} catch (std::exception const& e) {
|
|
return reportMessage(rest::ResponseCode::SERVER_ERROR, e.what());
|
|
}
|
|
|
|
if (ret.accepted) { // I am leading
|
|
|
|
bool found;
|
|
std::string call_mode = _request->header("x-arangodb-agency-mode", found);
|
|
if (!found) {
|
|
call_mode = "waitForCommitted";
|
|
}
|
|
|
|
// First possibility: The answer is empty, we have never heard about
|
|
// these transactions. In this case we say so, regardless what the
|
|
// "agency-mode" is.
|
|
// Second possibility: Non-empty answer, but agency-mode is "noWait",
|
|
// then we simply report our findings, too.
|
|
// Third possibility, we actually have a non-empty list of indices,
|
|
// and we need to wait for commit to answer.
|
|
|
|
// Handle cases 2 and 3:
|
|
Agent::raft_commit_t result = Agent::raft_commit_t::OK;
|
|
bool allCommitted = true;
|
|
if (!ret.indices.empty()) {
|
|
arangodb::consensus::index_t max_index = 0;
|
|
try {
|
|
max_index = *std::max_element(ret.indices.begin(), ret.indices.end());
|
|
} catch (std::exception const& ex) {
|
|
LOG_TOPIC(WARN, Logger::AGENCY) << ex.what();
|
|
}
|
|
|
|
if (max_index > 0) {
|
|
if (call_mode == "waitForCommitted") {
|
|
result = _agent->waitFor(max_index);
|
|
} else {
|
|
allCommitted = _agent->isCommitted(max_index);
|
|
}
|
|
}
|
|
}
|
|
|
|
// We can now prepare the result:
|
|
Builder body;
|
|
bool failed = false;
|
|
{
|
|
VPackObjectBuilder b(&body);
|
|
body.add(VPackValue("results"));
|
|
{
|
|
VPackArrayBuilder bb(&body);
|
|
for (auto const& index : ret.indices) {
|
|
body.add(VPackValue(index));
|
|
failed = (failed || index == 0);
|
|
}
|
|
}
|
|
body.add("inquired", VPackValue(true));
|
|
if (!allCommitted) { // can only happen in agency_mode "noWait"
|
|
body.add("ongoing", VPackValue(true));
|
|
}
|
|
}
|
|
|
|
if (result == Agent::raft_commit_t::UNKNOWN) {
|
|
generateError(rest::ResponseCode::SERVICE_UNAVAILABLE, TRI_ERROR_HTTP_SERVICE_UNAVAILABLE);
|
|
} else if (result == Agent::raft_commit_t::TIMEOUT) {
|
|
generateError(rest::ResponseCode::REQUEST_TIMEOUT, 408);
|
|
} else {
|
|
if (failed) { // Some/all requests failed
|
|
generateResult(rest::ResponseCode::NOT_FOUND, body.slice());
|
|
} else { // All good (or indeed unknown in case 1)
|
|
generateResult(rest::ResponseCode::OK, body.slice());
|
|
}
|
|
}
|
|
} else { // Redirect to leader
|
|
if (_agent->leaderID() == NO_LEADER) {
|
|
return reportMessage(rest::ResponseCode::SERVICE_UNAVAILABLE,
|
|
"No leader");
|
|
} else {
|
|
TRI_ASSERT(ret.redirect != _agent->id());
|
|
redirectRequest(ret.redirect);
|
|
}
|
|
}
|
|
|
|
return RestStatus::DONE;
|
|
}
|
|
|
|
RestStatus RestAgencyHandler::handleRead() {
|
|
if (_request->requestType() == rest::RequestType::POST) {
|
|
query_t query;
|
|
try {
|
|
query = _request->toVelocyPackBuilderPtr();
|
|
} catch (std::exception const& e) {
|
|
return reportMessage(rest::ResponseCode::BAD, e.what());
|
|
}
|
|
|
|
if (_agent->size() > 1 && _agent->leaderID() == NO_LEADER) {
|
|
return reportMessage(rest::ResponseCode::SERVICE_UNAVAILABLE,
|
|
"No leader");
|
|
}
|
|
|
|
read_ret_t ret = _agent->read(query);
|
|
|
|
if (ret.accepted) { // I am leading
|
|
if (ret.success.size() == 1 && !ret.success.at(0)) {
|
|
generateResult(rest::ResponseCode::I_AM_A_TEAPOT, ret.result->slice());
|
|
} else {
|
|
generateResult(rest::ResponseCode::OK, ret.result->slice());
|
|
}
|
|
} else { // Redirect to leader
|
|
if (_agent->leaderID() == NO_LEADER) {
|
|
return reportMessage(rest::ResponseCode::SERVICE_UNAVAILABLE,
|
|
"No leader");
|
|
} else {
|
|
TRI_ASSERT(ret.redirect != _agent->id());
|
|
redirectRequest(ret.redirect);
|
|
}
|
|
}
|
|
return RestStatus::DONE;
|
|
}
|
|
|
|
return reportMethodNotAllowed();
|
|
}
|
|
|
|
RestStatus RestAgencyHandler::handleConfig() {
|
|
// Update endpoint of peer
|
|
if (_request->requestType() == rest::RequestType::POST) {
|
|
try {
|
|
_agent->updatePeerEndpoint(_request->toVelocyPackBuilderPtr());
|
|
} catch (std::exception const& e) {
|
|
generateError(rest::ResponseCode::SERVER_ERROR, TRI_ERROR_INTERNAL, e.what());
|
|
return RestStatus::DONE;
|
|
}
|
|
}
|
|
|
|
// Respond with configuration
|
|
auto last = _agent->lastCommitted();
|
|
Builder body;
|
|
{
|
|
VPackObjectBuilder b(&body);
|
|
body.add("term", Value(_agent->term()));
|
|
body.add("leaderId", Value(_agent->leaderID()));
|
|
body.add("commitIndex", Value(last));
|
|
_agent->lastAckedAgo(body);
|
|
body.add("configuration", _agent->config().toBuilder()->slice());
|
|
body.add("engine", VPackValue(EngineSelectorFeature::engineName()));
|
|
body.add("version", VPackValue(ARANGODB_VERSION));
|
|
}
|
|
|
|
generateResult(rest::ResponseCode::OK, body.slice());
|
|
|
|
return RestStatus::DONE;
|
|
}
|
|
|
|
RestStatus RestAgencyHandler::handleState() {
|
|
|
|
VPackBuilder body;
|
|
body.add(VPackValue(VPackValueType::Array));
|
|
for (auto const& i : _agent->state().get()) {
|
|
body.add(VPackValue(VPackValueType::Object));
|
|
body.add("index", VPackValue(i.index));
|
|
body.add("term", VPackValue(i.term));
|
|
if (i.entry != nullptr) {
|
|
body.add("query", VPackSlice(i.entry->data()));
|
|
}
|
|
body.add("clientId", VPackValue(i.clientId));
|
|
body.close();
|
|
}
|
|
body.close();
|
|
generateResult(rest::ResponseCode::OK, body.slice());
|
|
return RestStatus::DONE;
|
|
}
|
|
|
|
RestStatus RestAgencyHandler::reportMethodNotAllowed() {
|
|
generateError(rest::ResponseCode::METHOD_NOT_ALLOWED, 405);
|
|
return RestStatus::DONE;
|
|
}
|
|
|
|
RestStatus RestAgencyHandler::execute() {
|
|
try {
|
|
auto const& suffixes = _request->suffixes();
|
|
if (suffixes.empty()) { // Empty request
|
|
return reportErrorEmptyRequest();
|
|
} else if (suffixes.size() > 1) { // path size >= 2
|
|
return reportTooManySuffices();
|
|
} else {
|
|
if (suffixes[0] == "write") {
|
|
return handleWrite();
|
|
} else if (suffixes[0] == "read") {
|
|
return handleRead();
|
|
} else if (suffixes[0] == "inquire") {
|
|
return handleInquire();
|
|
} else if (suffixes[0] == "transient") {
|
|
return handleTransient();
|
|
} else if (suffixes[0] == "transact") {
|
|
return handleTransact();
|
|
} else if (suffixes[0] == "config") {
|
|
if (_request->requestType() != rest::RequestType::GET &&
|
|
_request->requestType() != rest::RequestType::POST) {
|
|
return reportMethodNotAllowed();
|
|
}
|
|
return handleConfig();
|
|
} else if (suffixes[0] == "state") {
|
|
if (_request->requestType() != rest::RequestType::GET) {
|
|
return reportMethodNotAllowed();
|
|
}
|
|
return handleState();
|
|
} else if (suffixes[0] == "stores") {
|
|
return handleStores();
|
|
} else if (suffixes[0] == "store") {
|
|
return handleStore();
|
|
} else {
|
|
return reportUnknownMethod();
|
|
}
|
|
}
|
|
} catch (...) {
|
|
// Ignore this error
|
|
}
|
|
return RestStatus::DONE;
|
|
}
|