/*

* Copyright (c) 2004-2007 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:  

*     Entry wrapper for client side components

*

*/

#ifndef MMSCLIENTENTRY_H

#define MMSCLIENTENTRY_H

//  INCLUDES

#include "mmsentrywrapper.h"

// CONSTANTS

// MACROS

// DATA TYPES

// FUNCTION PROTOTYPES

// FORWARD DECLARATIONS

// CLASS DECLARATION

/**

* Entry wrapper implementing MMmsEntry for client side.

* Hides difference between CMscEntry and CMsvServerEntry

*

* @lib mmsutil.lib

* @since 3.0

*/

class CMmsClientEntry :public CBase, public MMmsEntryWrapper

    {

    public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        * @param aFs opened file system handle.

        * @param aEntry reference to a message entry (CMsvEntry),

        *     originally refers to the entry to be handled.

        * @param aServiceId TMsvId of MMS service entry.

        * @param aUseDrm is DRM handling needed. Default on client side is "No"

        */

        IMPORT_C static CMmsClientEntry* NewL( RFs& aFs,

            CMsvEntry& aEntry,

            TMsvId aServiceId);

        /**

        * Destructor.

        */

        virtual ~CMmsClientEntry();

    public: // New functions

    public: // Functions from base classes

        // From MMmsEntryWrapper:

        /**

        * Provide an edit store for editing messages

        * Ownership of the store is transferred. Caller must delete the store

        * @return CMsvStore* if successful, leaves if unsuccessful

        */

        CMsvStore* EditStoreL();

        /**

        * provide a read store for editing messages

        * Ownership of the store is transferred. Caller must delete the store

        * @return CMsvStore* if successful, leaves if unsuccessful

        */

        CMsvStore* ReadStoreL();

        /**

        * reads index entry contents from current entry

        * @param TMsvEntry reference to entry to be filled with data

        * @return error code, KErrNone if successful

        */

        TInt GetIndexEntry( TMsvEntry& aTMsvEntry );

        /**

        * stores index entry contents to current entry

        * @param TMsvEntry reference to entry to be written to disk

        * @return error code KErrNone, if successful

        */

        TInt ChangeIndexEntry( TMsvEntry& aTMsvEntry );

        /**

        * Sets context to specified message entry

        * @param aId ID of the new message entry.

        * @return error code, KErrNone if successful

        */

        TInt SetCurrentEntry( TMsvId aEntryId );

        /**

        * Returns total size of all attachments including mime headers

        * and binary attachment data. Linked attachments are included

        * This function is needed to allocate the encoding buffer.

        * @param aStore Read store for the message entry

        * @return combined size of all attachments, including linked attachments

        */

        TInt AttachmentsSizeL( CMsvStore& aStore );

        /**

        * Check if disk space is below critical level when storing data.

        * @param aDataSize amount of data to be added. If aDataSize == 0,

        *     returns info if disk space is already below critical level.

        * @return error code KErrDiskFull if data does not fit,

        *     KErrNone if data fits.

        *     May return some other error code if appropriate.

        *     KErrNone always means it is all right to save the data.

        */

        TInt DiskSpaceBelowCriticalLevelL( TInt aDataSize );

        /**

        * Store CMmsHeaders to message store for main message entry.

        * @param aMmsHeaders headers to store.

        * @param aStore store to be used. If not given, function gets and commits store

        * @return error code if not successful, KErrNone if successful.

        */

        TInt StoreMmsHeadersL( CMmsHeaders& aMmsHeaders, CMsvStore* aStore );

        /**

        * Restore CMmsHeaders from message store for main message entry.

        * @param aMmsHeaders headers to restore.

        * Leaves if cannot restore headers.

        */

        void RestoreMmsHeadersL( CMmsHeaders& aMmsHeaders, CMsvStore* aStore );

        /**

        * Create attachment, save data to file and save MIME headers.

        *     Must check first if enough disk space.

        *     DRM handling is done here if needed.

        *     Return code tells if whole attachment was removed.

        *     This is the one-shot function that does everything:

        *     Creates attachent, opens file, writes data, flushes it,

        *     closes file, saves MIME headers.

        *     Caller must commit and close store

        * @param aStore edit store for current entry

        * @param aFileName Suggested filename.

        * @param aAttachmentData Pointer to the attachment binary data.

        * @param aMimeHeaders Mime header structure to be saved.

        * @param aAttachment id of the newly created attachment if successful

        * @param aAttachmentSize size of the attachment binary data + mime headers

        * @param aDRMFlags structure where DRM flags are collected.

        *     These flags will ultimately be collected together for all

        *     attachments and stored into iMtmData1 of the parent entry.

        *     Therefore the function must only OR new flags into the structure

        *     and must not change any other bits (the same value may be reused

        *     for all attachments collecting the flags together).

        * @return Error code must indicate if attachment was removed (DRM) so that

        *     the first attachment id may be adjusted. (Decode must keep track

        *     of the first attachment in case root is not specified for

        *     multipart/related structure.

        *     KErrNone = All well.

        *     KDRMRemoved = all well otherwise, but DRM attachment was removed,

        *         and first attachment id must be adjusted accordingly.

        *     Some other error code means a more serious error.

        */

        TInt CreateFileAttachmentL(

            CMsvStore& aStore,

            const TDesC& aFileName,

            const TPtrC8& aAttachmentData,

            CMsvMimeHeaders& aMimeHeaders,

            TMsvAttachmentId& aAttachment,

            TInt& aAttachmentSize,

            TInt32& aDRMFlags);

        /**

        * Deletes a message store entry.

        * @param aEntryIndex is the index of the entry, which will be deleted. 

        * If the Entry has children, all children are destroyed too.

        * @return error code if not successful, KErrNone if successful.

        */

        TInt DeleteEntry( TMsvId aEntryIndex );

        /**

        * From MMmsEntryWrapper: Check if aFileName would be a valid filename.

        * Cannot use path because absolute path is not known. Only filename is checked

        * @param aFileName suggestion of a filename.

        * @return ETrue if filename is valid, EFalse if not.

        */

        TBool IsValidFilename( const TPtrC& aFileName );

        /**

        * Read the decoding flag from the service entry.

        *     (Info stored in MMS service entry)

        * @return ETrue = Log add details while decoding

        *     EFalse = Don't log details.

        */

        TBool GetDecodingFlag();

        /**

        * Read the dump flag from the service entry.

        *     The dump flag tells if all incoming messages are dumped to a file.

        * @return ETrue = dump binary message to file while decoding

        *     EFalse = No binary dump wanted

        */

        TBool GetDumpFlag();

        /**

        * From MMmsEntryWrapper

        * Create Empty attachment file and save Mime headers.

        *     DRM check is done here.

        *     This function is the initialization function for chunked

        *         attachment handling.

        *     This function creates attachent, opens file, and saves MIME headers.

        *

        * @since v3.1

        * @param aStore edit store for current message entry

        *      Caller must keep store open until FinalizeAttachmentL has been called.

        * @param aFileName Suggested filename.

        * @param aMimeHeaders Mime header structure to be saved.

        * @param aAttachment id of the newly created attachment if successful

        * @param aAttachmentSize size of the attachment binary data + mime headers

        */

        void CreateEmptyFileAttachmentL(

            CMsvStore& aStore,

            const TDesC& aFileName,

            CMsvMimeHeaders& aMimeHeaders,

            TMsvAttachmentId& aAttachment);

        /**

        * From MMmsEntryWrapper

        * Write attachment data into file.

        * Call DRM handler if needed.

        *

        * @since v3.1

        *

        * @param aAttachmentData Pointer to the attachment binary data.

        * @param aDRMFlags structure where DRM flags are collected.

        *     These flags will ultimately be collected together for all

        *     attachments and stored into iMtmData1 of the parent entry.

        *     Therefore the function must only OR new flags into the structure

        *     and must not change any other bits (the same value may be reused

        *     for all attachments collecting the flags together).

        * @return Error code must indicate if attachment was removed (DRM) so that

        *     KErrNone = All well.

        *     KDRMRemoved = all well otherwise, but DRM attachment was removed,

        *         and first attachment id must be adjusted accordingly.

        *     Some other error code means an error.

        * Leaves if memory runs out

        */

        TInt ProcessAttachmentDataL(

            const TPtrC8& aAttachmentData,

            TInt32& aDRMFlags );

        /**

        * From MMmsEntryWrapper

        * Finalize the attachment.

        * Flush buffers and close file, calculate total size.

        * Caller must commit the store after this

        *

        * @since v3.1

        *

        * @param aStore edit store for current entry

        * @param aAttachmentSize size of the attachment binary data + mime headers

        * @param aDRMFlags structure where DRM flags are collected.

        *     These flags will ultimately be collected together for all

        *     attachments and stored into iMtmData1 of the parent entry.

        *     Therefore the function must only OR new flags into the structure

        *     and must not change any other bits (the same value may be reused

        *     for all attachments collecting the flags together).

        * @return Error code must indicate if attachment was removed (DRM) so that

        *     KErrNone = All well.

        *     KDRMRemoved = all well otherwise, but DRM attachment was removed,

        *         and first attachment id must be adjusted accordingly.

        *     Some other error code means an error.

        * Leaves if memory runs out

        */

        TInt FinalizeAttachmentL(

            CMsvStore& aStore,

            TInt& aAttachmentSize,

            TInt32& aDRMFlags );

    protected:  // New functions

    protected:  // Functions from base classes

    private:

        /**

        * C++ constructor.

        * @param aFs opened file system handle.

        * @param aEntry reference to a CmsvEntry entry,

        *     originally refers to the entry to be handled.

        * @param aUseDrm is DRM handling needed

        */

        CMmsClientEntry( RFs& aFs, CMsvEntry& aEntry );

        /**

        * @param aServiceId TMsvId of MMS service entry.

        */

        void ConstructL( TMsvId aServiceId );

    public:     // Data

    protected:  // Data

    private:    // Data

        RFs&       iFs;                // file system handle

        CMsvEntry& iCMsvEntry;         // message entry

        TMsvId     iMessageEntry;      // Id of the current message entry

        TMsvId     iServiceId;         // MMS service entry id

        TInt       iMessageDrive;      // messages are on C: drive by default,

                                       // may be moved to other drive

        TBool      iDump;              // dump flag

        TBool      iLogAllDecoded;     // detailed logging flag

        RFile      iAttaFile;          // file handle for writing the attachment

        TBool      iFileOpen;          // keep track if we have an open file and stream

        TMsvAttachmentId iAttaId;      // current attachment

    public:     // Friend classes

    protected:  // Friend classes

    private:    // Friend classes

    };

#endif      // MMSCLIENTENTRY_H   

// End of File