/*
* Copyright (c) 2002 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the License "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:   ?Description
*
*/




#ifndef TCOMPLUGIN_H
#define TCOMPLUGIN_H

//  INCLUDES
#include <StifLogger.h>
#include <TestScripterInternal.h>
#include <StifTestModule.h>

#include "serviceerrno.h"

#include <LiwCommon.h>
#include <LiwBufferExtension.h>
#include <LiwServiceHandler.h>

#include <MVPbkContactStoreListObserver.h>
#include <MVPbkContactObserver.h>
#include <MVPbkContactFindObserver.h>
#include <MVPbkSingleContactOperationObserver.h>
#include <MVPbkBatchOperationObserver.h>
#include <MVPbkStoreContact.h>

class CVPbkContactManager;
class MVPbkContactStoreList;
class MVPbkStoreContact;
class MVPbkContactOperationBase;

class CVPbkContactLinkArray;
_LIT( KContactsUTLogPath, "\\logs\\testframework\\ContactsUT\\" ); 
// Log file
_LIT( KContactsUTLogFile, "ContactsUT.txt" ); 

/**
*  CTestProvider test class for STIF Test Framework TestScripter.
*  ?other_description_lines
*
*  @lib ?library
*  @since ?Series60_version
*/
NONSHARABLE_CLASS(CTestProvider) :public CScriptBase,public MLiwNotifyCallback,
                                  public MVPbkContactStoreListObserver,
                                  public MVPbkContactObserver,
                                  public MVPbkContactFindObserver,
                                  public MVPbkSingleContactOperationObserver,
                                  public MVPbkBatchOperationObserver
    {
    enum TTestCase
        {
        EGetAllContacts = 0,
        EGetContactSearch,
        EGetGroup,
        EGetDatabase,
        EAddContact,
        EDeleteContact,
        EDeleteVerify,
        EAddGroup,
        EOrganizeAddcntid,
        EOrganizeAdd,
        EOrganizeDelete,
        EImportVcard,
        EExportVcard,
        EVerifyGroupAdd,
        EVerifyImport,
        EVerifyOrganizeDelete,
        EModifyContact,
        EModifyContactComplete,
        EModifyContactVerify            
        };
    public:  // Constructors and destructor

        /**
        * Two-phased constructor.
        */
        static CTestProvider* NewL( CTestModuleIf& aTestModuleIf );

        /**
        * Destructor.
        */
        virtual ~CTestProvider();

    public: // New functions

        /**
        * ?member_description.
        * @since ?Series60_version
        * @param ?arg1 ?description
        * @return ?description
        */
        //?type ?member_function( ?type ?arg1 );

    public: // Functions from base classes

        /**
        * From CScriptBase Runs a script line.
        * @since ?Series60_version
        * @param aItem Script line containing method name and parameters
        * @return Symbian OS error code
        */
        virtual TInt RunMethodL( CStifItemParser& aItem );
        void LoadService();

    protected:  // New functions

        /**
        * ?member_description.
        * @since ?Series60_version
        * @param ?arg1 ?description
        * @return ?description
        */
        //?type ?member_function( ?type ?arg1 );

    protected:  // Functions from base classes

        /**
        * From ?base_class ?member_description
        */
        //?type ?member_function();

    private:
		TInt HandleNotifyL(	TInt aCmdId,
            	            TInt aEventId,
            	            CLiwGenericParamList& aEventParamList,
            	            const CLiwGenericParamList& aInParamList );
        /**
        * C++ default constructor.
        */
        CTestProvider( CTestModuleIf& aTestModuleIf );
        

        /**
        * By default Symbian 2nd phase constructor is private.
        */
        void ConstructL();

        // Prohibit copy constructor if not deriving from CBase.
        // ?classname( const ?classname& );
        // Prohibit assigment operator if not deriving from CBase.
        // ?classname& operator=( const ?classname& );

        /**
        * Frees all resources allocated from test methods.
        * @since ?Series60_version
        */
        void Delete();
              /**
        * From CScriptBase Runs a script line.
        * @since ?Series60_version
        * @param aItem Script line containing method name and parameters
        * @return Symbian OS error code
        */
        virtual void HandleError( const TInt& aError,TInt aTransId );
        
        
        /*
         * Called when creating a new contact or retrieving a contact is successful
         */
        virtual void HandleRetrieveContact( MVPbkStoreContact* aStoreContact, TInt aTransId );
        
        //MVPbkContactStoreListObserver
        /**
         * Called when the opening process is complete. 
         *
         * Before this all stores have sent StoreReady or StoreUnavailable 
         * event. The client can not trust that all stores are available
         * for use when this is called.
         */
        virtual void OpenComplete();
        
        /**
         * Called when a contact store is ready to use.
         *
         * @param aContactStore The store that is ready.
         */
        virtual void StoreReady(MVPbkContactStore& aContactStore);

        /**
         * Called when a contact store becomes unavailable.
         *
         * Client may inspect the reason of the unavailability and decide
         * whether or not it will keep the store opened (ie. listen to 
         * the store events).
         *
         * @param aContactStore The store that became unavailable.
         * @param aReason The reason why the store is unavailable.
         *                This is one of the system wide error codes.
         */
        virtual void StoreUnavailable(MVPbkContactStore& aContactStore, 
                TInt aReason);

        /**
         * Called when changes occur in the contact store.
         *
         * @see TVPbkContactStoreEvent
         * @param aContactStore A store whose event it is.
         * @param aStoreEvent The event that has occurred.
         */
        virtual void HandleStoreEventL(
                MVPbkContactStore& aContactStore, 
                TVPbkContactStoreEvent aStoreEvent);
        
        //MVPbkContactObserver
        /**
         * Called when a contact operation has succesfully completed.
         *
         * NOTE: If you use Cleanupstack for MVPbkStoreContact use 
         * MVPbkStoreContact::PushL or CleanupDeletePushL from e32base.h.
         * (Do Not Use CleanupStack::PushL(TAny*) because then the virtual 
         * destructor of the M-class won't be called when the object 
         * is deleted).
         *
         * @param aResult   The result of the operation. The client takes
         *                  the ownership of the iStoreContact immediately
         *                  if set in aResult.
         */
        virtual void ContactOperationCompleted(TContactOpResult aResult);

        /**
         * Called when a contact operation has failed.
         *
         * @param aOpCode           The operation that failed.
         * @param aErrorCode        System error code of the failure.
         *							KErrAccessDenied when EContactCommit 
         *							means that contact hasn't been locked.
         * @param aErrorNotified    ETrue if the implementation has already
         *                          notified user about the error, 
         *                          EFalse otherwise.
         */
        virtual void ContactOperationFailed
            (TContactOp aOpCode, TInt aErrorCode, TBool aErrorNotified);
         
         //MVPbkContactFindObserver   
        /**
         * Called when find is complete. Caller takes ownership of the results
         * In case of an error during find, the aResults may contain only 
         * partial results of the find
         *
         * @param aResults Array of contact links that matched the find
         *                 Callee must take ownership of this object in
         *                 the start of the function, ie. in case the 
         *                 function leaves the results must be destroyed. 
         *                 The find operation can be destroyed at the end 
         *                  of this callback.
         */
        virtual void FindCompleteL( MVPbkContactLinkArray* aResults );

        /**
         * Called in case the find fails for some reason. The find operation
         * can be destroyed at the end of this callback.
         * 
         * @param aError One of the system wide error codes.
         *        KErrNotReady if store is not ready (not open or unavailable)
         */
        virtual void FindFailed( TInt aError );
		
		
		//MVPbkSingleContactOperationObserver
        /**
         * Called when the operation is completed.
         *
         * A client has the operation as a member and it can delete the operation
         * instance in this function call. If the implementation of the store
         * calls the function from the operation instance it must not handle
         * any member data after calling it.
         *
         * @param aOperation The completed operation.
         * @param aContact The contact returned by the operation.
         *                 A client must take the ownership immediately.
         *
         *                  NOTE:
         *                  If you use CleanupStack for MVPbkStoreContact
         *                  Use MVPbkStoreContact::PushL or
         *                  CleanupDeletePushL from e32base.h.
         *                  (Do Not Use CleanupStack::PushL(TAny*) because
         *                  then the virtual destructor of the M-class
         *                  won't be called when the object is deleted).
         */
        virtual void VPbkSingleContactOperationComplete(
                MVPbkContactOperationBase& aOperation,
                MVPbkStoreContact* aContact );

        /**
         * Called if the operation fails.
         *
         * A client has the operation as a member and it can delete the operation
         * instance in this function call. If the implementation of the store
         * calls the function from the operation instance it must not handle
         * any member data after calling it.
         *
         * @param aOperation The failed operation.
         * @param aError An error code of the failure.
         */
        virtual void VPbkSingleContactOperationFailed(
                MVPbkContactOperationBase& aOperation, 
                TInt aError );
         
         //MVPbkBatchOperationObserver       
        /**
         * Called when one step of the operation is completed.
         *
         * @param aOperation Operation whose step has completed
         * @param aStepSize Size of the performed step
         */
        virtual void StepComplete( 
                MVPbkContactOperationBase& aOperation,
                TInt aStepSize );

        /**
         * Called when one step of the operation fails.
         *
         * @param aOperation Operation whose step has failed
         * @param aStepSize Size of the performed step
         * @param aError Error that occured
         * @return ETrue if the batch operation should continue, 
         *               EFalse otherwise
         *         NOTE! If returning ETrue the operation can NOT be deleted.
         *               Operation should be deleted in OperationCompleted() 
         *               function.
         *               If returning EFalse the operation can be deleted
         *               safely.
         */
        virtual TBool StepFailed(
                MVPbkContactOperationBase& aOperation,
                TInt aStepSize, TInt aError );

        /**
         * Called when operation is completed.
         * This is called when all steps are executed. If EFalse is returned
         * in StepFailed() call this function is NOT called.
         *
         * @param aOperation    the completed operation
         */
        virtual void OperationComplete( 
                MVPbkContactOperationBase& aOperation );

        /**
        * Test methods are listed below. 
        */	
        /**
        * Example test method.
        * @since ?Series60_version
        * @param aItem Script line containing parameters.
        * @return Symbian OS error code.
        */
        virtual TInt GetContactALL(CStifItemParser &aItem );
        virtual TInt GetContactSearch(CStifItemParser &aItem );
        virtual TInt GetGroup(CStifItemParser& aItem) ;
        virtual TInt GetDatabase(CStifItemParser& aItem) ;
        virtual TInt AddContact(CStifItemParser& aItem) ;
        virtual TInt DeleteContact(CStifItemParser& aItem) ;
        virtual TInt AddGroup(CStifItemParser& aItem) ;
		virtual TInt OrganiseAdd(CStifItemParser& aItem) ;
		virtual TInt OrganiseDelete(CStifItemParser& aItem);
		virtual TInt ModifyContact(CStifItemParser& aItem);
		virtual TInt ModifyGroup(CStifItemParser& aItem);
		virtual TInt GetContactALLPosBased(CStifItemParser& aItem);
		virtual TInt GetContactSearchPosBased(CStifItemParser& aItem);
		virtual TInt GetGroupPosBased(CStifItemParser& aItem);
		virtual TInt GetDatabasePosBased(CStifItemParser& /*aItem*/) ;
		virtual TInt AddContactPosBased(CStifItemParser& /*aItem*/) ;
		virtual TInt AddGroupPosBased(CStifItemParser& /*aItem*/) ;
		virtual TInt DeleteContactPosBased(CStifItemParser& /*aItem*/) ;
		virtual TInt OrganiseAddPosBased(CStifItemParser& /*aItem*/) ;
		virtual TInt OrganiseDeletePosbased(CStifItemParser& /*aItem*/) ;
		virtual TInt ModifyContactPosBased(CStifItemParser& /*aItem*/) ;
		virtual TInt ModifyGroupPosBased(CStifItemParser& /*aItem*/) ;
		virtual TInt ExportL(CStifItemParser& /*aItem*/) ;
        virtual TInt ImportL(CStifItemParser& /*aItem*/) ;
        virtual TInt ExportPosBased(CStifItemParser& /*aItem*/) ;
        virtual TInt ImportPosBased(CStifItemParser& /*aItem*/) ; 
        virtual TInt CancelGetList(CStifItemParser& /*aItem*/) ; 
        virtual TInt CancelAddContact(CStifItemParser& /*aItem*/) ; 
        virtual TInt CancelOrganiseAdd(CStifItemParser& /*aItem*/) ; 
        virtual TInt CancelDeleteContact(CStifItemParser& /*aItem*/) ; 
       	virtual TInt CancelExportL(CStifItemParser& /*aItem*/) ; 
      	virtual TInt CancelImportL(CStifItemParser& /*aItem*/) ; 
        
        
        void AddOneContactL(const TDesC& aName);
	    void AddOneGroupL(const TDesC& aName);       
    public:     // Data
        // ?one_line_short_description_of_data
        //?data_declaration;

    protected:  // Data
        // ?one_line_short_description_of_data
        //?data_declaration;

    private:    // Data
        
        // ?one_line_short_description_of_data
        //?data_declaration;
        TInt CTestGetLocation() ;

        // Reserved pointer for future extension
        //TAny* iReserved;

    public:     // Friend classes
        //?friend_class_declaration;
    protected:  // Friend classes
        //?friend_class_declaration;
    private:    // Friend classes
        //?friend_class_declaration;        
        
            CLiwServiceHandler* iServiceHandler;
            MLiwInterface* iIface;            
            CLiwCriteriaItem* iCriteria;
            RCriteriaArray iCriteriaArray;
            //CLiwMap* iMap;
            CLiwGenericParamList* iInparams;
            CLiwGenericParamList* iOutparams;
            
            CLiwGenericParamList* inList;
            CLiwGenericParamList* outList;
            TInt iErr;
            TTestCase iCase;
            TInt iResult;
            TInt iIndex;
            RFs iFSession;
            RFile iFileHandle;
            TInt32 iTransid;
            HBufC* iCntID;
            TPtrC iGrpID;
            RPointerArray<TDesC> iIdArrayList;
            
            CVPbkContactManager* iContactManager;
	        MVPbkContactStoreList* iStores;
	        MVPbkContactStore* iStore;
	        MVPbkStoreContact* iStoreContact;
	        MVPbkContactGroup* iGroup;
	        MVPbkContactLinkArray* iFindResults;
	        MVPbkContactLink* iContactResult;
	        MVPbkContactOperationBase* iOp;
	        CVPbkContactLinkArray* iContactToDelete;
            HBufC8* iBuffer;
	        TInt iOperation;                                   
	        TInt iCancelled;;

    };
    
    


#endif      // TCOMPLUGIN_H

// End of File
