imapprotocol.h

Qtopia下的邮件处理程序

/****************************************************************************
**
** Copyright (C) 2000-2006 TROLLTECH ASA. All rights reserved.
**
** This file is part of the Phone Edition of the Qtopia Toolkit.
**
** Licensees holding a valid license agreement from Trolltech or any of its
** authorized distributors may use this file in accordance with
** the License Agreement provided with the Licensed Software.
**
** See http://www.trolltech.com/pricing.html or email [e-mail] for
**   information about Trolltech's Commercial License Agreements.
**
** Contact [e-mail] if any conditions of this licensing are
** not clear to you.
**
**
**
**
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
**
****************************************************************************/



#ifndef ImapProtocol_H
#define ImapProtocol_H

#include <qtcpsocket.h>
#include <qstring.h>
#include <qstringlist.h>
#include <qobject.h>
#include <qtextstream.h>
#include <qtimer.h>

#ifdef SMTPAUTH
#include "qtsslsocket.h"
#include "common.h"
#endif

enum ImapCommand
{
    IMAP_Init = 0,
    IMAP_Login,
    IMAP_Logout,
    IMAP_List,
    IMAP_Select,
    IMAP_UIDSearch,
    IMAP_UIDFetch,
    IMAP_UIDStore,
    IMAP_Expunge
};

enum MessageFlag
{
    MFlag_Seen	    = 0x0001,
    MFlag_Answered  = 0x0002,
    MFlag_Flagged   = 0x0004,
    MFlag_Deleted   = 0x0008,
    MFlag_Draft	    = 0x0010,
    MFlag_Recent    = 0x0020,
    MFlag_Unseen    = 0x0040
};

typedef uint MessageFlags;

enum FetchDataItem
{
    F_RFC822_SIZE   =   0x0001,
    F_RFC822_HEADER =   0x0002,
    F_RFC822	    =   0x0004,
    F_UID	    =   0x0008,
    F_FLAGS	    =	0x0010
};

typedef uint FetchItemFlags;

enum OperationState
{
    OpDone = 0,
    OpFailed,
    OpOk,
    OpNo,
    OpBad
};

class ImapPrivate;

class ImapProtocol: public QObject
{
    Q_OBJECT
	
public:
    ImapProtocol();
    ~ImapProtocol();
    
    bool open(QString url, int port);
#ifdef SMTPAUTH
    bool openSecure(QString url, int port, bool usetls = false);
#endif
    void close();
    bool connected() { return _connected; };

    /*  Valid in non-authenticated state only    */
    void login(QString user, QString password);
   
    /* Valid in authenticated state only    */
    void list(QString reference, QString mailbox);
    void select(QString mailbox);

    /*  Valid in Selected state only */
    void uidSearch(uint from, uint to, MessageFlags flags = 0);
    void uidSearch(MessageFlags flags);
    void uidFetch(QString from, QString to, FetchItemFlags items);
    void uidStore(QString uid, MessageFlags flags);
    void expunge();

    /*  Internal commands (stored from selected mailbox)    */
    QString selected();
    int exists();
    int recent();
    QString mailboxUid();
    QString flags();
    QStringList mailboxUidList();

    /*  Valid in all states */
    void logout();
    
    QString lastError() { return _lastError; };

    static QString token(QString str, QChar c1, QChar c2, int *index);

signals: 
    void mailboxListed(QString &flags, QString &delimiter, QString &name);
    void messageFetched(QString &, QString &, int, uint);
    void downloadSize(int);
    
    void finished(ImapCommand &, OperationState &);
    void connectionError(int);

protected slots:
    void connectionEstablished();
    void socketError(QAbstractSocket::SocketError);
    void incomingData();
    void parseFetch();
#ifdef SMTPAUTH
    void certCheckDone(QtSslSocket::VerifyResult,bool,const QString&);
#endif

private:
    QString newCommandId();
    QString commandId(QString in);
    OperationState commandResponse(QString in);
    void sendCommand(QString cmd);
    
    void parseSelect();
    void parseFetchAll();
    void parseUid();
    void parseChange();
    void parseList(QString in);
    
    QString quoteString(QString name);
    QString unquoteString(QString name);
	
private:
    QTcpSocket *socket;
#ifdef SMTPAUTH
    QtSslSocket* secureSocket;
#endif
    QTextStream *stream;
    
    ImapCommand status;
    OperationState operationState;
    bool _connected;
    MessageFlags messageFlags;
    FetchItemFlags dataItems;

    /*	Associated with the Mailbox */
    QString _name;
    int _exists, _recent;
    QString _flags, _mailboxUid;
    QStringList uidList;
    
    QStringList requests;
    QStringList errorList;
    ImapPrivate *d;
    int requestCount, internalId;
    int mailDropSize;

    QString _lastError;
    QString response;
    int read;
    QTimer incomingDataTimer;
    QTimer parseFetchTimer;
    bool firstParseFetch;
};

#endif