//////////////////////////////////////////////////////////////////////////////// /// @brief import request handler /// /// @file /// /// DISCLAIMER /// /// Copyright 2004-2013 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 triAGENS GmbH, Cologne, Germany /// /// @author Dr. Frank Celler /// @author Copyright 2010-2013, triAGENS GmbH, Cologne, Germany //////////////////////////////////////////////////////////////////////////////// #ifndef TRIAGENS_REST_HANDLER_REST_IMPORT_HANDLER_H #define TRIAGENS_REST_HANDLER_REST_IMPORT_HANDLER_H 1 #include "RestHandler/RestVocbaseBaseHandler.h" // ----------------------------------------------------------------------------- // --SECTION-- private defines // ----------------------------------------------------------------------------- //////////////////////////////////////////////////////////////////////////////// /// @addtogroup ArangoDB /// @{ //////////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////////// /// @brief import transaction shortcut //////////////////////////////////////////////////////////////////////////////// #define ImportTransactionType SingleCollectionWriteTransaction, UINT64_MAX> //////////////////////////////////////////////////////////////////////////////// /// @} //////////////////////////////////////////////////////////////////////////////// // ----------------------------------------------------------------------------- // --SECTION-- RestImportHandler // ----------------------------------------------------------------------------- //////////////////////////////////////////////////////////////////////////////// /// @addtogroup ArangoDB /// @{ //////////////////////////////////////////////////////////////////////////////// namespace triagens { namespace arango { // ----------------------------------------------------------------------------- // --SECTION-- RestImportResult // ----------------------------------------------------------------------------- struct RestImportResult { public: RestImportResult () : _numErrors(0), _numEmpty(0), _numCreated(0), _errors() { } ~RestImportResult () { } size_t _numErrors; size_t _numEmpty; size_t _numCreated; std::vector _errors; }; //////////////////////////////////////////////////////////////////////////////// /// @brief import request handler //////////////////////////////////////////////////////////////////////////////// class RestImportHandler : public RestVocbaseBaseHandler { //////////////////////////////////////////////////////////////////////////////// /// @} //////////////////////////////////////////////////////////////////////////////// // ----------------------------------------------------------------------------- // --SECTION-- constructors and destructors // ----------------------------------------------------------------------------- //////////////////////////////////////////////////////////////////////////////// /// @addtogroup ArangoDB /// @{ //////////////////////////////////////////////////////////////////////////////// public: //////////////////////////////////////////////////////////////////////////////// /// @brief constructor //////////////////////////////////////////////////////////////////////////////// RestImportHandler (rest::HttpRequest*); //////////////////////////////////////////////////////////////////////////////// /// @} //////////////////////////////////////////////////////////////////////////////// // ----------------------------------------------------------------------------- // --SECTION-- Handler methods // ----------------------------------------------------------------------------- //////////////////////////////////////////////////////////////////////////////// /// @addtogroup ArangoDB /// @{ //////////////////////////////////////////////////////////////////////////////// public: //////////////////////////////////////////////////////////////////////////////// /// {@inheritDoc} //////////////////////////////////////////////////////////////////////////////// status_t execute (); //////////////////////////////////////////////////////////////////////////////// /// @} //////////////////////////////////////////////////////////////////////////////// // ----------------------------------------------------------------------------- // --SECTION-- private methods // ----------------------------------------------------------------------------- //////////////////////////////////////////////////////////////////////////////// /// @addtogroup ArangoDB /// @{ //////////////////////////////////////////////////////////////////////////////// private: //////////////////////////////////////////////////////////////////////////////// /// @brief extracts the "complete" value //////////////////////////////////////////////////////////////////////////////// bool extractComplete () const; //////////////////////////////////////////////////////////////////////////////// /// @brief create a position string //////////////////////////////////////////////////////////////////////////////// std::string positionise (size_t) const; //////////////////////////////////////////////////////////////////////////////// /// @brief register an error //////////////////////////////////////////////////////////////////////////////// void registerError (RestImportResult&, std::string const&); //////////////////////////////////////////////////////////////////////////////// /// @brief process a single JSON document //////////////////////////////////////////////////////////////////////////////// int handleSingleDocument (ImportTransactionType&, TRI_json_t const*, std::string&, const bool, const bool, const size_t); //////////////////////////////////////////////////////////////////////////////// /// @brief creates documents by JSON objects /// each line of the input stream contains an individual JSON object //////////////////////////////////////////////////////////////////////////////// bool createFromJson (const string&); //////////////////////////////////////////////////////////////////////////////// /// @brief creates documents by JSON objects /// the input stream is one big JSON array containing all documents //////////////////////////////////////////////////////////////////////////////// bool createByDocumentsList (); //////////////////////////////////////////////////////////////////////////////// /// @brief creates a documents from key/value lists //////////////////////////////////////////////////////////////////////////////// bool createFromKeyValueList (); //////////////////////////////////////////////////////////////////////////////// /// @brief creates the result //////////////////////////////////////////////////////////////////////////////// void generateDocumentsCreated (RestImportResult const&); //////////////////////////////////////////////////////////////////////////////// /// @brief parses a string //////////////////////////////////////////////////////////////////////////////// TRI_json_t* parseJsonLine (const std::string&); //////////////////////////////////////////////////////////////////////////////// /// @brief builds a TRI_json_t object from a key and value list //////////////////////////////////////////////////////////////////////////////// TRI_json_t* createJsonObject (const TRI_json_t*, const TRI_json_t*, std::string&, const std::string&, const size_t); //////////////////////////////////////////////////////////////////////////////// /// @brief checks the keys, returns true if all values in the list are strings. //////////////////////////////////////////////////////////////////////////////// bool checkKeys (TRI_json_t const*); }; } } //////////////////////////////////////////////////////////////////////////////// /// @} //////////////////////////////////////////////////////////////////////////////// #endif // Local Variables: // mode: outline-minor // outline-regexp: "/// @brief\\|/// {@inheritDoc}\\|/// @addtogroup\\|/// @page\\|// --SECTION--\\|/// @\\}" // End: