/*
* Copyright (c) 2009 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:    See class definition below.
*
*/

#ifndef CTCMCEFILEHANDLER_H
#define CTCMCEFILEHANDLER_H

// INCLUDES

#include <f32file.h>
#include <bautils.h>
#include <e32std.h>
#include <e32base.h>

// CLASS DECLARATION

/**
 *  CCTcMCEFileHandler
 *  
 *  Class for small file operations
 * 
 */
class CTcMCEFileHandler : public CBase
	{
public:
	// Constructors and destructor

	/**
	 * Destructor.
	 */
	~CTcMCEFileHandler();

	/**
	 * Two-phased constructor.
	 */
	static CTcMCEFileHandler* NewL();

	/**
	 * Two-phased constructor.
	 */
	static CTcMCEFileHandler* NewLC();

private:

	/**
	 * Constructor for performing 1st stage construction
	 */
	CTcMCEFileHandler();

	/**
	 * EPOC default constructor for performing 2nd stage construction
	 */
	void ConstructL();	

public:	//user functions
	
    /**
    * Finds a files in the given path and file name or wildcard
    * Note that the trailing backslash is required to specify the directory 
    * I.e. path x:\dir1\dir2\
    * @param aPath The top level directory for the scan including the drive letter
    * @param aFileName name of the file or wildcard I.e. *.txt
    * @param aArray returned file list
    */
	void FindFile(const TDesC& aPath, const TDesC& aFileName, CDesC8Array* aArray);
	
	/**
	 * Function for reading all files from a specified folder.
	 * @param aFolder
	 * @param aArray returned file names. aArray must be initialized before function call
	 * @return error code. KErrNone if no error
	 */
	TInt GetFilesFromFolderL(TDesC& aFolder,CDesC8Array* aArray);

    /**
    * Deletes the file from the file system
    * @param aName fullname of the (including the path)
    * @param aSwitch specify: zero for no recursion; CFileMan::ERecurse for recursion
    * @return ETrue if there was no errors
    */
	TBool Delete(const TDesC& aName, TUint aSwitch=0); 
    
	/**
    * Checks if file exists in the file system
    * @param aFileName fullname of the (including the path)
    * @return ETrue if file was found or EFalse otherwise 
    */
	TBool CheckFileExists(const TDesC& aFileName);
	
	/**
	 * Gets the file information (size, date, attributes)
	 * @param aFileName fullname of the (including the path)
	 * @param aArray with file information returned by the pointer.
	 * response structure: aArray[n]=attribute_name: aArray[n+1]=value
	 */
	void GetFileInfoL(const TDesC& aFileName, CDesC8Array* aArray);

public:	//internal
	
	void FormatEntry(TDes8& aBuffer, const TEntry& aEntry);
	
	void ScanDirectoryL(
	   const TDesC& aDir, const TDesC& aWildCard, CDesC8Array* aArray);

	
private:
	RFs iFsSession;
	TFileName iFileName;
	};

#endif // CTCMCEFILEHANDLER_H