--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/upnpframework/upnputilities/inc/upnpmetadatafetcher.h Thu Dec 17 08:52:00 2009 +0200
@@ -0,0 +1,95 @@
+/*
+* 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 );
+
+ };
+
+#endif // UPNPMETADATAFETCHER_H
+
+// End of File