diff options
Diffstat (limited to 'tdeio/tdeio/davjob.h')
| -rw-r--r-- | tdeio/tdeio/davjob.h | 127 |
1 files changed, 127 insertions, 0 deletions
diff --git a/tdeio/tdeio/davjob.h b/tdeio/tdeio/davjob.h new file mode 100644 index 000000000..1bbb722d0 --- /dev/null +++ b/tdeio/tdeio/davjob.h @@ -0,0 +1,127 @@ +// -*- c++ -*- +/* This file is part of the KDE libraries + Copyright (C) 2002 Jan-Pascal van Best <[email protected]> + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + 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_davjob_h__ +#define __kio_davjob_h__ + +#include <kurl.h> + +#include <tqobject.h> +#include <tqptrlist.h> +#include <tqstring.h> +#include <tqstringlist.h> +#include <tqguardedptr.h> +#include <tqdom.h> + +#include <sys/types.h> +#include <sys/stat.h> + +#include <tdeio/jobclasses.h> +#include <tdeio/global.h> + +class Observer; +class TQTimer; + +namespace TDEIO { + + class Slave; + class SlaveInterface; + + /** + * The transfer job pumps data into and/or out of a Slave. + * Data is sent to the slave on request of the slave ( dataReq). + * If data coming from the slave can not be handled, the + * reading of data from the slave should be suspended. + * @see TDEIO::davPropFind() + * @see TDEIO::davPropPatch() + * @see TDEIO::davSearch() + * @since 3.1 + */ + class TDEIO_EXPORT DavJob : public TransferJob { + Q_OBJECT + + public: + /** + * Use TDEIO::davPropFind(), TDEIO::davPropPatch() and + * TDEIO::davSearch() to create a new DavJob. + */ + DavJob(const KURL& url, int method, + const TQString& request, bool showProgressInfo); + /** + * Returns the response as a TQDomDocument. + * @return the response document + */ + TQDomDocument& response() { return m_response; } + + protected slots: + virtual void slotFinished(); + virtual void slotData( const TQByteArray &data); + + protected: + bool m_suspended; + TransferJob *m_subJob; + private: + class DavJobPrivate; + DavJobPrivate *d; + TQString dummy; // kept around for BC reasons + TQDomDocument m_response; + }; + + /** + * Creates a new DavJob that issues a PROPFIND command. PROPFIND retrieves + * the properties of the resource identified by the given @p url. + * + * @param url the URL of the resource + * @param properties a propfind document that describes the properties that + * should be retrieved + * @param depth the depth of the request. Can be "0", "1" or "infinity" + * @param showProgressInfo true to show progress information + * @return the new DavJob + */ + TDEIO_EXPORT DavJob* davPropFind( const KURL& url, const TQDomDocument& properties, TQString depth, bool showProgressInfo=true ); + + /** + * Creates a new DavJob that issues a PROPPATCH command. PROPPATCH sets + * the properties of the resource identified by the given @p url. + * + * @param url the URL of the resource + * @param properties a PROPPACTCH document that describes the properties that + * should be modified and its new values + * @param showProgressInfo true to show progress information + * @return the new DavJob + */ + TDEIO_EXPORT DavJob* davPropPatch( const KURL& url, const TQDomDocument& properties, bool showProgressInfo=true ); + + /** + * Creates a new DavJob that issues a SEARCH command. + * + * @param url the URL of the resource + * @param nsURI the URI of the search method's qualified name + * @param qName the local part of the search method's qualified name + * @param query the search string + * @param showProgressInfo true to show progress information + * @return the new DavJob + */ + TDEIO_EXPORT DavJob* davSearch( const KURL &url, const TQString& nsURI, const TQString& qName, const TQString& query, bool showProgressInfo=true ); + +} + +#endif + |