email/imum/Utils/Inc/ImumInHealthServicesImpl.h
author Pat Downey <patd@symbian.org>
Wed, 01 Sep 2010 12:31:54 +0100
branchRCL_3
changeset 27 7fdbb852d323
parent 0 72b543305e3a
permissions -rw-r--r--
Revert incorrect RCL_3 drop: Revision: 201033 Kit: 201035

/*
* Copyright (c) 2006 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:  ImumInHealthServicesImpl.h
*
*/


#ifndef CIMUMINHEALTHSERVICESIMPL_H
#define CIMUMINHEALTHSERVICESIMPL_H

// INCLUDES
#include <e32base.h>
#include "ImumInHealthServices.h"


// CONSTANTS
enum TIMDErrors
    {
    EIMDNoError = 0,                        // 0
    EIMDUnknownMailbox,
    EIMDNoMemory,
    EIMDNotMailMtmId,
    EIMDGetEntryFailure,
    EIMDImap4AccountFailure,
    EIMDImap4AccountIdNotMatching,
    EIMDImap4RelatedEntryIdNotMatching,
    EIMDPop3AccountFailure,
    EIMDPop3AccountIdNotMatching,
    EIMDPop3RelatedEntryIdNotMatching,      // 10
    EIMDSmtpAccountFailure,
    EIMDSmtpAccountIdNotMatching,
    EIMDSmtpRelatedEntryIdNotMatching,
    EIMDSyncMlSettingsLoadFailure,          // Deprecated
    EIMDSyncMlMailboxIdNotMatching,         // Deprecated
    EIMDSyncMlMtmIdNotMatching,             // Deprecated
    EIMDStoringFailureWithIMEI,
    EIMDMismatchingIMEI,
    EIMDMissingIMEI,
    EIMDMailboxArrayCreationFailure,        // 20
    EIMDFlagCombinationNotSupported
    };

// Maximum length of IMEI code
const TInt KIMAMaxPhoneIdLength = 50;

// Mail for Exchange MTM Uid
const TInt KImumMtmMailForExchangeUidValue  = 0x1020695b;
const TUid KImumMtmMailForExchangeUid       = { KImumMtmMailForExchangeUidValue };

// MACROS
// FORWARD DECLARATIONS
class CImumInternalApiImpl;
class MImumInMailboxUtilities;
class CImumMboxManager;
class CImumMboxSettingsCtrl;
class CEmailAccounts;
class CImumMboxDataExtension;

// DATA TYPES

