/*

* 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 "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:  Mpx nofifier class

*

*/

#ifndef __CMFMMPXNOTIFIER_H

#define __CMFMMPXNOTIFIER_H

#include <e32base.h>

#include "mpxmediatorobserver.h" // base class

#include "mpxcollectionobserver.h" // base class

// Forward declarations

class MMPXHarvesterUtility;

class MMPXCollectionUtility;

class CMPXCollectionMediator;

/**

 *  CCmFmMpxNotifier class

 *  Part of Fill manager.

 *  Mpx nofifier class

 *

 *  @lib cmfillmanager.lib

 *

 *  @since S60 5.1

 */

NONSHARABLE_CLASS( CCmFmMpxNotifier ): public CBase,

                     public MMPXMediatorObserver,

                     public MMPXCollectionObserver

    {

public:    

    /**

     * Two-phased constructor.

     */

    static CCmFmMpxNotifier* NewL( );

    /**

     * Two-phased constructor.

     */

    static CCmFmMpxNotifier* NewLC( );

    /**

     * Destructor.

     */

    virtual ~CCmFmMpxNotifier();

public: 

    /**

     * Notifying Mpx about new music files

     *

     * @since S60 5.1

     * @param aTrackPath, path to track

     * @param aTrackMetadata, metadata to be added in mpx db

     * @return None

     */     

    void NotifyMpxL( const TDesC& aTrackPath,

                    const CUpnpItem& aTrackMetadata );

protected:

// From base class MMPXMediatorObserver

    /**

     * From MMPXMediatorObserver

     * See base class definition

     */

    void HandleMediatorPathUpdatedL(

        CMPXMedia*& /*aMedia*/, TUid /*aOldPath*/ ) {}

// From base class MMPXCollectionObserver

    /**

     * From MMPXCollectionObserver

     * See base class definition

     */

    void HandleCollectionMediaL(

        const CMPXMedia& /*aMedia*/, TInt /*aError*/) {}

    /**

     * From MMPXCollectionObserver

     * See base class definition

     */

    void HandleCollectionMessageL(

        const TMPXCollectionMessage& /*aMessage*/ ) {}

    /**

     * From MMPXCollectionObserver

     * See base class definition

     */

    void HandleCollectionMessageL(

        const CMPXMessage& /*aMsg*/ ) {}

    /**

     * From MMPXCollectionObserver

     * See base class definition

     */

    void HandleOpenL(

        const CMPXMedia& /*aEntries*/,

        TInt /*aIndex*/, TBool /*aComplete*/, TInt /*aError*/ ) {}

    /**

     * From MMPXCollectionObserver

     * See base class definition

     */

    void HandleOpenL(

        const CMPXCollectionPlaylist& /*aPlaylist*/,

        TInt /*aError*/ ) {}

    /**

     * From MMPXCollectionObserver

     * See base class definition

     */

    void HandleCommandComplete(

        CMPXCommand* /*aCommandResult*/, TInt /*aError*/) {}                    

private:

    /**

     * Finds an element within CUpnpItem

     * returns the element value converted to unicode

     *

     * Since S60 5.1

     * @param aSource the source CUpnpItem

     * @param aSourceField the element name within source

     * @return the vield value, or 0 if element not found.

     */

    HBufC16* GetElementL( const CUpnpItem& aSource,

        const TDesC8& aSourceField ) const;    

private:

    /**

     * Performs the first phase of two phase construction.

     */

    CCmFmMpxNotifier( );

    /**

     * Performs the second phase construction.

     */

    void ConstructL();

private: // data

    /**

     * MPX harvester utility

     */

    MMPXHarvesterUtility* iHarvester;               // Owned

    /**

     * MPX collection utility

     */

    MMPXCollectionUtility* iCollectionUtil;         // Owned

    /**

     * MPX collection mediator

     */

    CMPXCollectionMediator* iMediator;              // Owned 

    };

#endif //  __CMFMMPXNOTIFIER_H