/*

* Copyright (c) 2005 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:  

*       Class which takes care of e-mail editing and sending.

*

*/

#ifndef __CMRUTILSEMAILSENDER_H__

#define __CMRUTILSEMAILSENDER_H__

//  INCLUDES

#include <e32base.h>

#include <msvstd.h>

#include <CMRUtils.h>

#include "CMRUtilsInternal.h"

// FORWARD DECLARATIONS

class CCalSession;

class CCalEntry;

class MMRUtilsObserver;

class CClientMtmRegistry;

class CSendUi;

class CMessageData;

class CStringResourceReader;

// CLASS DECLARATION

/**

* Interface for a class which takes care of e-mail editing and sending.

*/

class MMRUtilsEmailSender

    {

    public: // Constructors and destructors

        /**

        * Destructor, allows deletion through this interface.

        */

        virtual ~MMRUtilsEmailSender() {};    

     public: // New functions

        /**

        * @see CMRUtils

        */

        virtual void ReplyToL( CMRUtilsInternal::TMailRecipients aRecipients,

                               const CCalEntry& aCalEntry,

                               TMsvId aMailBox,

                               const TDesC& aSenderAddr ) = 0;

        /**

        * @see CMRUtils

        */

        virtual void SendL( const CCalEntry& aCalEntry, TMsvId aMailBox ) = 0;        

    };

/**

* Implementation class for MMRUtilsEmailSender interface.

*/

class CMRUtilsEmailSender : public CBase, public MMRUtilsEmailSender

    {

    public: // Constructors and destructors

        /**

        * Symbian two-phased constructor.

        * @param aCalSession calendar session reference

        * @param aObserver observer reference

        * @return instantiated object

        */

        static CMRUtilsEmailSender* NewL( CCalSession& aCalSession );        

        /**

        * Destructor.

        */

        ~CMRUtilsEmailSender();

    public: // From MMRUtilsEmailSender

        void ReplyToL( CMRUtilsInternal::TMailRecipients aRecipients,

                       const CCalEntry& aCalEntry,

                       TMsvId aMailBox,

                       const TDesC& aSenderAddr );

        void SendL( const CCalEntry& aCalEntry, TMsvId aMailBox );

    protected: // New functions

        /**

        * Helper function which adds recipients determined by aRecipients

        * to aMsgData.

        * @param aRecipients enumeration

        * @param aCalEntry calendar entry containing attendees

        * @param aSenderAddr sender's e-mail address

        * @param aMsgData data where recipients are added

        */

        void AddRecipientsToMsgL( CMRUtilsInternal::TMailRecipients aRecipients,

                                  const CCalEntry& aCalEntry,

                                  const TDesC& aSenderAddr,

                                  CMessageData& aMsgData ) const;

        /**

        * Helper function which adds recipients determined by aCalEntry

        * method (request, cancel etc.) to aMsgData.

        * @param aCalEntry calendar entry containing attendees

        * @param aMsgData data where recipients are added

        */                                            

        void AddRecipientsToMsgL( const CCalEntry& aCalEntry,

                                  CMessageData& aMsgData ) const;

        /**

        * Helper function which adds one recipient to aMsgData, leaves with

        * KErrArgument if aRecipient is NULL or does not have e-mail address.

        * @param aRecipient calendar user, ownership not transferred

        * @param aMsgData data where recipient is added

        */ 

        void AddRecipientToMsgL( const CCalUser* aRecipient,

                                 CMessageData& aMsgData ) const;                                 

        /**

        * Helper function which creates e-mail subject with prefix.

        * @param aSubject subject without prefix

        * @param aReply ETrue if reply, EFalse if forward

        * @return new subject string, ownership transferred

        */                                  

        HBufC* CreateSubjectPrefixStringL( const TDesC& aSubject,

                                           TBool aReply ) const;

        /**

        * Helper function which sets method (e.g. "REPLY") to aString.

        * @param aString string to contain method

        * @param aCalEntry entry which specifies the method

        */                                                                             

        void SetMethodStringL( TDes8& aString,

                               const CCalEntry& aCalEntry );

        /**

        * Used with TCleanupOperation to delete tmp attachment file.

        * @param aPtr, HBufC pointer to attachment file name

        */             

        static void CleanupTmpAttachment( TAny* aPtr );                                                 

    protected: // Constructors and destructors

        /**

        * C++ default constructor.

        * @param aCalSession calendar session reference

        * @param aObserver observer reference

        */

        CMRUtilsEmailSender( CCalSession& aCalSession );

        /**

        *  Constructor, second phase.

        */

        void ConstructL();            

    protected: // data

        // File server session

        RFs iFs;

        // Calendar session

        CCalSession& iCalSession;

        // Resource reader, own

        CStringResourceReader* iResReader;

        // SendUi, own

        CSendUi* iSendUi;

    };

#endif // __CMRUTILSEMAILSENDER_H__

// End of File