mirror of
https://bitbucket.org/smil3y/kdelibs.git
synced 2025-02-24 19:02:48 +00:00
61333c4671
most of the changes were done trought Katie's namefsck script which convertes forward class declarations to include directives, however other fixes here and there were needed as well as some questionable changes to Q_DECLARE_TYPEINFO() macro calls because they most likely have to do the namespacing themselfs (QT_BEGIN/END_NAMESPACE, and probably will be in Katie) meaning that some of the changes may be temporary and reverted later. Signed-off-by: Ivailo Monev <xakepa10@gmail.com>
120 lines
3.6 KiB
C++
120 lines
3.6 KiB
C++
/* -*- C++ -*-
|
|
|
|
This file implements the DependencyPolicy class.
|
|
|
|
$ Author: Mirko Boehm $
|
|
$ Copyright: (C) 2004-2013 Mirko Boehm $
|
|
$ Contact: mirko@kde.org
|
|
http://www.kde.org
|
|
http://creative-destruction.me $
|
|
|
|
This library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Library General Public
|
|
License as published by the Free Software Foundation; either
|
|
version 2 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
|
|
Library General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Library General Public License
|
|
along with this library; see the file COPYING.LIB. If not, write to
|
|
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
Boston, MA 02110-1301, USA.
|
|
|
|
$Id: DependencyPolicy.cpp 20 2005-08-08 21:02:51Z mirko $
|
|
*/
|
|
|
|
#ifndef DEPENDENCYPOLICY_H
|
|
#define DEPENDENCYPOLICY_H
|
|
|
|
#include <QList>
|
|
|
|
#include "QueuePolicy.h"
|
|
|
|
namespace ThreadWeaver {
|
|
|
|
/** DependencyPolicy implements the way dependencies between Jobs are handled.
|
|
|
|
To declare that Job B can only be executed when Job A is finished,
|
|
call addDependency.
|
|
|
|
Be aware of circular dependencies. All dependencies on a Job will be
|
|
removed if the Job object is destructed.
|
|
|
|
JobSequence uses dependencies to implement the ordered execution of
|
|
the sequence elements.
|
|
*/
|
|
class THREADWEAVER_EXPORT DependencyPolicy : public QueuePolicy
|
|
{
|
|
public:
|
|
/** Destructor. */
|
|
~DependencyPolicy();
|
|
|
|
/** Add jobB as a dependency of jobA.
|
|
jobA will only be executed after jobB has been successfully processed.
|
|
@param jobA the depending job
|
|
@param jobB the job jobA depends on
|
|
*/
|
|
void addDependency( Job* jobA, Job* jobB );
|
|
|
|
/** Remove dependency.
|
|
|
|
The dependency of jobA on jobB is removed. If no dependencies are
|
|
left for jobA, canRun will return true.
|
|
|
|
Returns false if the given object is not dependency of this job.
|
|
|
|
This function is inefficient, and should be used only to abort
|
|
execution of a job.
|
|
|
|
@param jobA the depending job
|
|
@param jobB the job jobA depends on
|
|
@return true if dependency existed, false otherwise
|
|
*/
|
|
bool removeDependency( Job* jobA, Job* jobB );
|
|
|
|
/** Resolve all dependencies.
|
|
This method is called after the Job has been finished, or
|
|
when it is deleted without being executed (performed by the
|
|
destructor).
|
|
The method will remove all entries stating that another Job
|
|
depends on this one.
|
|
*/
|
|
void resolveDependencies ( Job* );
|
|
|
|
/** Retrieve a list of dependencies of this job. */
|
|
QList<Job*> getDependencies( Job* ) const;
|
|
|
|
// FIXME add factory method for singleton creation
|
|
static DependencyPolicy& instance();
|
|
|
|
bool canRun( Job* );
|
|
|
|
void free( Job* );
|
|
|
|
void release( Job* );
|
|
|
|
void destructed( Job* );
|
|
|
|
protected:
|
|
/** Query whether the job has an unresolved dependency.
|
|
In case it does, the policy will return false from canRun().
|
|
*/
|
|
bool hasUnresolvedDependencies( Job* ) const;
|
|
|
|
DependencyPolicy();
|
|
|
|
private:
|
|
class Private;
|
|
Private * const d;
|
|
|
|
public:
|
|
/** This method should be useful for debugging purposes. */
|
|
void dumpJobDependencies();
|
|
};
|
|
|
|
}
|
|
|
|
#endif
|