/*

* 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:  Scans folders for media files

*

*/

#ifndef CMPXFOLDERSCANNER_H

#define CMPXFOLDERSCANNER_H

#include <e32base.h>

#include <f32file.h>

#include <badesca.h>

// FORWARD DECLARATIONS

class MMPXFileAdditionObserver;

class MMPXFileScanStateObserver;

/**

 *  CMPXFolderScanner

 *

 *  Scans a particular drive for files

 *

 *  @lib mpxfilehandler

 *  @since S60 3.0

 */

NONSHARABLE_CLASS( CMPXFolderScanner ) : public CActive

    {

public:

    /**

    * Two-phased constructor

    * @param aObserver file addition observer

    * @param aStateObserver scanning state observer

    * @param aFs file session

    */

    static CMPXFolderScanner* NewL( MMPXFileAdditionObserver& aObserver,

                                    MMPXFileScanStateObserver& aStateObs,

                                    RFs& aFs );

    /**

    * Virtual destructor

    */

    virtual ~CMPXFolderScanner();

    /**

    * Scan a particular drive for files

    * @param aDrive the drive to scan

    */

    void ScanL( RArray<TPath>& aDrive );

protected: // From Base Class

    /**

    * From CActive

    */

    void RunL();

    /**

    * From CActive

    */

    void DoCancel();

    /**

    *  From CActive

    */

    TInt RunError(TInt aError);    

private: // New Functions

    /**

    * Continues the scanning procedure

    * @return ETrue if it is done, EFalse if there is more work to do

    */

    TBool DoScanL();    

    /**

    * Setup the object to scan the next drive

    * @return ETrue if there are more folders to scan

    *         EFalse if the scanning process is complete

    */

    TBool SetupNextDriveToScanL();

    /**

    * Handles what to do when scanning is done

    * @param aErr error to return to the client

    */

    void DoScanCompleteL( TInt aErr );

private:

    /**

    * Private constructor

    * @param aObserver file addition observer

    * @param aStateObserver scanning state observer

    * @param aFs file session

    */

    CMPXFolderScanner( MMPXFileAdditionObserver& aObserver,

                       MMPXFileScanStateObserver& aStateObs,

                       RFs& aFs );

    /**

    * 2nd Phase constructor

    */

    void ConstructL();

private: // data

    MMPXFileAdditionObserver&     iObserver; 

    MMPXFileScanStateObserver&    iStateObserver; 

    RFs&  iFs; // Not owned

    // Droves or folders that we want to scan

    RArray<TPath>                 iDrivesToScan;

    // Flag to indicate if we are scanning or not

    TBool                         iScanning;

    // Scanner objects

    };

#endif // CMPXFOLDERSCANNER_H