//////////////////////////////////////////////////////////////////////////////// /// @brief query request handler /// /// @file /// /// DISCLAIMER /// /// Copyright 2014-2015 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 Copyright 2014-2015, ArangoDB GmbH, Cologne, Germany /// @author Copyright 2010-2014, triAGENS GmbH, Cologne, Germany //////////////////////////////////////////////////////////////////////////////// #include "RestQueryHandler.h" #include "Aql/Query.h" #include "Aql/QueryList.h" #include "Basics/StringUtils.h" #include "Basics/conversions.h" #include "Basics/json.h" #include "Basics/string-buffer.h" #include "Basics/json-utilities.h" #include "Rest/HttpRequest.h" #include "VocBase/document-collection.h" #include "VocBase/vocbase.h" #include "Cluster/ServerState.h" #include "Cluster/ClusterInfo.h" #include "Cluster/ClusterComm.h" #include "Cluster/ClusterMethods.h" using namespace std; using namespace triagens::basics; using namespace triagens::rest; using namespace triagens::arango; using namespace triagens::aql; // ----------------------------------------------------------------------------- // --SECTION-- constructors and destructors // ----------------------------------------------------------------------------- //////////////////////////////////////////////////////////////////////////////// /// @brief constructor //////////////////////////////////////////////////////////////////////////////// RestQueryHandler::RestQueryHandler (HttpRequest* request, ApplicationV8* applicationV8) : RestVocbaseBaseHandler(request), _applicationV8(applicationV8) { } // ----------------------------------------------------------------------------- // --SECTION-- Handler methods // ----------------------------------------------------------------------------- //////////////////////////////////////////////////////////////////////////////// /// {@inheritDoc} //////////////////////////////////////////////////////////////////////////////// bool RestQueryHandler::isDirect () { return _request->requestType() != HttpRequest::HTTP_REQUEST_POST; } //////////////////////////////////////////////////////////////////////////////// /// {@inheritDoc} //////////////////////////////////////////////////////////////////////////////// HttpHandler::status_t RestQueryHandler::execute () { // extract the sub-request type HttpRequest::HttpRequestType type = _request->requestType(); // execute one of the CRUD methods switch (type) { case HttpRequest::HTTP_REQUEST_DELETE: deleteQuery(); break; case HttpRequest::HTTP_REQUEST_GET: readQuery(); break; case HttpRequest::HTTP_REQUEST_PUT: replaceProperties(); break; case HttpRequest::HTTP_REQUEST_POST: parseQuery(); break; case HttpRequest::HTTP_REQUEST_HEAD: case HttpRequest::HTTP_REQUEST_PATCH: case HttpRequest::HTTP_REQUEST_ILLEGAL: default: { generateNotImplemented("ILLEGAL " + DOCUMENT_PATH); break; } } // this handler is done return status_t(HANDLER_DONE); } // ----------------------------------------------------------------------------- // --SECTION-- protected methods // ----------------------------------------------------------------------------- //////////////////////////////////////////////////////////////////////////////// /// @brief returns the list of properties //////////////////////////////////////////////////////////////////////////////// bool RestQueryHandler::readQueryProperties () { try { auto queryList = static_cast(_vocbase->_queries); Json result(Json::Object); result .set("error", Json(false)) .set("code", Json(HttpResponse::OK)) .set("enabled", Json(queryList->enabled())) .set("trackSlowQueries", Json(queryList->trackSlowQueries())) .set("maxSlowQueries", Json(static_cast(queryList->maxSlowQueries()))) .set("slowQueryThreshold", Json(queryList->slowQueryThreshold())) .set("maxQueryStringLength", Json(static_cast(queryList->maxQueryStringLength()))); generateResult(HttpResponse::OK, result.json()); } catch (const TriagensError& err) { handleError(err); } catch (const Exception& err) { handleError(err); } catch (std::exception const& ex) { triagens::basics::InternalError err(ex, __FILE__, __LINE__); handleError(err); } catch (...) { triagens::basics::InternalError err("executeDirectHandler", __FILE__, __LINE__); handleError(err); } return true; } //////////////////////////////////////////////////////////////////////////////// /// @brief returns the list of slow queries //////////////////////////////////////////////////////////////////////////////// bool RestQueryHandler::readQuery (bool slow) { try { auto queryList = static_cast(_vocbase->_queries); auto const&& queries = slow ? queryList->listSlow() : queryList->listCurrent(); Json result(Json::Array); for (auto it : queries) { const auto&& timeString = TRI_StringTimeStamp(it.started); const auto& queryString = it.queryString; Json entry(Json::Object); entry .set("id", Json(StringUtils::itoa(it.id))) .set("query", Json(queryString)) .set("started", Json(timeString)) .set("runTime", Json(it.runTime)); result.add(entry); } generateResult(HttpResponse::OK, result.json()); } catch (const TriagensError& err) { handleError(err); } catch (const Exception& err) { handleError(err); } catch (std::exception const& ex) { triagens::basics::InternalError err(ex, __FILE__, __LINE__); handleError(err); } catch (...) { triagens::basics::InternalError err("executeDirectHandler", __FILE__, __LINE__); handleError(err); } return true; } //////////////////////////////////////////////////////////////////////////////// /// @brief returns AQL query tracking //////////////////////////////////////////////////////////////////////////////// bool RestQueryHandler::readQuery () { const auto& suffix = _request->suffix(); if (suffix.size() != 1) { generateError(HttpResponse::BAD, TRI_ERROR_HTTP_BAD_PARAMETER, "expecting GET /_api/query/"); return true; } const auto& name = suffix[0]; if (name == "slow") { return readQuery(true); } else if (name == "current") { return readQuery(false); } else if (name == "properties") { return readQueryProperties(); } generateError(HttpResponse::NOT_FOUND, TRI_ERROR_HTTP_NOT_FOUND, "unknown type '" + name + "', expecting 'slow', 'current', or 'properties'"); return true; } //////////////////////////////////////////////////////////////////////////////// /// @brief removes the slow log //////////////////////////////////////////////////////////////////////////////// bool RestQueryHandler::deleteQuerySlow () { auto queryList = static_cast(_vocbase->_queries); queryList->clearSlow(); Json result(Json::Object); // added a "generateOk"? result .set("error", Json(false)) .set("code", Json(HttpResponse::OK)); generateResult(HttpResponse::OK, result.json()); return true; } //////////////////////////////////////////////////////////////////////////////// /// @brief interrupts a named query //////////////////////////////////////////////////////////////////////////////// bool RestQueryHandler::deleteQuery (const string& name) { auto id = StringUtils::uint64(name); auto queryList = static_cast(_vocbase->_queries); TRI_ASSERT(queryList != nullptr); auto res = queryList->kill(id); if (res == TRI_ERROR_NO_ERROR) { Json result(Json::Object); result .set("error", Json(false)) .set("code", Json(HttpResponse::OK)); generateResult(HttpResponse::OK, result.json()); } else { generateError(HttpResponse::BAD, res, "cannot kill query '" + name + "'"); } return true; } //////////////////////////////////////////////////////////////////////////////// /// @brief interrupts a query //////////////////////////////////////////////////////////////////////////////// bool RestQueryHandler::deleteQuery () { const auto& suffix = _request->suffix(); if (suffix.size() != 1) { generateError(HttpResponse::BAD, TRI_ERROR_HTTP_BAD_PARAMETER, "expecting DELETE /_api/query/ or /_api/query/slow"); return true; } const auto& name = suffix[0]; if (name == "slow") { return deleteQuerySlow(); } else { return deleteQuery(name); } } //////////////////////////////////////////////////////////////////////////////// /// @brief changes the settings //////////////////////////////////////////////////////////////////////////////// bool RestQueryHandler::replaceProperties () { const auto& suffix = _request->suffix(); if (suffix.size() != 1 || suffix[0] != "properties") { generateError(HttpResponse::BAD, TRI_ERROR_HTTP_BAD_PARAMETER, "expecting PUT /_api/query/properties"); return true; } unique_ptr body(parseJsonBody()); if (body == nullptr) { // error message generated in parseJsonBody return true; } auto queryList = static_cast(_vocbase->_queries); try { bool enabled = queryList->enabled(); bool trackSlowQueries = queryList->trackSlowQueries(); size_t maxSlowQueries = queryList->maxSlowQueries(); double slowQueryThreshold = queryList->slowQueryThreshold(); size_t maxQueryStringLength = queryList->maxQueryStringLength(); // TODO(fc) add a "hasSomething" to JsonHelper? if (JsonHelper::getObjectElement(body.get(), "enabled") != nullptr) { enabled = JsonHelper::checkAndGetBooleanValue(body.get(), "enabled"); } if (JsonHelper::getObjectElement(body.get(), "trackSlowQueries") != nullptr) { trackSlowQueries = JsonHelper::checkAndGetBooleanValue(body.get(), "trackSlowQueries"); } if (JsonHelper::getObjectElement(body.get(), "maxSlowQueries") != nullptr) { maxSlowQueries = JsonHelper::checkAndGetNumericValue(body.get(), "maxSlowQueries"); } if (JsonHelper::getObjectElement(body.get(), "slowQueryThreshold") != nullptr) { slowQueryThreshold = JsonHelper::checkAndGetNumericValue(body.get(), "slowQueryThreshold"); } if (JsonHelper::getObjectElement(body.get(), "maxQueryStringLength") != nullptr) { maxQueryStringLength = JsonHelper::checkAndGetNumericValue(body.get(), "maxQueryStringLength"); } queryList->enabled(enabled); queryList->trackSlowQueries(trackSlowQueries); queryList->maxSlowQueries(maxSlowQueries); queryList->slowQueryThreshold(slowQueryThreshold); queryList->maxQueryStringLength(maxQueryStringLength); return readQueryProperties(); } catch (const TriagensError& err) { handleError(err); } catch (const Exception& err) { handleError(err); } catch (std::exception const& ex) { triagens::basics::InternalError err(ex, __FILE__, __LINE__); handleError(err); } catch (...) { triagens::basics::InternalError err("executeDirectHandler", __FILE__, __LINE__); handleError(err); } return true; } //////////////////////////////////////////////////////////////////////////////// /// @brief parses a query //////////////////////////////////////////////////////////////////////////////// bool RestQueryHandler::parseQuery () { const auto& suffix = _request->suffix(); if (! suffix.empty()) { generateError(HttpResponse::BAD, TRI_ERROR_HTTP_BAD_PARAMETER, "expecting POST /_api/query"); return true; } unique_ptr body(parseJsonBody()); if (body.get() == nullptr) { // error message generated in parseJsonBody return true; } try { const string&& queryString = JsonHelper::checkAndGetStringValue(body.get(), "query"); Query query(_applicationV8, true, _vocbase, queryString.c_str(), queryString.size(), nullptr, nullptr, PART_MAIN); auto parseResult = query.parse(); if (parseResult.code != TRI_ERROR_NO_ERROR) { generateError(HttpResponse::BAD, parseResult.code, parseResult.details); return true; } Json collections(Json::Array); for (const auto& it : parseResult.collectionNames) { collections.add(Json(it)); } Json bindVars(Json::Array); for (const auto& it : parseResult.bindParameters) { bindVars.add(Json(it)); } Json result(Json::Object); result .set("error", Json(false)) .set("code", Json(HttpResponse::OK)) .set("parsed", Json(true)) .set("collections", collections) .set("bindVars", bindVars) .set("ast", Json(TRI_UNKNOWN_MEM_ZONE, parseResult.json, Json::NOFREE).copy()); if (parseResult.warnings == nullptr) { result.set("warnings", Json(Json::Array)); } else { result.set("warnings", Json(TRI_UNKNOWN_MEM_ZONE, parseResult.warnings, Json::NOFREE).copy()); } generateResult(HttpResponse::OK, result.json()); } catch (const TriagensError& err) { handleError(err); } catch (const Exception& err) { handleError(err); } catch (std::exception const& ex) { triagens::basics::InternalError err(ex, __FILE__, __LINE__); handleError(err); } catch (...) { triagens::basics::InternalError err("executeDirectHandler", __FILE__, __LINE__); handleError(err); } return true; } // ----------------------------------------------------------------------------- // --SECTION-- END-OF-FILE // ----------------------------------------------------------------------------- // Local Variables: // mode: outline-minor // outline-regexp: "/// @brief\\|/// {@inheritDoc}\\|/// @page\\|// --SECTION--\\|/// @\\}" // End: