• Skip to content
  • Skip to link menu
KDE 4.3 API Reference
  • KDE API Reference
  • kdelibs
  • Sitemap
  • Contact Us
 

ThreadWeaver

ThreadWeaver::QueuePolicy

ThreadWeaver::QueuePolicy Class Reference

QueuePolicy is an interface for customizations of the queueing behaviour of sets of jobs. More...

#include <QueuePolicy.h>

Inheritance diagram for ThreadWeaver::QueuePolicy:
ThreadWeaver::DependencyPolicy ThreadWeaver::ResourceRestrictionPolicy

List of all members.

Public Member Functions

virtual bool canRun (Job *)=0
virtual void destructed (Job *)=0
virtual void free (Job *)=0
virtual void release (Job *)=0
virtual ~QueuePolicy ()

Detailed Description

QueuePolicy is an interface for customizations of the queueing behaviour of sets of jobs.

A job can have a queueing policy assigned. In that case, the job is only executed when the method canRun() of the assigned policy returns true. For every call to canRun() that returns true, it is guaranteed that the method free() or the method release() is called. Calling free() means the job has been executed, while calling release() means the job was not executed for external reasons, and will be retried later on.

As an example, dependencies can be implemented using a QueuePolicy: canRun() returns true when the job has no unresolved dependencies. free() and release() are empty.

A job can have multiple queue policies assigned, and will only be executed if all of them return true from canRun() within the same execution attempt. Jobs only keep a reference to the QueuePolicy. Therefore, the same object can be assigned to multiple jobs and this way control the way all those jobs are executed. Jobs never assume ownership of their assigned queue policies.

Definition at line 59 of file QueuePolicy.h.


Constructor & Destructor Documentation

virtual ThreadWeaver::QueuePolicy::~QueuePolicy (  )  [inline, virtual]

Definition at line 62 of file QueuePolicy.h.


Member Function Documentation

virtual bool ThreadWeaver::QueuePolicy::canRun ( Job *   )  [pure virtual]

canRun() is called before the job is executed.

The job will only be executed if canRun() returns true.

Implemented in ThreadWeaver::DependencyPolicy, and ThreadWeaver::ResourceRestrictionPolicy.

virtual void ThreadWeaver::QueuePolicy::destructed ( Job *   )  [pure virtual]

destructing() is called when a Job that has this queue policy assigned gets destructed.

Implemented in ThreadWeaver::DependencyPolicy, and ThreadWeaver::ResourceRestrictionPolicy.

virtual void ThreadWeaver::QueuePolicy::free ( Job *   )  [pure virtual]

free() is called after the job has been executed.

It is guaranteed that free is called only after canRun() returned true at an earlier time.

Implemented in ThreadWeaver::DependencyPolicy, and ThreadWeaver::ResourceRestrictionPolicy.

virtual void ThreadWeaver::QueuePolicy::release ( Job *   )  [pure virtual]

release() is called if canRun() returned true, but the job has not been executed for external reasons.

For example, a second QueuePolicy could have returned false from canRun() for the same job.

Implemented in ThreadWeaver::DependencyPolicy, and ThreadWeaver::ResourceRestrictionPolicy.


The documentation for this class was generated from the following file:
  • QueuePolicy.h

ThreadWeaver

Skip menu "ThreadWeaver"
  • Main Page
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

kdelibs

Skip menu "kdelibs"
  • DNSSD
  • Interfaces
  •   KHexEdit
  •   KMediaPlayer
  •   KSpeech
  •   KTextEditor
  • Kate
  • kconf_update
  • KDE3Support
  •   KUnitTest
  • KDECore
  • KDED
  • KDEsu
  • KDEUI
  • KDocTools
  • KFile
  • KHTML
  • KImgIO
  • KInit
  • kio
  • KIOSlave
  • KJS
  •   KJS-API
  •   WTF
  • kjsembed
  • KNewStuff
  • KParts
  • KPty
  • Kross
  • KUtils
  • Nepomuk
  • Plasma
  • Solid
  • Sonnet
  • ThreadWeaver
Generated for kdelibs by doxygen 1.6.1
This website is maintained by Adriaan de Groot and Allen Winter.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal