videocollection/mpxmyvideoscollection/inc/vcxmyvideoscollectionplugin.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Mon, 21 Jun 2010 15:43:03 +0300
branchRCL_3
changeset 45 baf439b22ddd
parent 26 67eb01668b0e
permissions -rw-r--r--
Revision: 201023 Kit: 2010125

/*
* Copyright (c) 2008 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:   Implementation of My Videos MPX Collection Plugin interface*
*/



#ifndef VCXMYVIDEOSCOLLECTIONPLUGIN_H
#define VCXMYVIDEOSCOLLECTIONPLUGIN_H

// INCLUDES

#include <mpxcollectionplugin.h>
#include <mpxcollectionpath.h>
#include <mpxcollectionmessagedefs.h>
#include <vcxmyvideosdefs.h>

#include "vcxmyvideosactivetask.h"

#include "vcxmyvideosmdsdb.h"

// FORWARD DECLARATIONS
class CVcxMyVideosMdsDb;
class CMPXResource;
class CMPXMediaArray;
class CVcxMyVideosVideoCache;
class CVcxMyVideosCategories;
class CVcxMyVideosMessageList;
class CVcxMyVideosAsyncFileOperations;
class CVcxMyVideosOpenHandler;
class CVcxMyVideosAlbums;

// CONSTANTS

// CLASS DECLARATION

/**
* Plug-in, provides access to My Videos collection.
*
* @lib mpxmyvideoscollectionplugin.lib
*/
NONSHARABLE_CLASS(CVcxMyVideosCollectionPlugin) :
    public CMPXCollectionPlugin,
    public MVcxMyVideosMdsDbObserver,
    public MVcxMyVideosActiveTaskObserver
    {    
    public: // Constructors and destructor

        friend class CVcxMyVideosOpenHandler;
        friend class CVcxMyVideosVideoCache;
        friend class CVcxMyVideosAlbums;
        
        /**
        * Two-phased constructor
        * @param aInitParams: initialization parameters
        * @return object constructed
        */
        static CVcxMyVideosCollectionPlugin* NewL (TAny* aInitParams);

        /**
        * Destructor
        */
        virtual ~CVcxMyVideosCollectionPlugin();

    public: // from base classes
        /**
        * From CMPXCollectionPlugin
        * Navigates to the given path.  This method is serviced
        * asynchronously and HandleOpenL is called upon completion
        * @param aPath a path
        * @param aAttrs attributes requested
        * @param aFilter filter to apply or NULL if none
        */
        void OpenL(const CMPXCollectionPath& aPath,
                   const TArray<TMPXAttribute>& aAttrs,
                   CMPXFilter* aFilter);
        
        /**
        * From CMPXCollectionPlugin
        * Get the extended properties of the item referred to by the
        * specified collection path.  This method is serviced asynchronously and
        * HandleMediaL is called upon completion
        * @param aPath a collection path referring to the item to retrieve the
        *               extended properties for
        * @param aAttr: array of attributes requested
        * @param aCaps platsec capabilities of client requesting media; plug-in
        *        should also verify its process capabilities (not yet supported)
        * @aParam aSpecs specifications for attributes (not yet supported)
        */
        void MediaL(const CMPXCollectionPath& aPath,
                    const TArray<TMPXAttribute>& aAttrs,
                    const TArray<TCapability>& aCaps,
                    CMPXAttributeSpecs* aSpecs);

        /**
        * From CMPXCollectionPlugin
        * Cancel outstanding request.
        */
        void CancelRequest();

        /**
        * From CMPXCollectionPlugin
        * Executes the given CMPXCommand command on the collection
        * @param aCmd a command
        */
        void CommandL(CMPXCommand& aCmd);

        /**
        * From CMPXCollectionPlugin
        *  Find the items matching the media specifications.  This method is serviced
        *  asynchronously and HandleFindAllL is called upon completion
        *  @param aCriteria Properties of the item that is to be found
        *  @param aAttrs Requested attributes to return
        */
        void FindAllL(const CMPXMedia& aCriteria, const TArray<TMPXAttribute>& aAttrs);

        /**
        *  From CMPXCollectionPlugin
        *  Find the items matching the media specifications
        *  @param aCriteria Properties of the item that is to be found
        *  @param aAttrs Requested attributes to return
        *  @return results of the search. Method abandons ownership of results.
        */
        CMPXMedia* FindAllSyncL(const CMPXMedia& aCriteria,
                                const TArray<TMPXAttribute>& aAttrs);

        /**
        * Get the list of supported capabilities
        * @return TCollectionCapability, bitmask of supported capabilities
        */
        TCollectionCapability GetCapabilities();

        /**
        * DEPRECATED
        * From CMPXCollectionPlugin
        * Executes the given TMPXCollectionCommand command on the collection
        * @param aCmd a command
        * @param aArg an argument
        */
        void CommandL(TMPXCollectionCommand /*aCmd*/, TInt /*aArg = 0*/) {}

        /**
        * DEPRECATED
        * From CMPXCollectionPlugin
        * Adds an episode to the collection
        * @param aMedia Properties of the item
        */
        void AddL(const CMPXMedia& /*aMedia*/) {}

        /**
        * DEPRECATED
        * From CMPXCollectionPlugin
        * Remove an item(s) from the collection database using the given path
        * Note that the selection indices are hidden within the path
        * @param aPath: path to the item to be removed
        *
        */
        void RemoveL(const CMPXCollectionPath& /*aPath*/) {}

        /**
        *  DEPRECATED
        *  Remove item(s) from the collection database using the given media properties
        *  @param aMedia Properties of the item(s) to be removed. May cantain a URI
        *                 or metadata. All item(s) matching the specified properties
        *                 will be removed.
        */
        void RemoveL(const CMPXMedia& /*aMedia*/) {}

        /**
        *  DEPRECATED
        *  Sets/updates the specified media for an item in the collection.  Media
        *  is identified by specifying an ID or URI.
        *  @param aMedia: new property values for the item
        */
        void SetL(const CMPXMedia& /*aMedia*/) {}

        /**
        * From MMPXDbActiveTaskObserver
        */
        MVcxMyVideosActiveTaskObserver::TStepResult HandleStepL();

        /**
        * From MMPXDbActiveTaskObserver
        */
        void HandleOperationCompleted( TInt aErr );

        /**
        * From MVcxMyVideosMdsDbObserver.
        */
        void HandleMyVideosDbEvent( TMPXChangeEventType aEvent,
                RArray<TUint32>& aId, TInt aEventsLeft );

        /**
        * Leaving version of HandleMyVideosDbEvent.
        */
        void DoHandleMyVideosDbEventL( TMPXChangeEventType aEvent,
                RArray<TUint32>& aId, TInt aEventsLeft );
                
        /**
        * From MVcxMyVideosMdsDbObserver.
        * Handler function for list fetching events. This callback is called as a response
        * to CreateVideoList( aSync = EFalse ).
        *
        * @param aVideoList           List of videos fetched from MDS.
        * @param aNewItemsStartIndex  Start position for the new items added.
        * @param aComplete            ETrue if list is complete and no more items are expected,
        *                             EFalse if there are more to come.
        */
        void HandleCreateVideoListResp( CMPXMedia* aVideoList, TInt aNewItemsStartIndex,
                TBool aComplete );

        /**
        * From MVcxMyVideosMdsDbObserver. Called when media is removed or inserted.
        */
        void HandleObjectPresentNotification();
        
        /**
        * Leaving version of HandleObjectPresentNotification.
        */
        void DoHandleObjectPresentNotificationL();
                 
    private:
        /**
        * Constructor
        */
        CVcxMyVideosCollectionPlugin();

        /**
        * Symbian 2nd phase constructor.
        */
        void ConstructL ();
                        
        /**
        * Copies KVcxMediaMyVideosTransactionId field from aRequest to aResp.
        */
        void SetTransactionIdL( CMPXMedia& aRequest, CMPXMedia& aResp );
               
        /**
        * Generates and sends resp message for Move,Copy and Delete operations.
        * Does nothing if there is some other operation going on.
        * This function is called when operation is interrupted from a leave or
        * cancel request.
        * Leaves with KErrNotFound if no operation was in progress.
        *
        * @param aErr  Error code which is set for non handled items in the resp array.
        */
        void CancelOperationL( TInt aErr );
 
        /**
        * Returns reference to iAsyncFileOperations member.
        *
        * @return reference to iAsyncFileOperations.
        */        
        CVcxMyVideosAsyncFileOperations& AsyncFileOperationsL();
        
        /**
        * Called by iCache when it notices that current video list fetching has to
        * be done again from the scratch. This is called only when there is video list
        * fetching ongoing.
        */
        void RestartVideoListFetchingL();
        
    public:

        /**
        * Adds video to MDS and cache.
        *
        * @param aVideo video to add, KMPXMediaGeneralId will be set to new value.
        */
        void AddVideoToMdsAndCacheL( CMPXMedia& aVideo );

        /**
        * Sets video parameters in iCache and MDS from aVideo.
        *
        * @param aVideo  Media used to copy parameters from.
        */
        void SetVideoL( CMPXMedia& aVideo );

        /**
        * Sends My Videos message to clients. Transaction ID is copied from
        * aCommand if it is available.
        *
        * @param aMessageId Message id.
        * @param aCommand   Command which has caused the message, optional.
        *                   Ownership does not move.
        */
        void SendMyVideosMessageL( TUint32 aMessageId, CMPXCommand* aCommand = NULL );

        /**
        * Sends messages to clients. If udeb version, adds messageid
        * parameter to the message for debugging purposes. May or may not
        * contain media list as parameter.
        *
        * @param aMessages  Messages to send.
        */
        void SendMessages( CMPXMessage& aMessages );

        /**
        * Creates iCategories if its not created yet and returns reference to it.
        *
        * @return Reference to iCategories member.
        */
        CVcxMyVideosCategories& CategoriesL();

        /**
        * Creates iAlbums if its not created yet and returns reference to it.
        *
        * @return Reference to iAlbums member.
        */
        CVcxMyVideosAlbums& AlbumsL();

        /**
        * Notifies to mediator listeners that count of new videos has decreased.
        * 
        * @param aVideo Removed or watched video.  
        */
        void NotifyNewVideosCountDecreasedL( CMPXMedia& aVideo );
        
    public:
        /**
        * MDS database handler, own.
        */
        CVcxMyVideosMdsDb* iMyVideosMdsDb;

        /**
        * MDS items are cached here for fast access.
        * Own.
        */
        CVcxMyVideosVideoCache* iCache;

        /**
        * Messages are grouped here for sending.
        */        
        CVcxMyVideosMessageList* iMessageList;

        /**
        * File server session.
        */
        RFs iFs;

        /**
        * Executes command in several small steps.
        */
        CVcxMyVideosActiveTask* iActiveTask;
                        
    private:

        /**
        * Contains category list, accessed through CategoriesL() function.
        * Own.
        */
        CVcxMyVideosCategories* iCategories;
        
        /**
        * Albums related functionality (except mds db operations). Own.
        */
        CVcxMyVideosAlbums* iAlbums;

        /**
        * Target drive for Move operation.
        */
        TInt iTargetDrive;
        
        /**
        * Performs multiple Move,Copy and Delete operations step by step. Own.
        */
        CVcxMyVideosAsyncFileOperations* iAsyncFileOperations;
        
        /**
        * Contains collection Open operation related functionality.
        */
        CVcxMyVideosOpenHandler* iOpenHandler;
        
        /**
        * Used for clearing orphan downloads only once.
        */
        TBool iOrphanDownloadsCleared;

    };

#endif   // VCXMYVIDEOSCOLLECTIONPLUGIN_H