/*
* Copyright (c) 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:  FreestyleEmailUi attachments list model and model item definition.
*
*/


#ifndef __FREESTYLEEMAILUI_ATTACHMENTSLISTMODEL_H__
#define __FREESTYLEEMAILUI_ATTACHMENTSLISTMODEL_H__

// SYSTEM INCLUDES
#include <e32base.h>
//<cmail>
#include "fstreelist.h"
//</cmail>

// INTERNAL INCLUDES
#include "FreestyleEmailDownloadInformationMediator.h"

// FORWARD DECLARATIONS
class CFreestyleEmailUiAppUi;
class CFSMailMessage;

// CONSTANTS
// Limit values of download progress
const TInt KNone = 0;
const TInt KComplete = 100;

// data of one attachment
struct TAttachmentData
	{
	// size of the attachment in bytes
	TInt fileSize;
	// download progress in %, 0-100
	TInt downloadProgress;
	// attachment file type
	TFileType fileType;
	// attachment file name
	TFileName fileName;
	// attachment tree entry id in attachment list
	TFsTreeItemId treeId;
	// attachment message part information
	TPartData partData;
	};

// Observer interface used to inform view about updates in model
class MFSEmailUiAttachmentsStatusObserver
    {
public:
    /**
    * Informs that the status of the given attachment has changed.
    * @param    aIndex  The index of the changed object in the model. Note that
    *                   it's possible that a new object has been added to the model.
    *                   In that case, this index is greater than the previous last
    *                   index of the model. KErrNotFound indicates that the list
    *                   was completely updated and thus UI needs to refresh
    *                   itself totally.
    */
    virtual void DownloadStatusChangedL( TInt aIndex ) = 0;
    };


//////////////////////////////////////////////////////////////////////////////
// Base class contains common functionality for the Attachments list model and 
// Download Manager model
class CFSEmailUiAttachmentsModelBase : public CBase, public MFSEmailDownloadInformationObserver
    {
public: // methods
    ~CFSEmailUiAttachmentsModelBase();

	// starts download
	TBool StartDownloadL( TFsTreeItemId aTreeId );
    TBool StartDownloadL( const TAttachmentData& aAttachment );
	// saves attachment
    TBool SaveAttachmentL( TFsTreeItemId aTreeId, const TDesC& aFileName, TInt& aSavedCount );
	TBool SaveAttachmentL( const TAttachmentData& aAttachment, const TDesC& aFileName, TInt& aSavedCount );
	// cancels download operation
    void CancelDownloadL( TFsTreeItemId aTreeId );
	void CancelDownloadL( const TAttachmentData& aAttachment );
	// removes the downloaded file contents
    void RemoveContentL( TFsTreeItemId aTreeId );
	void RemoveContentL( const TAttachmentData& aAttachment );
	// is the message part currently being downloaded  
	TBool IsDownloading( const TAttachmentData& aAttachment );
    // is the message part completely downloaded
    TBool IsCompletelyDownloadedL( const TAttachmentData& aAttachment );
    // is the message part an embedded message object
    TBool IsMessage( const TAttachmentData& aAttachment ) const;
	// returns ETrue if there has been at least one download started after program start
	TBool IsThereAnyCurrentDownloads();
    // Creates and returns a size description matching the given size. Ownership is transferred to CleanupStack.
    static HBufC* CreateSizeDescLC( TInt aSize );
    // Get AppUi handle
	CFreestyleEmailUiAppUi& AppUi();

public: // pure virtual methods
    // get attachment data from list using tree entry 
    virtual TAttachmentData* GetItem( TFsTreeItemId aTreeId ) = 0;
	// get attachment data from list using tree entry 
	virtual TAttachmentData& GetItemL( TFsTreeItemId aTreeId ) = 0;
	// get message object related to the given tree entry
	virtual TPartData GetMessageL( TFsTreeItemId aTreeId ) = 0;
	// downloads all attachments
	virtual TBool DownloadAllAttachmentsL() = 0;
	// saves all attachments
	virtual TBool SaveAllAttachmentsL( const TDesC& aFileName ) = 0;
	// cancels all downloads
	virtual void CancelAllDownloadsL() = 0;
	// check if model contains any attachment of message type
	virtual TBool IsThereAnyMessageAttachments() const = 0;

protected: // methods
    CFSEmailUiAttachmentsModelBase( CFreestyleEmailUiAppUi& aAppUi );
    void ConstructL();

protected: // data
    CFreestyleEmailUiAppUi& iAppUi;
    };


/////////////////////////////
// The Attachments list model
class CFSEmailUiAttachmentsListModel : public CFSEmailUiAttachmentsModelBase 
    {
public:
	// download progress infromation callback, from MFSEmailDownloadInformationObserver
	virtual void RequestResponseL( const TFSProgress& aEvent, const TPartData& aPart );
	// two-phased constructor
	static CFSEmailUiAttachmentsListModel* NewL( CFreestyleEmailUiAppUi& aAppUi, MFSEmailUiAttachmentsStatusObserver& aObserver );
	// two-phased constructor
	static CFSEmailUiAttachmentsListModel* NewLC(CFreestyleEmailUiAppUi& aAppUi, MFSEmailUiAttachmentsStatusObserver& aObserver );
	// destructor
	~CFSEmailUiAttachmentsListModel();
	// returns the whole model
	const RArray<TAttachmentData>& GetModel();
    // adds node id to attachment data 
    void SetNodeIdL( TInt aAttachmentIndex, TFsTreeItemId aTreeItemId );
    // updates attachment list 
    void UpdateListL( TPartData aMessage );
    void UpdateListL( CFSMailMessage* aEmbeddedMessage );
    // Creates and returns mail subject text. Ownership is transferred to CleanupStack.
    HBufC* CreateMailSubjectTextLC() const;

public: // from CFSEmailUiAttachmentsModelBase
    // get attachment data from list using tree entry 
    TAttachmentData* GetItem( TFsTreeItemId aTreeId );
	// get attachment data from list using tree entry 
	TAttachmentData& GetItemL( TFsTreeItemId aTreeId );
	// get message object related to the given tree entry
	TPartData GetMessageL( TFsTreeItemId aTreeId );
	// downloads all attachments
	TBool DownloadAllAttachmentsL();
	// saves all attachments
	TBool SaveAllAttachmentsL( const TDesC& aFileName );
	// cancels all downloads
	void CancelAllDownloadsL();
    // check if model contains any attachment of message type
    TBool IsThereAnyMessageAttachments() const;

private:
	CFSEmailUiAttachmentsListModel( CFreestyleEmailUiAppUi& aAppUi, MFSEmailUiAttachmentsStatusObserver& aObserver );
	void ConstructL();

private:
	MFSEmailUiAttachmentsStatusObserver& iObserver;
	TPartData iMessage;
	RArray<TAttachmentData> iAttachments;
    };

#endif //__FREESTYLEEMAILUI_MAILLISTMODEL_H__

