//////////////////////////////////////////////////////////////////////////////// /// DISCLAIMER /// /// Copyright 2014-2016 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 Jan Steemann //////////////////////////////////////////////////////////////////////////////// #include "MMFilesEngine.h" using namespace arangodb; std::string const MMFilesEngine::EngineName("mmfiles"); // create the storage engine MMFilesEngine::MMFilesEngine(application_features::ApplicationServer* server) : StorageEngine(server, "mmfilesEngine") { } MMFilesEngine::~MMFilesEngine() { } // add the storage engine's specifc options to the global list of options void MMFilesEngine::collectOptions(std::shared_ptr) { } // validate the storage engine's specific options void MMFilesEngine::validateOptions(std::shared_ptr) { } // preparation phase for storage engine. can be used for internal setup. // the storage engine must not start any threads here or write any files void MMFilesEngine::prepare() { } // start the engine. now it's allowed to start engine-specific threads, // write files etc. void MMFilesEngine::start() { } // stop the storage engine. this can be used to flush all data to disk, // shutdown threads etc. it is guaranteed that there will be no read and // write requests to the storage engine after this call void MMFilesEngine::stop() { } // fill the Builder object with an array of databases that were detected // by the storage engine. this method must sort out databases that were not // fully created (see "createDatabase" below). called at server start only void MMFilesEngine::getDatabases(arangodb::velocypack::Builder& result) { } // fill the Builder object with an array of collections (and their corresponding // indexes) that were detected by the storage engine. called at server start only void MMFilesEngine::getCollectionsAndIndexes(arangodb::velocypack::Builder& result) { } // determine the maximum revision id previously handed out by the storage // engine. this value is used as a lower bound for further HLC values handed out by // the server. called at server start only, after getDatabases() and getCollectionsAndIndexes() uint64_t MMFilesEngine::getMaxRevision() { return 0; // TODO } // asks the storage engine to create a database as specified in the VPack // Slice object and persist the creation info. It is guaranteed by the server that // no other active database with the same name and id exists when this function // is called. If this operation fails somewhere in the middle, the storage // engine is required to fully clean up the creation and throw only then, // so that subsequent database creation requests will not fail. // the WAL entry for the database creation will be written *after* the call // to "createDatabase" returns void MMFilesEngine::createDatabase(TRI_voc_tick_t id, arangodb::velocypack::Slice const& data) { } // asks the storage engine to drop the specified database and persist the // deletion info. Note that physical deletion of the database data must not // be carried out by this call, as there may // still be readers of the database's data. It is recommended that this operation // only sets a deletion flag for the database but let's an async task perform // the actual deletion. The async task can later call the callback function to // check whether the physical deletion of the database is possible. // the WAL entry for database deletion will be written *after* the call // to "dropDatabase" returns void MMFilesEngine::dropDatabase(TRI_voc_tick_t id, std::function const& canRemovePhysically) { } // asks the storage engine to create a collection as specified in the VPack // Slice object and persist the creation info. It is guaranteed by the server // that no other active collection with the same name and id exists in the same // database when this function is called. If this operation fails somewhere in // the middle, the storage engine is required to fully clean up the creation // and throw only then, so that subsequent collection creation requests will not fail. // the WAL entry for the collection creation will be written *after* the call // to "createCollection" returns void MMFilesEngine::createCollection(TRI_voc_tick_t databaseId, TRI_voc_cid_t id, arangodb::velocypack::Slice const& data) { } // asks the storage engine to drop the specified collection and persist the // deletion info. Note that physical deletion of the collection data must not // be carried out by this call, as there may // still be readers of the collection's data. It is recommended that this operation // only sets a deletion flag for the collection but let's an async task perform // the actual deletion. // the WAL entry for collection deletion will be written *after* the call // to "dropCollection" returns void MMFilesEngine::dropCollection(TRI_voc_tick_t databaseId, TRI_voc_cid_t id, std::function const& canRemovePhysically) { } // asks the storage engine to rename the collection as specified in the VPack // Slice object and persist the renaming info. It is guaranteed by the server // that no other active collection with the same name and id exists in the same // database when this function is called. If this operation fails somewhere in // the middle, the storage engine is required to fully revert the rename operation // and throw only then, so that subsequent collection creation/rename requests will // not fail. the WAL entry for the rename will be written *after* the call // to "renameCollection" returns void MMFilesEngine::renameCollection(TRI_voc_tick_t databaseId, TRI_voc_cid_t id, arangodb::velocypack::Slice const& data) { } // asks the storage engine to change properties of the collection as specified in // the VPack Slice object and persist them. If this operation fails // somewhere in the middle, the storage engine is required to fully revert the // property changes and throw only then, so that subsequent operations will not fail. // the WAL entry for the propery change will be written *after* the call // to "changeCollection" returns void MMFilesEngine::changeCollection(TRI_voc_tick_t databaseId, TRI_voc_cid_t id, arangodb::velocypack::Slice const& data) { } // asks the storage engine to create an index as specified in the VPack // Slice object and persist the creation info. The database id, collection id // and index data are passed in the Slice object. Note that this function // is not responsible for inserting the individual documents into the index. // If this operation fails somewhere in the middle, the storage engine is required // to fully clean up the creation and throw only then, so that subsequent index // creation requests will not fail. // the WAL entry for the index creation will be written *after* the call // to "createIndex" returns void MMFilesEngine::createIndex(TRI_voc_tick_t databaseId, TRI_voc_cid_t collectionId, TRI_idx_iid_t id, arangodb::velocypack::Slice const& data) { } // asks the storage engine to drop the specified index and persist the deletion // info. Note that physical deletion of the index must not be carried out by this call, // as there may still be users of the index. It is recommended that this operation // only sets a deletion flag for the index but let's an async task perform // the actual deletion. // the WAL entry for index deletion will be written *after* the call // to "dropIndex" returns void MMFilesEngine::dropIndex(TRI_voc_tick_t databaseId, TRI_voc_cid_t collectionId, TRI_idx_iid_t id) { } // iterate all documents of the underlying collection // this is called when a collection is openend, and all its documents need to be added to // indexes etc. void MMFilesEngine::iterateDocuments(TRI_voc_tick_t databaseId, TRI_voc_cid_t collectionId, std::function const& cb) { } // adds a document to the storage engine // this will be called by the WAL collector when surviving documents are being moved // into the storage engine's realm void MMFilesEngine::addDocumentRevision(TRI_voc_tick_t databaseId, TRI_voc_cid_t collectionId, arangodb::velocypack::Slice const& document) { } // removes a document from the storage engine // this will be called by the WAL collector when non-surviving documents are being removed // from the storage engine's realm void MMFilesEngine::removeDocumentRevision(TRI_voc_tick_t databaseId, TRI_voc_cid_t collectionId, arangodb::velocypack::Slice const& document) { }