slave.h

Go to the documentation of this file.

// -*- c++ -*-
/*
 *  This file is part of the KDE libraries
 *  Copyright (c) 2000 Waldo Bastian <bastian@kde.org>
 *                2000 Stephan Kulow <coolo@kde.org>
 *
 *  This library is free software; you can redistribute it and/or
 *  modify it under the terms of the GNU Library General Public
 *  License version 2 as published by the Free Software Foundation.
 *
 *  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.
 **/

#ifndef KIO_SLAVE_H
#define KIO_SLAVE_H

#define KIO_SLAVE_EXPORT KIO_EXPORT

#include <time.h>
#include <unistd.h>

#include <QtCore/QObject>

#include <kurl.h>

#include "kio/slaveinterface.h"

namespace KIO {

class SlavePrivate;
class SimpleJob;
// Attention developers: If you change the implementation of KIO::Slave,
// do *not* use connection() or slaveconn but the respective KIO::Slave
// accessor methods. Otherwise classes derived from Slave might break. (LS)
//
// Do not use this class directly, outside of KIO. Only use the Slave pointer
// that is returned by the scheduler for passing it around.
//
// TODO: KDE5: Separate public API and private stuff for this better
class KIO_SLAVE_EXPORT Slave : public KIO::SlaveInterface
{
  Q_OBJECT
public:
  explicit Slave(const QString &protocol, QObject *parent = 0);

  virtual ~Slave();

  void setPID(pid_t);
  int slave_pid();

  void setJob(KIO::SimpleJob *job);
  KIO::SimpleJob *job() const;

  void kill();

  bool isAlive();

  virtual void setHost( const QString &host, quint16 port,
                const QString &user, const QString &passwd);

  void resetHost();

  virtual void setConfig(const MetaData &config);

  QString protocol();

  void setProtocol(const QString & protocol);

  QString slaveProtocol();

  QString host();

  quint16 port();

  QString user();

  QString passwd();

  static Slave* createSlave( const QString &protocol, const KUrl& url, int& error, QString& error_text );

  static Slave* holdSlave( const QString &protocol, const KUrl& url );

  static bool checkForHeldSlave(const KUrl& url);

  // == communication with connected kioslave ==
  // whenever possible prefer these methods over the respective
  // methods in connection()
  virtual void suspend();

  virtual void resume();

  virtual bool suspended();

  virtual void send(int cmd, const QByteArray &arr = QByteArray());

  // == end communication with connected kioslave ==
  virtual void hold(const KUrl &url); // TODO KDE5: no reason to be virtual

  time_t idleTime();

  void setIdle();

  /*
   * @returns Whether the slave is connected
   * (Connection oriented slaves only)
   */
  bool isConnected();
  void setConnected(bool c);

  void ref();
  void deref();

public Q_SLOTS:
  void accept();
  void gotInput();
  void timeout();

Q_SIGNALS:
  void slaveDied(KIO::Slave *slave);

private:
  Q_DECLARE_PRIVATE(Slave)
};

}

#undef KIO_SLAVE_EXPORT

#endif