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.
tdepim/kresources/carddav/job.h

177 lines
3.9 KiB

/*=========================================================================
| KCardDAV
|--------------------------------------------------------------------------
| (c) 2010 Timothy Pearson
|
| This project is released under the GNU General Public License.
| Please see the file COPYING for more details.
|--------------------------------------------------------------------------
| Job class for accessing remote address books.
========================================================================*/
/*=========================================================================
| INCLUDES
========================================================================*/
#ifndef KABCDAV_JOB_H
#define KABCDAV_JOB_H
#include <qthread.h>
#include <qstring.h>
#include <qdatetime.h>
#include <qapplication.h>
extern "C" {
#include <libcarddav/carddav.h>
}
namespace KABC {
/*=========================================================================
| CLASS
========================================================================*/
/**
* Calendar job.
*/
class CardDavJob : public QThread {
public:
/**
* @param url URL to load.
*/
CardDavJob(const QString& url = QString());
virtual ~CardDavJob();
/**
* Sets a new URL to load.
*/
virtual void setUrl(const QString& s) {
mUrl = s;
}
/**
* Sets whether to use UID (false) or URI (true) as an object's unique identifier
*/
virtual void setUseURI(bool b) {
mUseURI = b;
}
/**
* Sets the parent qobject.
*/
virtual void setParent(QObject *s) {
mParent = s;
}
/**
* Sets the type (0==read, 1==write)
*/
virtual void setType(int s) {
mType = s;
}
/**
* @return URL to load.
*/
virtual QString url() const {
return mUrl;
}
/**
* @return whether to use UID (false) or URI (true) as an object's unique identifier
*/
virtual bool getUseURI() {
return mUseURI;
}
/**
* @return parent object
*/
virtual QObject *parent() {
return mParent;
}
/**
* @return type
*/
virtual int type() {
return mType;
}
/**
* @return true if downloading process failed.
*/
virtual bool error() const {
return mError;
}
/**
* @return an error string.
*/
virtual QString errorString() const {
return mErrorString;
}
/**
* @return an error number.
*/
virtual long errorNumber() const {
return mErrorNumber;
}
protected:
virtual void run();
/**
* Main run method for jobs. Jobs should not override run() method.
* Instead of this they should override this one.
* @param carddavRuntime specific libcarddav runtime information. This pointer should not be saved for the usage
* outside of runJob.
* @return libcarddav response code (see CARDDAV_RESPONSE)
*/
virtual int runJob(runtime_info* carddavRuntime) = 0;
/**
* Some cleaning. Jobs may (and usually should) override this method.
*/
virtual void cleanJob() {
mError = false;
mErrorString = "";
mErrorNumber = 0;
}
/**
* Sets an error string to @p err. Also sets an error flag.
*/
void setErrorString(const QString& str, const long number);
/**
* Process an error.
* Subclasses can overwrite this method, if some special error message handling
* should be done. Call setErrorString() to set the error after processing is done.
* @param err error structure.
*/
virtual void processError(const carddav_error* err);
private:
QString mUrl;
bool mError;
QString mErrorString;
long mErrorNumber;
QObject *mParent;
int mType;
bool mUseURI;
void enableCarddavDebug(runtime_info*);
};
} // namespace KABC
#endif // KABCDAV_JOB_H