File indexing completed on 2024-05-12 03:54:56

 /*
     This file is part of the KDE project
 
     SPDX-FileCopyrightText: 2006 Kevin Ottens <ervin@kde.org>
 
     SPDX-License-Identifier: LGPL-2.0-or-later
 */
 
 #ifndef KCOMPOSITEJOB_H
 #define KCOMPOSITEJOB_H
 
 #include <kcoreaddons_export.h>
 #include <kjob.h>
 
 #include <QList>
 
 class KCompositeJobPrivate;
 /**
  * @class KCompositeJob kcompositejob.h KCompositeJob
  *
  * The base class for all jobs able to be composed of one
  * or more subjobs.
  */
 class KCOREADDONS_EXPORT KCompositeJob : public KJob
 {
     Q_OBJECT
 
 public:
     /**
      * Creates a new KCompositeJob object.
      *
      * @param parent the parent QObject
      */
     explicit KCompositeJob(QObject *parent = nullptr);
 
     /**
      * Destroys a KCompositeJob object.
      */
     ~KCompositeJob() override;
 
 protected:
     /**
      * Add a job that has to be finished before a result
      * is emitted. This has obviously to be called before
      * the result has been emitted by the job.
      *
      * Note that the composite job takes ownership of @p job
      *
      * @param job the subjob to add
      * @return true if the job has been added correctly, false otherwise
      */
     virtual bool addSubjob(KJob *job);
 
     /**
      * Mark a sub job as being done.
      *
      * The ownership of @p job is passed on to the caller.
      *
      * @param job the subjob to remove
      * @return true if the job has been removed correctly, false otherwise
      */
     virtual bool removeSubjob(KJob *job);
 
     /**
      * Checks if this job has subjobs running.
      *
      * @return true if we still have subjobs running, false otherwise
      */
     bool hasSubjobs() const;
 
     /**
      * Retrieves the list of the subjobs.
      *
      * @return the full list of sub jobs
      */
     const QList<KJob *> &subjobs() const;
 
     /**
      * Clears the list of subjobs.
      *
      * Note that this will *not* delete the subjobs.
      * Ownership of the subjobs is passed on to the caller.
      */
     void clearSubjobs();
 
 protected Q_SLOTS:
     /**
      * Called whenever a subjob finishes.
      * Default implementation checks for errors and propagates
      * to parent job, and in all cases it calls removeSubjob.
      *
      * @param job the subjob
      */
     virtual void slotResult(KJob *job);
 
     /**
      * Forward signal from subjob.
      *
      * @param job the subjob
      * @param message the info message
      * @see infoMessage()
      */
     virtual void slotInfoMessage(KJob *job, const QString &message);
 
 protected:
     KCOREADDONS_NO_EXPORT KCompositeJob(KCompositeJobPrivate &dd, QObject *parent);
 
 private:
     Q_DECLARE_PRIVATE(KCompositeJob)
 };
 
 #endif