/*
* Copyright (c) 2005-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 for matching jar files
*
*/


#ifndef JCFJADJARMATCHERSCANJARFILES_H
#define JCFJADJARMATCHERSCANJARFILES_H

#include <memory>

#include "jcfjadjarmatcherstates.h"

/**
* Scanner class.
*  Search matching JAR files.
*
*  @lib JcfJadJarMatcher.lib
*  @since S60 2.0
*/
class CJcfJadJarMatcherScanJarFiles : public CJcfJadJarMatcherState
{
public:
    /**
     * To construct new CJcfJadJarMatcherScanJarFiles.
     *
     * Preconditions. The following conditions must be true prior to calling
     * this method; otherwise, its operation is undefined.
     * - None.
     *
     * Postconditions. The following condition is true immediately after
     * returning from this method.
     * - None.
     *
     * @param aObs - an observer of this object.
     * @param aFs - a reference to the file server session.
     */
    CJcfJadJarMatcherScanJarFiles(MJcfJadJarMatcherObserver* aObs, RFs& aFs);

    /**
     * To destruct CJcfJadJarMatcherScanJarFiles.
     *
     * Preconditions. The following conditions must be true prior to calling
     * this method; otherwise, its operation is undefined.
     * - None.
     *
     * Postconditions. The following condition is true immediately after
     * returning from this method.
     * - No pending request.
     *
     */
    virtual ~CJcfJadJarMatcherScanJarFiles();

    /**
     * To execute this state.
     *
     * Preconditions. The following conditions must be true prior to calling
     * this method; otherwise, its operation is undefined.
     * - aJarNamePtr.Length() >= 256.
     *
     * Postconditions. The following condition is true immediately after
     * returning from this method.
     * - iState == EOpenJadFile.
     *
     * @param aJadName - a name of the JAD file.
     * @param aDirName - a name of the directory to be scanned.
     * @param aJarNamePtr - a pointer to the descriptor, where name of the JAR file
     * is stored.
     * @leave Creation of the JAD file fails.
     * @leave Creation of iDir descriptor fails.
     */
    virtual void ExecuteL(const TDesC& aJadName, const TDesC& aDirName, TDes* aJarNamePtr);

protected:
    /**
     * To match JAR and JAD files from public folders.
     *
     * Preconditions. The following conditions must be true prior to calling
     * this method; otherwise, its operation is undefined.
     * - Successfull call of ExecuteL.
     *
     * Postconditions. The following condition is true immediately after
     * returning from this method.
     * - None.
     *
     * @leave If abnormal execution, e.g., allocation fails.
     */
    virtual void RunL();

    /**
     * To cancel this object activity.
     *
     * Preconditions. The following conditions must be true prior to calling
     * this method; otherwise, its operation is undefined.
     * - None.
     *
     * Postconditions. The following condition is true immediately after
     * returning from this method.
     * - No pending requests.
     *
     */
    virtual void DoCancel();

    /**
     * To check whether a file is possible JAR file or not.
     *
     * Definition. Operation returns false if at least one of following
     * statements is true:
     *
     * 1) The MIME type is defined and it is not MIME for JAR file.
     *
     * Otherwise operation returns true.
     *
     * Preconditions. The following conditions must be true prior to calling
     * this method; otherwise, its operation is undefined.
     * - None.
     *
     * Postconditions. The following condition is true immediately after
     * returning from this method.
     * - None.
     *
     * @param aAttaInfo - an attachment to be checked.
     * @return False if file is not JAR file.
     */
    //TBool IsFilePossibleJarFileL( const TDesC& fileName );

private:
    /**
     * To do clean-up for next round.
     *
     * Preconditions. The following conditions must be true prior to calling
     * this method; otherwise, its operation is undefined.
     * - None.
     *
     * Postconditions. The following condition is true immediately after
     * returning from this method.
     * - iState == EBegin.
     *
     */
    void Cleanup();

    /**
     * To complete pending request and set this object active.
     *
     * Preconditions. The following conditions must be true prior to calling
     * this method; otherwise, its operation is undefined.
     * - None.
     *
     * Postconditions. The following condition is true immediately after
     * returning from this method.
     * - iActive == ETrue.
     * - iStatus == KErrNone.
     *
     */
    void SetObjectActive();

private:
    TFindFile iFf;
    TBool iAdHocGuess;
    TBool iIsAbsolute;
    TInt iIndex;
    TDes* iJarFileNamePtr;
    HBufC* iDir;
    CDir* iFl;
    RPointerArray<Java::MJavaAttribute>iAttributes;

    RFs& iFs;
    std::auto_ptr<HBufC> iFullJadName;

};

#endif // JCFJADJARMATCHERSCANJARFILES_H