// Copyright (C) 2018 Jakub Melka // // This file is part of PdfForQt. // // PdfForQt is free software: you can redistribute it and/or modify // it under the terms of the GNU Lesser General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // PdfForQt 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 Lesser General Public License for more details. // // You should have received a copy of the GNU Lesser General Public License // along with PDFForQt. If not, see . #ifndef PDFVISITOR_H #define PDFVISITOR_H #include "pdfglobal.h" #include "pdfobject.h" #include "pdfdocument.h" #include #include #include #include namespace pdf { /// Abstract visitor, can iterate trough object tree class PDFAbstractVisitor { public: /// This enum identifies how the tree of objects should be processed. /// Some visitors allow parallel (concurrent) run, some visitors are not /// thread safe, so they run in single thread. Please select strategy /// of your visitor carefully to avoid race conditions. enum class Strategy { /// Visitor with this strategy allows fully parallel run across multiple threads. /// So single instance of visitor is used and it is assumed, that all functions /// are thread safe. This means full parallelization. Parallel, /// Merging paraller strategy. For each thread, instance of visitor is created, and /// run on object tree. Then they are merged by the \p merge function. Strategy assumes, /// that \p merge function is not reentrant, and it is not run by multiple threads /// on same object. Locking is not needed in this function. Merging, /// Do not allow parallel run, use single instance and single thread run. This can /// be slower than previous two strategies, but allows visitor not to be thread /// safe. Use this strategy on visitors, which can't be thread safe from principle. Sequential }; explicit constexpr PDFAbstractVisitor() = default; virtual ~PDFAbstractVisitor() = default; virtual void visitNull() { } virtual void visitBool(bool value) { Q_UNUSED(value); } virtual void visitInt(PDFInteger value) { Q_UNUSED(value); } virtual void visitReal(PDFReal value) { Q_UNUSED(value); } virtual void visitString(const PDFString* string) { Q_UNUSED(string); } virtual void visitName(const PDFString* name) { Q_UNUSED(name); } virtual void visitArray(const PDFArray* array) { Q_UNUSED(array); } virtual void visitDictionary(const PDFDictionary* dictionary) { Q_UNUSED(dictionary); } virtual void visitStream(const PDFStream* stream) { Q_UNUSED(stream); } virtual void visitReference(const PDFObjectReference reference) { Q_UNUSED(reference); } protected: void acceptArray(const PDFArray* array); void acceptDictionary(const PDFDictionary* dictionary); void acceptStream(const PDFStream* stream); }; /// Statistics visitor, collects statistics about PDF object, can be /// invoked from multiple threads. class PDFFORQTLIBSHARED_EXPORT PDFStatisticsCollector : public PDFAbstractVisitor { public: explicit PDFStatisticsCollector(); virtual ~PDFStatisticsCollector() override = default; /// We implement this visitor as fully parallel static constexpr const Strategy VisitorStrategy = Strategy::Parallel; struct Statistics { explicit constexpr Statistics() = default; /// This constructor must not be used while \p other is write-accessed from another thread. /// We use relaxed memory order, because we assume this constructor is used only while /// copying data, not when statistics is collected. /// \param other Object, from which data should be copied inline Statistics(const Statistics& other) : count(other.count.load(std::memory_order_relaxed)), memoryConsumptionEstimate(other.memoryConsumptionEstimate.load(std::memory_order_relaxed)), memoryOverheadEstimate(other.memoryOverheadEstimate.load(std::memory_order_relaxed)) { } std::atomic_uint64_t count = 0; std::atomic_uint64_t memoryConsumptionEstimate = 0; std::atomic_uint64_t memoryOverheadEstimate = 0; }; virtual void visitNull() override; virtual void visitBool(bool value) override; virtual void visitInt(PDFInteger value) override; virtual void visitReal(PDFReal value) override; virtual void visitString(const PDFString* string) override; virtual void visitName(const PDFString* name) override; virtual void visitArray(const PDFArray* array) override; virtual void visitDictionary(const PDFDictionary* dictionary) override; virtual void visitStream(const PDFStream* stream) override; virtual void visitReference(const PDFObjectReference reference) override; private: void collectStatisticsOfSimpleObject(PDFObject::Type type); void collectStatisticsOfString(const PDFString* string, Statistics& statistics); void collectStatisticsOfDictionary(Statistics& statistics, const PDFDictionary* dictionary); std::map m_statistics; }; template struct PDFApplyVisitorImpl; template void PDFApplyVisitor(const PDFDocument& document, Visitor* visitor) { PDFApplyVisitorImpl::apply(document, visitor); } template struct PDFApplyVisitorImpl { // Do nothing, no strategy defined }; template struct PDFApplyVisitorImpl { static void apply(const PDFDocument& document, Visitor* visitor) { const PDFObjectStorage& storage = document.getStorage(); const PDFObjectStorage::PDFObjects& objects = storage.getObjects(); const PDFObject& trailerDictionary = storage.getTrailerDictionary(); std::for_each(std::execution::parallel_policy(), objects.cbegin(), objects.cend(), [visitor](const PDFObjectStorage::Entry& entry) { entry.object.accept(visitor); }); trailerDictionary.accept(visitor); } }; template struct PDFApplyVisitorImpl { static void apply(const PDFDocument& document, Visitor* visitor) { const PDFObjectStorage& storage = document.getStorage(); const PDFObjectStorage::PDFObjects& objects = storage.getObjects(); const PDFObject& trailerDictionary = storage.getTrailerDictionary(); QMutex mutex; auto process = [&mutex, visitor](const PDFObjectStorage::Entry& entry) { Visitor localVisitor; entry.object.accept(&localVisitor); QMutexLocker lock(&mutex); visitor->merge(&localVisitor); }; std::for_each(std::execution::parallel_policy(), objects.cbegin(), objects.cend(), process); trailerDictionary.accept(visitor); } }; template struct PDFApplyVisitorImpl { static void apply(const PDFDocument& document, Visitor* visitor) { const PDFObjectStorage& storage = document.getStorage(); const PDFObjectStorage::PDFObjects& objects = storage.getObjects(); const PDFObject& trailerDictionary = storage.getTrailerDictionary(); std::for_each(std::execution::sequenced_policy(), objects.cbegin(), objects.cend(), [](const PDFObjectStorage::Entry& entry) { entry.object.accept(visitor); }); trailerDictionary.accept(visitor); } }; } // namespace pdf #endif // PDFVISITOR_H