mirror of
https://bitbucket.org/smil3y/kde-playground.git
synced 2025-02-24 02:42:51 +00:00
124 lines
4.3 KiB
C++
124 lines
4.3 KiB
C++
/* -*- c++ -*-
|
||
* Copyright (c) 2000, 2001 Alex Zepeda <zipzippy@sonic.net>
|
||
* Copyright (c) 2001 Michael H<>kel <Michael@Haeckel.Net>
|
||
* All rights reserved.
|
||
*
|
||
* Redistribution and use in source and binary forms, with or without
|
||
* modification, are permitted provided that the following conditions
|
||
* are met:
|
||
* 1. Redistributions of source code must retain the above copyright
|
||
* notice, this list of conditions and the following disclaimer.
|
||
* 2. Redistributions in binary form must reproduce the above copyright
|
||
* notice, this list of conditions and the following disclaimer in the
|
||
* documentation and/or other materials provided with the distribution.
|
||
*
|
||
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
||
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||
* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
||
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||
* SUCH DAMAGE.
|
||
*
|
||
*/
|
||
|
||
#ifndef _SMTP_H
|
||
#define _SMTP_H
|
||
|
||
#include <kio/tcpslavebase.h>
|
||
|
||
#include "capabilities.h"
|
||
|
||
|
||
#include <QQueue>
|
||
#include <QByteArray>
|
||
|
||
class KUrl;
|
||
|
||
namespace KioSMTP {
|
||
class Response;
|
||
class TransactionState;
|
||
class Command;
|
||
class SMTPSessionInterface;
|
||
class KioSlaveSession;
|
||
}
|
||
|
||
class SMTPProtocol : public KIO::TCPSlaveBase {
|
||
friend class KioSMTP::KioSlaveSession;
|
||
public:
|
||
SMTPProtocol(const QByteArray & pool, const QByteArray & app, bool useSSL);
|
||
virtual ~ SMTPProtocol();
|
||
|
||
virtual void setHost(const QString & host, quint16 port,
|
||
const QString & user, const QString & pass);
|
||
|
||
virtual void special(const QByteArray & aData);
|
||
virtual void put(const KUrl & url, int permissions, KIO::JobFlags flags);
|
||
virtual void stat(const KUrl & url);
|
||
virtual void openConnection();
|
||
virtual void closeConnection();
|
||
|
||
protected:
|
||
|
||
bool smtp_open( const QString & fakeHostName );
|
||
|
||
/** Closes the connection. If @p nice is true (default), then QUIT
|
||
is sent and it's reponse waited for. */
|
||
void smtp_close( bool nice=true );
|
||
|
||
/** Execute command @p cmd */
|
||
bool execute( KioSMTP::Command * cmd, KioSMTP::TransactionState * ts=0 );
|
||
/** Execute a command of type @p type */
|
||
bool execute( int type, KioSMTP::TransactionState * ts=0 );
|
||
/** Execute the queued commands. If something goes horribly wrong
|
||
(sending command oline fails, getting response fails or some
|
||
command raises the failedFatally() flag in @p ts, shuts down the
|
||
connection with <code>smtp_close( false )</code>. If The
|
||
transaction fails gracefully (<code>ts->failed()</code> is
|
||
true), issues a RSET command.
|
||
|
||
@return true if transaction succeeded, false otherwise.
|
||
**/
|
||
bool executeQueuedCommands( KioSMTP::TransactionState * ts );
|
||
|
||
/** Parse a single response from the server. Single- vs. multiline
|
||
responses are correctly detected.
|
||
|
||
@param ok if not 0, returns whether response parsing was
|
||
successful. Don't confuse this with negative responses
|
||
(e.g. 5xx), which you can check for using
|
||
@ref Response::isNegative()
|
||
@return the @ref Response object representing the server response.
|
||
**/
|
||
KioSMTP::Response getResponse( bool * ok );
|
||
|
||
bool authenticate();
|
||
|
||
bool sendCommandLine( const QByteArray & cmd );
|
||
QByteArray collectPipelineCommands( KioSMTP::TransactionState * ts );
|
||
bool batchProcessResponses( KioSMTP::TransactionState * ts );
|
||
|
||
void queueCommand( KioSMTP::Command * command ) {
|
||
mPendingCommandQueue.enqueue( command );
|
||
}
|
||
void queueCommand( int type );
|
||
|
||
quint16 m_sOldPort;
|
||
quint16 m_port;
|
||
bool m_opened;
|
||
QString m_sServer, m_sOldServer;
|
||
QString m_sUser, m_sOldUser;
|
||
QString m_sPass, m_sOldPass;
|
||
QString m_hostname;
|
||
|
||
typedef QQueue<KioSMTP::Command*> CommandQueue;
|
||
CommandQueue mPendingCommandQueue;
|
||
CommandQueue mSentCommandQueue;
|
||
KioSMTP::SMTPSessionInterface *m_sessionIface;
|
||
};
|
||
|
||
#endif // _SMTP_H
|