/*

* Copyright (c) 2005-2007 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:  Meta data fetching utilities

*

*/

#ifndef UPNPMETADATAFETCHER_H

#define UPNPMETADATAFETCHER_H

// INCLUDES

#include <e32base.h>

// FORWARD DECLARATIONS

class CUpnpObject;

// CLASS DECLARATION

/**

* Static meta data fetching utilities.

*

* @lib upnputilities.lib

* @since S60 3.1

*/

class UPnPMetadataFetcher

    {

public:

    /**

     * Resolves the metadata and fills in the CUpnpObject's metadata 

     * fields accordingly.

     * 

     * @since Series 60 3.1

     * @param aObject (CUpnpObject&) the target CUpnpObject

     * @param aFilePath (const TDesC&) the filepath of the file

     * @param aMimeType (const TDesC8&) the mime type of the file

     */

    IMPORT_C static void FetchMetadataL( CUpnpObject& aObject, 

                                         const TDesC& aFilePath, 

                                         const TDesC8& aMimeType );

    /**

     * Resolves the metadata and fills in the CUpnpObject's metadata 

     * fields accordingly.

     * 

     * @since Series 60 3.1

     * @param aObject (CUpnpObject&) the target CUpnpObject

     * @param aFilePath (const TDesC&) the filepath of the file

     */

    IMPORT_C static void FetchMetadataL( CUpnpObject& aObject, 

                                         const TDesC& aFilePath );

    /**

     * Creates a new CUpnpItem from a local file. Resolves the metadata and 

     * fills in the new CUpnpItem's metadata fields accordingly.

     * 

     * @since Series 60 3.1

     * @param aFilePath (const TDesC&) the filepath of the file

     * @return (CUpnpItem*) pointer to the newly created CUpnpItem,

     *         or NULL if the creation of the item or metadata resolving

     *         fails. Pushes the object into the CleanupStack.

     */

    IMPORT_C static CUpnpItem* CreateItemFromFileLC( 

                                            const TDesC& aFilePath );

    /**

     * Creates a new CUpnpItem from a local file. Resolves the metadata and 

     * fills in the new CUpnpItem's metadata fields accordingly.

     * 

     * @since Series 60 3.1

     * @param aFilePath (const TDesC&) the filepath of the file

     * @return (CUpnpItem*) pointer to the newly created CUpnpItem,

     *         or NULL if the creation of the item or metadata resolving

     *         fails.

     */

    IMPORT_C static CUpnpItem* CreateItemFromFileL(

                                            const TDesC& aFilePath );

private:

    static void AddElementToObjectL(CUpnpObject& aObject,

                                         const TDesC& aMetaDataUtilityName, 

                                         const TDesC8& aElementName );

    };

#endif // UPNPMETADATAFETCHER_H

// End of File