/usr/include/KPim/kdav/davjobbase.h is in libkpimkdav-dev 17.12.3-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 | /*
Copyright (c) 2014 Gregory Oestreicher <greg@kamago.net>
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program 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 General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
#ifndef KDAV_DAVJOBBASE_H
#define KDAV_DAVJOBBASE_H
#include <memory>
#include "kpimkdav_export.h"
#include <KJob>
class DavJobBasePrivate;
namespace KDAV
{
class Error;
/**
* @short base class for the jobs used by the resource.
*/
class KPIMKDAV_EXPORT DavJobBase : public KJob
{
Q_OBJECT
public:
explicit DavJobBase(QObject *parent = nullptr);
~DavJobBase();
/**
* Get the latest response code.
*
* If no response code has been set then 0 will be returned, but will
* be meaningless unless error() is non-zero. In that case this means
* that the latest error was not at the HTTP level.
*/
unsigned int latestResponseCode() const;
/**
* Check if the job can be retried later.
*
* This will return true for transient errors, i.e. if the response code
* is either zero and error() is set or if the HTTP response code hints
* at a temporary error.
*
* The HTTP response codes considered retryable are:
* - 401
* - 402
* - 407
* - 408
* - 423
* - 429
* - 501 to 504, inclusive
* - 507
* - 511
*/
bool canRetryLater() const;
/**
* Check if the job failed because of a conflict
*/
bool hasConflict() const;
/**
* Returns a instance of the KDAV:Error to be able to translate the error
*/
Error davError() const;
protected:
/**
* Sets the latest response code received.
*
* Only really useful in case of error, though success codes can
* also be set.
*
* @param code The code to set, should be a valid HTTP response code or zero.
*/
void setLatestResponseCode(unsigned int code);
void setJobErrorText(const QString &errorText);
void setJobError(unsigned int jobErrorCode);
void setErrorTextFromDavError();
void setDavError(const Error &error);
private:
std::unique_ptr<DavJobBasePrivate> d;
};
}
#endif
|