/**
*
*  @lib
*  @since S60 3.0
*/
class CImumInHealthServicesImpl : public CBase, public MImumInHealthServices
    {
    public:  // Constructors and destructor

        /**
        * Creates object from CImumInHealthServicesImpl and leaves it to cleanup stack
        * @since S60 3.0
        * @return, Constructed object
        */
        static CImumInHealthServicesImpl* NewLC(
            CImumInternalApiImpl& aMailboxApi );

        /**
        * Create object from CImumInHealthServicesImpl
        * @since S60 3.0
        * @return, Constructed object
        */
        static CImumInHealthServicesImpl* NewL(
            CImumInternalApiImpl& aMailboxApi );

        /**
        * Destructor
        * @since S60 3.0
        */
        virtual ~CImumInHealthServicesImpl();

    public: // New functions

        /**
        *
        * @since S60 3.0
        */
        TIMDErrors StoreIMEIToMailbox( const TMsvId aMailboxId ) const;

    public: // Functions from base classes

        /*
        * From MImumInHealthServices. Returns array of fully operating mailboxes
        * @since S60 3.0
        * @param aMailboxArray Return parameter for array of mailboxes
        * @param aFlags Flags indicates the protocols to be included in array
        * @param aClearArray By default, the array is cleared before use
        * @return KErrNone, when array has been constructed successfully
        */
        TInt GetMailboxList(
            RMailboxIdArray& aHealthyMailboxArray,
            const TInt64 aFlags = EFlagSetHealthyReceiving,
            const TBool aClearArray = ETrue ) const;

        TInt GetHealthyMailboxList(
            RMailboxIdArray& aHealthyMailboxArray,
            const TInt64 aFlags = EFlagSetHealthyReceiving,
            const TBool aClearArray = ETrue ) const;

        /**
        * From MImumInHealthServices. Veriefies the mailbox condition
        * @since S60 3.0
        * @param aMailboxId The Id of the mailbox for the check
        * @return ETrue/EFalse according to condition
        */
        TBool IsMailboxHealthy(
            const TMsvId aMailboxId ) const;

        /**
        * Searches and destroys unhealthy mailboxes
        * @since S60 3.0
        */
        void CleanupUnhealthyMailboxes() const;

    protected:  // Constructors

        /**
        *
        * @since S60 3.0
        */
        CImumInHealthServicesImpl(
            CImumInternalApiImpl& aMailboxApi );

        /**
        *
        * @since S60 3.0
        */
        void ConstructL();

    protected:  // New virtual functions
    protected:  // New functions
    protected:  // Functions from base classes

    private:  // New virtual functions
    private:  // New functions

        /**
        *
        * @since S60 3.0
        */
        TIMDErrors StoreIMEIToEntry( const TMsvId aMailboxId ) const;

        /**
        *
        * @since S60 3.0
        */
        void StoreIMEIToEntryL( const TMsvId aMailboxId ) const;

        /**
        *
        * @since S60 3.0
        */
        TIMDErrors GetIMEIFromTheEntry(
            const TMsvId aEntryId,
            TDes& aIMEI ) const;

        /**
        *
        * @since S60 3.0
        */
        TIMDErrors GetIMEIFromTheEntry(
            const TMsvEntry& aEntry,
            TDes& aIMEI ) const;

        /**
        *
        * @since S60 3.0
        */
        void GetIMEIFromThePhoneL();

        /**
        *
        * @since S60 3.0
        */
        TIMDErrors VerifyMailboxHealth( const TMsvId aMailboxId ) const;

        /**
        *
        * @since S60 3.0
        */
        TIMDErrors VerifyMailboxHealth(
            const TMsvEntry& aPrimaryEntry,
            const TMsvEntry* aSecondaryEntry ) const;

        /**
        *
        * @since S60 3.0
        */
        TIMDErrors MatchEntryWithSettings(
            const TMsvEntry& aMailbox ) const;

        /**
        *
        * @since S60 3.0
        */
        TIMDErrors VerifyImap4EntryWithSettings(
            const TMsvEntry& aMailbox ) const;

        /**
        *
        * @since S60 3.0
        */
        TIMDErrors VerifyPop3EntryWithSettings(
            const TMsvEntry& aMailbox ) const;

        /**
        *
        * @since S60 3.0
        */
        TIMDErrors VerifySmtpEntryWithSettings(
            const TMsvEntry& aMailbox ) const;

        /**
        *
        * @since S60 3.0
        */
        TIMDErrors VerifyEntryIMEI( const TMsvEntry& aMailbox ) const;

        /**
        *
        * @since S60 3.0
        */
        void AppendToArray(
            const CMsvEntrySelection& aSelection,
            RMailboxIdArray& aMailboxArray,
            const TBool aAppendHealthy ) const;

        /**
        *
        * @since S60 3.0
        */
        void DoGetMailboxList(
            RMailboxIdArray& aMailboxArray,
            const TMuiuFlags& aFlags ) const;

        /**
        *
        * @since S60 3.0
        */
        void CreateMailboxListL(
            CMsvEntrySelection*& aPopSel,
            CMsvEntrySelection*& aImapSel ) const;

        /**
        *
        * @since S60 3.0
        */
        void DoCleanup( const RMailboxIdArray& aMailboxArray ) const;


        /**
        * Check if the mailbox type matches required mailbox
        * @since S60 3.1
        * @param aEntry, suspected mailbox entry
        * @param aFlags, controller flags (see TIMDFlags)
        * @return ETrue, when correct mailbox is in question
        * @return EFalse, when incorrect mailbox is in question
        */
        TBool IsRequiredMailbox(
            const TMsvEntry& aEntry,
            const TMuiuFlags& aFlags ) const;

        /**
        * Takes the provided flags to use, or uses default
        * @since S60 3.0
        * @param aFlags Flags to be used
        * @return Flags to be used for controlling
        */
        TMuiuFlags PrepareFlags( const TInt64 aFlags ) const;

        /**
        *
        * @since S60 3.0
        */
        TIMDErrors GetMailboxEntry(
            const TMsvId aMailboxId,
            TMsvEntry& aMailboxEntry ) const;

    private:  // Functions from base classes

    public:     // Data
    protected:  // Data
    private:    // Data

        enum TFlags
            {
            EFlagImap4 = 0,
            EFlagPop3,
            EFlagSmtp,
            EFlagSyncMl,    // Deprecated
            EFlagHealthy,
            EFlagOtherService,
            };

        // Message server session
        CImumInternalApiImpl&       iInternalApi;
        // Pointer to extended mail settings
        CImumMboxDataExtension*  iExtendedSettings;
        // IMEI code of the phone
        TBuf<KIMAMaxPhoneIdLength>  iIMEI;
        // RootEntry
        CMsvEntry*                  iRoot;
        // Shortcut to utilities
        MImumInMailboxUtilities*    iUtils;
    };

#endif //  CIMUMINHEALTHSERVICESIMPL_H