You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
121 lines
2.9 KiB
121 lines
2.9 KiB
/*
|
|
* Copyright (C) 2016 Hong Jen Yee (PCMan) <pcman.tw@gmail.com>
|
|
*
|
|
* This library 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 2.1 of the License, or (at your option) any later version.
|
|
*
|
|
* This library 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 this library; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
|
*
|
|
*/
|
|
|
|
#ifndef __LIBFM_QT_FM_JOB_H__
|
|
#define __LIBFM_QT_FM_JOB_H__
|
|
|
|
#include <libfm/fm.h>
|
|
#include <QObject>
|
|
#include <QtGlobal>
|
|
#include <QThread>
|
|
#include <QRunnable>
|
|
#include <memory>
|
|
#include <gio/gio.h>
|
|
#include "gobjectptr.h"
|
|
#include "gioptrs.h"
|
|
#include "../libfmqtglobals.h"
|
|
|
|
|
|
namespace Fm {
|
|
|
|
/*
|
|
* Fm::Job can be used in several different modes.
|
|
* 1. run with QThreadPool::start()
|
|
* 2. call runAsync(), which will create a new QThread and move the object to the thread.
|
|
* 3. create a new QThread, and connect the started() signal to the slot Job::run()
|
|
* 4. Directly call Job::run(), which executes synchrounously as a normal blocking call
|
|
*/
|
|
|
|
class LIBFM_QT_API Job: public QObject, public QRunnable {
|
|
Q_OBJECT
|
|
public:
|
|
|
|
enum class ErrorAction{
|
|
CONTINUE,
|
|
RETRY,
|
|
ABORT
|
|
};
|
|
|
|
enum class ErrorSeverity {
|
|
UNKNOWN,
|
|
WARNING,
|
|
MILD,
|
|
MODERATE,
|
|
SEVERE,
|
|
CRITICAL
|
|
};
|
|
|
|
explicit Job();
|
|
|
|
virtual ~Job();
|
|
|
|
bool isCancelled() const {
|
|
return g_cancellable_is_cancelled(cancellable_.get());
|
|
}
|
|
|
|
void runAsync(QThread::Priority priority = QThread::InheritPriority);
|
|
|
|
bool pause();
|
|
|
|
void resume();
|
|
|
|
const GCancellablePtr& cancellable() const {
|
|
return cancellable_;
|
|
}
|
|
|
|
Q_SIGNALS:
|
|
void cancelled();
|
|
|
|
void finished();
|
|
|
|
// this signal should be connected with Qt::BlockingQueuedConnection
|
|
void error(const GErrorPtr& err, ErrorSeverity severity, ErrorAction& response);
|
|
|
|
public Q_SLOTS:
|
|
|
|
void cancel();
|
|
|
|
void run() override;
|
|
|
|
protected:
|
|
ErrorAction emitError(const GErrorPtr& err, ErrorSeverity severity = ErrorSeverity::MODERATE);
|
|
|
|
// all derived job subclasses should do their work in this method.
|
|
virtual void exec() = 0;
|
|
|
|
private:
|
|
static void _onCancellableCancelled(GCancellable* cancellable, Job* _this) {
|
|
_this->onCancellableCancelled(cancellable);
|
|
}
|
|
|
|
void onCancellableCancelled(GCancellable* /*cancellable*/) {
|
|
Q_EMIT cancelled();
|
|
}
|
|
|
|
private:
|
|
bool paused_;
|
|
GCancellablePtr cancellable_;
|
|
gulong cancellableHandler_;
|
|
};
|
|
|
|
|
|
}
|
|
|
|
#endif // __LIBFM_QT_FM_JOB_H__
|