--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/languageinterworkingfw/servicehandler/inc/liwservicedata.h Mon Mar 30 12:51:20 2009 +0300
@@ -0,0 +1,141 @@
+/*
+* Copyright (c) 2003-2005 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: Declares Service Data and Service Provider Metadata classes
+*
+*/
+
+
+
+
+
+
+
+#ifndef LIW_SERVICEDATA_H
+#define LIW_SERVICEDATA_H
+
+// INCLUDES
+#include <e32base.h>
+
+// CONSTANTS
+
+// MACROS
+
+// FUNCTION PROTOTYPES
+
+// FORWARD DECLARATIONS
+class CLiwServiceData;
+class CLiwXmlHandler;
+class CLiwServiceHandlerImpl;
+class CDesC8Array;
+
+class CLiwMap;
+class CLiwGenericParamList;
+class TLiwVariant;
+
+/**
+* CLiwServiceData models the service provider data/information.
+* A Service provider can obtain its metadata through the interfaces
+* of this class. The Service metadata is a name-value pair defined
+* by the provider as part of its registration information (Refer \c REGISTRY_INFO).
+*
+* One of the key metadata value is the capability set which are expected
+* from the service consumer by the provider. The required capability set
+* is specifed in the provider registration information (Refer \c REGISTRY_INFO).
+*
+* ServiceHandler queries for those capabilities using \c CLiwServiceData::GetCapabilitiesL
+*
+* @lib ServiceHandler.lib
+*
+* @see CLiwServiceHandler
+* @see CLiwMetaData
+* @see TCapability
+*/
+class CLiwServiceData : public CBase
+{
+public:
+
+
+ /**
+ * Returns the service metadata.
+ *
+ * @return the service metadata
+ */
+ CLiwGenericParamList* GetMetaData() const;
+
+ // Destructor
+ virtual ~CLiwServiceData();
+
+private:
+
+ /*
+ * Creates and returns an instance of \c CLiwServiceData
+ * This is private and not available for external clients.
+ *
+ * @return the instance of created instance of \c CLiwServiceData
+ */
+ static CLiwServiceData* NewL();
+
+ /*
+ * Creates and returns an instance of \c CLiwServiceData
+ * The created instance is left in the cleanupstack.
+ * This is private and not available for external clients.
+ *
+ * @return the instance of created instance of \c CLiwServiceData
+ */
+ static CLiwServiceData* NewLC();
+
+ /*
+ * Default private constructor.
+ * Creates the metadata associated with the service data
+ */
+ CLiwServiceData();
+
+ /*
+ * Second phase constructor
+ */
+ void ConstructL();
+
+ /*
+ * Adds a metadata name-value pair. If the key already exists,
+ * then the value will be added to the list of values associated
+ * with the metadata key
+ *
+ * @param aKey the metadata key to be inserted
+ * @param aValue the value associated with the metadata key to be inserted
+ */
+ void AddMetaDataL(const TDesC8& aKey, const TDesC8& aValue);
+ void AddMetaDataL(const TDesC8& aKey, const TLiwVariant& aValue);
+
+ /*
+ * Removes all the metadata key-value pairs.
+ * This is called from service handler implementation if and only
+ * if there is an error in parsing. Since, the FW uses SAX parser
+ * and if the XML error happens after the metadata entries are
+ * created, the entries should be cleaned up.
+ */
+ void CleanUpMetaData();
+
+
+
+ CLiwGenericParamList* iDataList;
+
+ friend class CLiwXmlHandler;
+ friend class CLiwServiceHandlerImpl;
+};
+
+#endif
+
+// End of File
+
+