/* * Copyright (C) by Klaas Freitag * * 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; version 2 of the License. * * 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. */ #ifndef PROGRESSDISPATCHER_H #define PROGRESSDISPATCHER_H #include "owncloudlib.h" #include #include #include #include #include #include #include "syncfileitem.h" namespace OCC { /** * @brief The FolderScheduler class schedules folders for sync */ namespace Progress { /** Return true is the size need to be taken in account in the total amount of time */ inline bool isSizeDependent(csync_instructions_e instruction) { return instruction == CSYNC_INSTRUCTION_CONFLICT || instruction == CSYNC_INSTRUCTION_SYNC || instruction == CSYNC_INSTRUCTION_NEW; } struct Info { Info() : _totalFileCount(0), _totalSize(0), _completedFileCount(0), _completedSize(0) {} // Used during local and remote update phase QString _currentDiscoveredFolder; quint64 _totalFileCount; quint64 _totalSize; quint64 _completedFileCount; quint64 _completedSize; // Should this be in a separate file? struct EtaEstimate { EtaEstimate() : _startedTime(QDateTime::currentMSecsSinceEpoch()), _agvEtaMSecs(0),_effectivProgressPerSec(0),_sampleCount(1) {} static const int MAX_AVG_DIVIDER=60; static const int INITAL_WAIT_TIME=5; quint64 _startedTime ; quint64 _agvEtaMSecs; quint64 _effectivProgressPerSec; float _sampleCount; /** * reset the estiamte. */ void reset() { _startedTime = QDateTime::currentMSecsSinceEpoch(); _sampleCount =1; _effectivProgressPerSec = _agvEtaMSecs = 0; } /** * update the estimated eta time with more current data. * @param quint64 completed the amount the was completed. * @param quint64 total the total amout that should be completed. */ void updateTime(quint64 completed, quint64 total) { quint64 elapsedTime = QDateTime::currentMSecsSinceEpoch() - this->_startedTime ; //don't start until you have some good data to process, prevents jittring estiamtes at the start of the syncing process if(total != 0 && completed != 0 && elapsedTime > INITAL_WAIT_TIME ) { if(_sampleCount < MAX_AVG_DIVIDER) { _sampleCount+=0.01f; } // (elapsedTime-1) is an hack to avoid float "rounding" issue (ie. 0.99999999999999999999....) _agvEtaMSecs = _agvEtaMSecs + (((static_cast(total) / completed) * elapsedTime) - (elapsedTime-1)) - this->getEtaEstimate(); _effectivProgressPerSec = ( total - completed ) / (1+this->getEtaEstimate()/1000); } } /** * Get the eta estimate in milliseconds * @return quint64 the estimate amount of milliseconds to end the process. */ quint64 getEtaEstimate() const { return _agvEtaMSecs / _sampleCount; } /** * Get the estimated average bandwidth usage. * @return quint64 the estimated bandwidth usage in bytes. */ quint64 getEstimatedBandwidth() const { return _effectivProgressPerSec; } }; EtaEstimate _totalEtaEstimate; struct ProgressItem { ProgressItem() : _completedSize(0) {} SyncFileItem _item; quint64 _completedSize; EtaEstimate _etaEstimate; }; QHash _currentItems; SyncFileItem _lastCompletedItem; void setProgressComplete(const SyncFileItem &item) { _currentItems.remove(item._file); _completedFileCount += item._affectedItems; if (!item._isDirectory) { if (Progress::isSizeDependent(item._instruction)) { _completedSize += item._size; } } _lastCompletedItem = item; this->updateEstimation(); } void setProgressItem(const SyncFileItem &item, quint64 size) { _currentItems[item._file]._item = item; _currentItems[item._file]._completedSize = size; _lastCompletedItem = SyncFileItem(); this->updateEstimation(); _currentItems[item._file]._etaEstimate.updateTime(size,item._size); } void updateEstimation() { if(this->_totalSize > 0) { _totalEtaEstimate.updateTime(this->completedSize(),this->_totalSize); } else { _totalEtaEstimate.updateTime(this->_completedFileCount,this->_totalFileCount); } } quint64 completedSize() const { quint64 r = _completedSize; foreach(const ProgressItem &i, _currentItems) { if (!i._item._isDirectory) r += i._completedSize; } return r; } /** * Get the total completion estimate structure * @return EtaEstimate a structure containing the total completion information. */ EtaEstimate totalEstimate() const { return _totalEtaEstimate; } /** * Get the current file completion estimate structure * @return EtaEstimate a structure containing the current file completion information. */ EtaEstimate getFileEstimate(const SyncFileItem &item) const { return _currentItems[item._file]._etaEstimate; } }; OWNCLOUDSYNC_EXPORT QString asActionString( const SyncFileItem& item ); OWNCLOUDSYNC_EXPORT QString asResultString( const SyncFileItem& item ); OWNCLOUDSYNC_EXPORT bool isWarningKind( SyncFileItem::Status ); OWNCLOUDSYNC_EXPORT bool isIgnoredKind( SyncFileItem::Status ); } /** * @file progressdispatcher.h * @brief A singleton class to provide sync progress information to other gui classes. * * How to use the ProgressDispatcher: * Just connect to the two signals either to progress for every individual file * or the overall sync progress. * */ class OWNCLOUDSYNC_EXPORT ProgressDispatcher : public QObject { Q_OBJECT friend class Folder; // only allow Folder class to access the setting slots. public: static ProgressDispatcher* instance(); ~ProgressDispatcher(); signals: /** @brief Signals the progress of data transmission. @param[out] folder The folder which is being processed @param[out] progress A struct with all progress info. */ void progressInfo( const QString& folder, const Progress::Info& progress ); /** * @brief: the item's job is completed */ void jobCompleted(const QString &folder, const SyncFileItem & item); void syncItemDiscovered(const QString &folder, const SyncFileItem & item); protected: void setProgressInfo(const QString& folder, const Progress::Info& progress); private: ProgressDispatcher(QObject* parent = 0); QElapsedTimer _timer; static ProgressDispatcher* _instance; }; } #endif // PROGRESSDISPATCHER_H