--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/homescreensrv_plat/servicemodel_api/service.h Fri Mar 19 09:35:23 2010 +0200
@@ -0,0 +1,101 @@
+/*
+* Copyright (c) 2009 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:
+*
+*/
+
+
+#ifndef SERVICE_H
+#define SERVICE_H
+
+#include "servicemodel_global.h"
+#include <QObject>
+#include <QVariant>
+
+class ServiceParameters;
+
+/**
+ * @ingroup group_hsservicemodel group_service_api_candidates
+ * @brief Base class for all the services.
+ */
+class HSSERVICEMODEL_EXPORT HsService : public QObject
+{
+ Q_OBJECT
+
+public:
+
+ /**
+ * Constructor
+ * @param aParent
+ */
+ HsService( QObject* aParent = 0 ) : QObject( aParent ) {}
+
+ /**
+ * destructor
+ * @since S60 ?S60_version.
+ */
+ virtual ~HsService() {}
+
+public:
+
+ /**
+ * Execute service command
+ * @param aCommand service command
+ * @param aInParameters parameters.
+ * For example messaging service
+ * needs to have at least the following pairs to send short message:
+ * 'MessageType' - 'SMS'
+ * 'To' - 'phone number here'
+ * 'BodyText' - 'this is text to be sent'
+ * So aInParameters should include QMap:
+ * @code
+ * QMap<QString, QVariant> parameters;
+ * parameters["MessageType"]=QVariant(QString("SMS"));
+ * parameters["To"]=QVariant(QString("555555"));
+ * parameters["BodyText"]=QVariant(QString("this is bodytext"));
+ * QVariant inParameters;
+ * inParameters.setValue(parameters);
+ * @endcode
+ */
+ virtual void executeCommand(const QByteArray &aCommand, const QVariant &aInParameters) = 0;
+
+ /**
+ * Cancels ALL then pending commands.
+ */
+ virtual void cancelCommands() = 0;
+
+ /**
+ * Get data after dataReceived signal has been received.
+ *
+ * @param aData data buffer to be filled
+ * TODO: error?
+ */
+ virtual void getData(QVariant &aData) = 0;
+
+signals:
+
+ /**
+ * Signal emitted when data is received, client can then make query for the received data using getData function.
+ */
+ void dataReceived();
+
+ /**
+ * Signal emitted when data is received
+ * @param aData (QMap<QString, QVariant>) data received from the service
+ */
+ void dataReceived(const QVariant &aData);
+
+};
+
+#endif