/* * Copyright (C) 2014 Christian Mollekopf * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the * Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. */ #pragma once #include "facadeinterface.h" #include #include #include "resourceaccess.h" #include "commands.h" #include "domainadaptor.h" #include "log.h" #include "resultset.h" #include "entitystorage.h" /** * A QueryRunner runs a query and updates the corresponding result set. * * The lifetime of the QueryRunner is defined by the resut set (otherwise it's doing useless work), * and by how long a result set must be updated. If the query is one off the runner dies after the execution, * otherwise it lives on the react to changes and updates the corresponding result set. * * QueryRunner has to keep ResourceAccess alive in order to keep getting updates. */ class QueryRunner : public QObject { Q_OBJECT public: typedef std::function()> QueryFunction; QueryRunner(const Akonadi2::Query &query) {}; /** * Starts query */ KAsync::Job run(qint64 newRevision = 0) { return queryFunction(); } /** * Set the query to run */ void setQuery(const QueryFunction &query) { queryFunction = query; } public slots: /** * Rerun query with new revision */ void revisionChanged(qint64 newRevision) { Trace() << "New revision: " << newRevision; run().exec(); } private: QueryFunction queryFunction; }; static inline ResultSet fullScan(const Akonadi2::Storage::Transaction &transaction, const QByteArray &bufferType) { //TODO use a result set with an iterator, to read values on demand QVector keys; transaction.openDatabase(bufferType + ".main").scan(QByteArray(), [&](const QByteArray &key, const QByteArray &value) -> bool { //Skip internals if (Akonadi2::Storage::isInternalKey(key)) { return true; } keys << Akonadi2::Storage::uidFromKey(key); return true; }, [](const Akonadi2::Storage::Error &error) { qWarning() << "Error during query: " << error.message; }); Trace() << "Full scan found " << keys.size() << " results"; return ResultSet(keys); } namespace Akonadi2 { /** * Default facade implementation for resources that are implemented in a separate process using the ResourceAccess class. * * Ideally a basic resource has no implementation effort for the facades and can simply instanciate default implementations (meaning it only has to implement the factory with all supported types). * A resource has to implement: * * A facade factory registering all available facades * * An adaptor factory if it uses special resource buffers (default implementation can be used otherwise) * * A mapping between resource and buffertype if default can't be used. * * Additionally a resource only has to provide a synchronizer plugin to execute the synchronization */ template class GenericFacade: public Akonadi2::StoreFacade { public: /** * Create a new GenericFacade * * @param resourceIdentifier is the identifier of the resource instance * @param adaptorFactory is the adaptor factory used to generate the mappings from domain to resource types and vice versa */ GenericFacade(const QByteArray &resourceIdentifier, const DomainTypeAdaptorFactoryInterface::Ptr &adaptorFactory = DomainTypeAdaptorFactoryInterface::Ptr(), const QSharedPointer resourceAccess = QSharedPointer()) : Akonadi2::StoreFacade(), mResourceAccess(resourceAccess), mDomainTypeAdaptorFactory(adaptorFactory), mResourceInstanceIdentifier(resourceIdentifier) { if (!mResourceAccess) { mResourceAccess = QSharedPointer::create(resourceIdentifier); } } ~GenericFacade() { } static QByteArray bufferTypeForDomainType() { //We happen to have a one to one mapping return Akonadi2::ApplicationDomain::getTypeName(); } KAsync::Job create(const DomainType &domainObject) Q_DECL_OVERRIDE { if (!mDomainTypeAdaptorFactory) { Warning() << "No domain type adaptor factory available"; return KAsync::error(); } flatbuffers::FlatBufferBuilder entityFbb; mDomainTypeAdaptorFactory->createBuffer(domainObject, entityFbb); return mResourceAccess->sendCreateCommand(bufferTypeForDomainType(), QByteArray::fromRawData(reinterpret_cast(entityFbb.GetBufferPointer()), entityFbb.GetSize())); } KAsync::Job modify(const DomainType &domainObject) Q_DECL_OVERRIDE { if (!mDomainTypeAdaptorFactory) { Warning() << "No domain type adaptor factory available"; return KAsync::error(); } flatbuffers::FlatBufferBuilder entityFbb; mDomainTypeAdaptorFactory->createBuffer(domainObject, entityFbb); return mResourceAccess->sendModifyCommand(domainObject.identifier(), domainObject.revision(), bufferTypeForDomainType(), QByteArrayList(), QByteArray::fromRawData(reinterpret_cast(entityFbb.GetBufferPointer()), entityFbb.GetSize())); } KAsync::Job remove(const DomainType &domainObject) Q_DECL_OVERRIDE { return mResourceAccess->sendDeleteCommand(domainObject.identifier(), domainObject.revision(), bufferTypeForDomainType()); } //TODO JOBAPI return job from sync continuation to execute it as subjob? KAsync::Job load(const Akonadi2::Query &query, const QSharedPointer > &resultProvider) Q_DECL_OVERRIDE { auto fetchEntities = [this, query, resultProvider](const QByteArray &parent) { Trace() << "Fetching initial set for parent:" << parent; Akonadi2::Storage storage(Akonadi2::storageLocation(), mResourceInstanceIdentifier); storage.setDefaultErrorHandler([](const Akonadi2::Storage::Error &error) { Warning() << "Error during query: " << error.store << error.message; }); auto transaction = storage.createTransaction(Akonadi2::Storage::ReadOnly); auto modifiedQuery = query; modifiedQuery.propertyFilter.insert("parent", parent); QSet remainingFilters; auto resultSet = loadInitialResultSet(parent, modifiedQuery, transaction, remainingFilters); auto filteredSet = filterSet(resultSet, getFilter(remainingFilters, query), transaction, true); replaySet(filteredSet, resultProvider); const qint64 newRevision = Akonadi2::Storage::maxRevision(transaction); resultProvider->setRevision(newRevision); mResourceAccess->sendRevisionReplayedCommand(newRevision); }; resultProvider->setFetcher(fetchEntities); auto runner = QSharedPointer::create(query); QWeakPointer > weakResultProvider = resultProvider; runner->setQuery([this, weakResultProvider, query] () -> KAsync::Job { return KAsync::start([this, weakResultProvider, query](KAsync::Future &future) { Trace() << "Executing query "; auto resultProvider = weakResultProvider.toStrongRef(); if (!resultProvider) { Warning() << "Tried executing query after result provider is already gone"; future.setError(0, QString()); future.setFinished(); return; } executeQuery(query, resultProvider).template then([&future, this](qint64 queriedRevision) { mResourceAccess->sendRevisionReplayedCommand(queriedRevision); future.setFinished(); }).exec(); }); }); //In case of a live query we keep the runner for as long alive as the result provider exists if (query.liveQuery) { resultProvider->setQueryRunner(runner); //Ensure the connection is open, if it wasn't already opened //TODO If we are not connected already, we have to check for the latest revision once connected, otherwise we could miss some updates mResourceAccess->open(); QObject::connect(mResourceAccess.data(), &Akonadi2::ResourceAccess::revisionChanged, runner.data(), &QueryRunner::revisionChanged); } return KAsync::null(); //We have to capture the runner to keep it alive } private: //TODO move into result provider? void replaySet(ResultSet &resultSet, const QSharedPointer > &resultProvider) { while (resultSet.next([this, resultProvider](const Akonadi2::ApplicationDomain::ApplicationDomainType::Ptr &value, Akonadi2::Operation operation) -> bool { switch (operation) { case Akonadi2::Operation_Creation: Trace() << "Got creation"; //TODO Only copy in result provider resultProvider->add(Akonadi2::ApplicationDomain::ApplicationDomainType::getInMemoryRepresentation(*value).template staticCast()); break; case Akonadi2::Operation_Modification: Trace() << "Got modification"; resultProvider->modify(Akonadi2::ApplicationDomain::ApplicationDomainType::getInMemoryRepresentation(*value).template staticCast()); break; case Akonadi2::Operation_Removal: Trace() << "Got removal"; resultProvider->remove(Akonadi2::ApplicationDomain::ApplicationDomainType::getInMemoryRepresentation(*value).template staticCast()); break; } return true; })){}; } void readEntity(const Akonadi2::Storage::Transaction &transaction, const QByteArray &key, const std::function &resultCallback) { const auto bufferType = bufferTypeForDomainType(); //This only works for a 1:1 mapping of resource to domain types. //Not i.e. for tags that are stored as flags in each entity of an imap store. //additional properties that don't have a 1:1 mapping (such as separately stored tags), //could be added to the adaptor. // // Akonadi2::Storage::getLatest(transaction, bufferTye, key); transaction.openDatabase(bufferType + ".main").findLatest(key, [=](const QByteArray &key, const QByteArray &value) -> bool { Akonadi2::EntityBuffer buffer(value.data(), value.size()); const Akonadi2::Entity &entity = buffer.entity(); const auto metadataBuffer = Akonadi2::EntityBuffer::readBuffer(entity.metadata()); Q_ASSERT(metadataBuffer); const qint64 revision = metadataBuffer ? metadataBuffer->revision() : -1; resultCallback(DomainType::Ptr::create(mResourceInstanceIdentifier, Akonadi2::Storage::uidFromKey(key), revision, mDomainTypeAdaptorFactory->createAdaptor(entity)), metadataBuffer->operation()); return false; }, [](const Akonadi2::Storage::Error &error) { qWarning() << "Error during query: " << error.message; }); } ResultSet loadInitialResultSet(const QByteArray &parent, const Akonadi2::Query &query, Akonadi2::Storage::Transaction &transaction, QSet &remainingFilters) { Trace() << "Fetching initial set for parent:" << parent; //TODO QSet appliedFilters; auto resultSet = Akonadi2::ApplicationDomain::TypeImplementation::queryIndexes(query, mResourceInstanceIdentifier, appliedFilters, transaction); remainingFilters = query.propertyFilter.keys().toSet() - appliedFilters; //We do a full scan if there were no indexes available to create the initial set. if (appliedFilters.isEmpty()) { //TODO this should be replaced by an index lookup as well resultSet = fullScan(transaction, bufferTypeForDomainType()); } return resultSet; } ResultSet loadIncrementalResultSet(qint64 baseRevision, const Akonadi2::Query &query, Akonadi2::Storage::Transaction &transaction, QSet &remainingFilters) { Trace() << "Loading incremental result set starting from revision: " << baseRevision; const auto bufferType = bufferTypeForDomainType(); auto revisionCounter = QSharedPointer::create(baseRevision); return ResultSet([bufferType, revisionCounter, &transaction]() -> QByteArray { const qint64 topRevision = Akonadi2::Storage::maxRevision(transaction); //Spit out the revision keys one by one. while (*revisionCounter <= topRevision) { const auto uid = Akonadi2::Storage::getUidFromRevision(transaction, *revisionCounter); const auto type = Akonadi2::Storage::getTypeFromRevision(transaction, *revisionCounter); Trace() << "Revision" << *revisionCounter << type << uid; if (type != bufferType) { //Skip revision *revisionCounter += 1; continue; } const auto key = Akonadi2::Storage::assembleKey(uid, *revisionCounter); *revisionCounter += 1; return key; } //We're done return QByteArray(); }); } ResultSet filterSet(const ResultSet &resultSet, const std::function &filter, const Akonadi2::Storage::Transaction &transaction, bool initialQuery) { auto resultSetPtr = QSharedPointer::create(resultSet); //Read through the source values and return whatever matches the filter std::function)> generator = [this, resultSetPtr, &transaction, filter, initialQuery](std::function callback) -> bool { while (resultSetPtr->next()) { //readEntity is only necessary if we actually want to filter or know the operation type (but not a big deal if we do it always I guess) readEntity(transaction, resultSetPtr->id(), [this, filter, callback, initialQuery](const Akonadi2::ApplicationDomain::ApplicationDomainType::Ptr &domainObject, Akonadi2::Operation operation) { //Always remove removals, they probably don't match due to non-available properties if (filter(domainObject) || operation == Akonadi2::Operation_Removal) { if (initialQuery) { //We're not interested in removals during the initial query if (operation != Akonadi2::Operation_Removal) { callback(domainObject, Akonadi2::Operation_Creation); } } else { callback(domainObject, operation); } } }); } return false; }; return ResultSet(generator); } std::function getFilter(const QSet remainingFilters, const Akonadi2::Query &query) { return [remainingFilters, query](const Akonadi2::ApplicationDomain::ApplicationDomainType::Ptr &domainObject) -> bool { for (const auto &filterProperty : remainingFilters) { //TODO implement other comparison operators than equality if (domainObject->getProperty(filterProperty) != query.propertyFilter.value(filterProperty)) { return false; } } return true; }; } virtual KAsync::Job executeQuery(const Akonadi2::Query &query, const QSharedPointer > &resultProvider) { /* * This method gets called initially, and after every revision change. * * We delegate loading of initial data to the result provider, os it can decide for itself what it needs to load. * * Incremental updates are loaded directly, leaving it up to the model to discard the changes if they are not interesting */ const qint64 baseRevision = resultProvider->revision() + 1; Trace() << "Running query " << baseRevision; QSet remainingFilters; Trace() << "Fetching updates"; Akonadi2::Storage storage(Akonadi2::storageLocation(), mResourceInstanceIdentifier); storage.setDefaultErrorHandler([](const Akonadi2::Storage::Error &error) { Warning() << "Error during query: " << error.store << error.message; }); auto transaction = storage.createTransaction(Akonadi2::Storage::ReadOnly); auto resultSet = loadIncrementalResultSet(baseRevision, query, transaction, remainingFilters); auto filteredSet = filterSet(resultSet, getFilter(remainingFilters, query), transaction, false); replaySet(filteredSet, resultProvider); resultProvider->setRevision(Akonadi2::Storage::maxRevision(transaction)); qint64 newRevision = Akonadi2::Storage::maxRevision(transaction); return KAsync::start([=]() -> qint64 { return newRevision; }); } protected: //TODO use one resource access instance per application & per resource QSharedPointer mResourceAccess; DomainTypeAdaptorFactoryInterface::Ptr mDomainTypeAdaptorFactory; QByteArray mResourceInstanceIdentifier; }; }