--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/idlefw/plugins/sapidataplugin/inc/sapidata.h Thu Dec 17 08:54:17 2009 +0200
@@ -0,0 +1,419 @@
+/*
+* 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: Plug-in main class
+*
+*/
+
+
+#ifndef SAPIDATA_H
+#define SAPIDATA_H
+
+// INCLUDE FILES
+#include <LiwCommon.h>
+#include <AknsItemID.h>
+#include <aieventhandlerextension.h>
+#include "sapidatapluginconst.h"
+#include "aicontentpublisher.h"
+
+class MLiwInterface;
+class CLiwServiceHandler;
+class CSapiDataObserver;
+class CSapiDataPlugin;
+
+
+class CContentItem : public CBase
+ {
+ public :
+
+ /**
+ * Part of the two phased constuction
+ *
+ * @param none
+ * @return none
+ */
+ static CContentItem* NewL();
+
+
+ /*
+ * Destructor
+ */
+ ~CContentItem();
+
+ private :
+
+ /*
+ * Constructor
+ */
+ CContentItem();
+
+ /**
+ * Part of the two phased construction
+ *
+ * @param none
+ * @return void
+ */
+ void ConstructL();
+
+ public :
+
+ TInt iId;
+ /* item id */
+ HBufC* iName;
+ /* type (image/text) */
+ HBufC* iType;
+
+ HBufC* iContentType;
+ };
+
+/**
+ * @ingroup group_sapidataplugin
+ *
+ * Sapi data
+ *
+ * @since S60 v3.2
+ */
+class CSapiData : public CBase
+ {
+ public:
+
+ /**
+ * Part of the two phased construction
+ *
+ * @param aPlugin refrence of the plugin
+ * @return none
+ */
+ static CSapiData* NewL(CSapiDataPlugin* aPlugin);
+
+ /**
+ * Destructor
+ *
+ * @param none
+ * @return none
+ */
+ ~CSapiData();
+
+ private :
+
+
+ /**
+ * Constructor
+ *
+ * @param none
+ * @return none
+ */
+ CSapiData();
+
+
+ /**
+ * Part of the two phased construction
+ *
+ * @param aPlugin reference of the plugin
+ * @return void
+ */
+ void ConstructL(CSapiDataPlugin* aPlugin);
+
+ /**
+ * Change the publisher status
+ *
+ * @param aStatus new status of the publisher
+ * @return void
+ */
+ void ChangePublisherStatusL(const TDesC& aStatus);
+
+ /**
+ * Gets the menu item from the publisher
+ *
+ * @param none
+ * @return void
+ */
+ void GetMenuItemsL();
+
+ public :
+
+ /**
+ * Configures the subscriber and data to subscribe.
+ *
+ * @param aConfigurations Information about the subscriber
+ * and the data to subscribe.
+ * @return void
+ */
+ void ConfigureL(RAiSettingsItemArray& aConfigurations);
+
+ void SetContentIdL(const TDesC8& aId);
+
+ /**
+ * Execute the command to get the data from CPS
+ *
+ * @param aRegistry type of registry (publisher/cp_data)
+ * @param aInFilter input filter for the command
+ * @param outParamList output data map
+ * @return void
+ */
+ void ExecuteCommandL(const TDesC& aRegistry ,
+ CLiwDefaultMap* aInFilter, CLiwGenericParamList* outParamList );
+
+ /**
+ * Checks Can Update for this publisher
+ *
+ * @param aPublisher publisher.
+ * @param aContentType content type.
+ * @param aContentId content Id.
+ * @return bool
+ */
+ TBool CanUpdate( TDesC& aPublisher, TDesC& aContentType, TDesC& aContentId );
+
+ /**
+ * Removes all the data from the widget which matches to
+ * this publisher, contentype, contentid values
+ *
+ * @param aObserver to publish data
+ * @param aContentType content type
+ * @return void
+ */
+ void RemoveL( MAiContentObserver* aObserver, TDesC& aContentType );
+
+ /**
+ * Checks is this menu item is supported by the publisher
+ *
+ * @param aMenuItem menu item name.
+ * @return boolean (ETrue/EFalse)
+ */
+ TBool HasMenuItem(const TDesC& aMenuItem );
+
+ /**
+ * Publish the data to widget.
+ *
+ * @param aObserver to publish data
+ * @param aContentType content type
+ * @return void
+ */
+ void PublishL( MAiContentObserver* aObserver, const TDesC& aContentType );
+
+ /**
+ * Publish the updated data to widget.
+ *
+ * @param aObserver to publish data
+ * @param aDataMap data map with updated data
+ * @return void
+ */
+ void PublishDataL(MAiContentObserver* aObserver, CLiwDefaultMap* aDataMap );
+
+ /**
+ * Tigger for execution of a action for a specific content id.
+ *
+ * @param aObjectId object Id.
+ * @param aTrigger name of the trigger.
+ * @return void
+ */
+ void ExecuteActionL(const TDesC& aObjectId, const TDesC& aTrigger);
+
+ /**
+ * Register to publisher registry for all (update) action
+ *
+ * @param none
+ * @return void
+ */
+ void RegisterPublisherObserverL();
+
+ /**
+ * Register to content registry for all (add/delete/update) action
+ *
+ * @param none
+ * @return void
+ */
+ void RegisterContentObserverL();
+
+ /**
+ * Called by the observer to refresh the changed content
+ *
+ * @param aPublisher publisher.
+ * @param aContentType content type.
+ * @param aContentId content Id.
+ * @param aOperation operation (add/delete/update/execute).
+ * @return void
+ */
+ void RefreshL( TDesC& aPublisher, TDesC& aContentType,
+ TDesC& aContentId, TDesC& aOperation );
+
+ /**
+ * Createts the filter map and push it in the stack
+ *
+ * @return filter map
+ */
+ CLiwDefaultMap* CreateFilterLC();
+
+ /**
+ * Createts the filter map and push it in the stack
+ *
+ * @param aConType content type
+ * @return filter map
+ */
+ CLiwDefaultMap* CreateFilterLC(const TDesC& aConType);
+
+ /**
+ * Createts the filter map and push it in the stack
+ *
+ * @param aConType content type
+ * @param aContentId cotent Id
+ * @return filter map
+ */
+ CLiwDefaultMap* CreateFilterLC(const TDesC& aContentType,
+ const TDesC& aContentId);
+
+ /**
+ * Is the pugin is active to publish the data.
+ *
+ * @param None
+ * @return boolean (ETrue/EFalse).
+ */
+ TBool IsPluginActive();
+
+ /**
+ * Resume the publisher
+ *
+ * @param None
+ * @return void
+ */
+ void ResumeL();
+
+ /**
+ * Suspend the publisher
+ *
+ * @param None
+ * @return void
+ */
+ void SuspendL();
+
+ /**
+ * Activate the publisher
+ *
+ * @param None
+ * @return void
+ */
+ void ActivateL();
+
+ /**
+ * Deactivate the publisher
+ *
+ * @param None
+ * @return void
+ */
+ void DeActivateL();
+
+ /**
+ * OnLineL
+ *
+ * @param None
+ * @return void
+ */
+ void OnLineL();
+
+ /**
+ * OffLineL
+ *
+ * @param None
+ * @return void
+ */
+ void OffLineL();
+
+ /**
+ * InActiveL
+ *
+ * @param None
+ * @return void
+ */
+ void InActiveL();
+
+ /**
+ * Update the publisher status
+ *
+ * @param aPublisher publisher name
+ * @return void
+ */
+ void UpdatePublisherStatusL(TDesC& aPublisher);
+
+ /**
+ * Resolves skin item id and Mif id from pattern
+ * skin( <majorId> <minorId> (<colourGroupId>)
+ * mif(<MifFileName.mif> <bitmapId> <maskId>)
+ *
+ * @param aPath skin pattern / mif pattern value
+ * @param aItemId skin item id
+ * @param aMifId mif id
+ * @param aMaskId mask id
+ * @param aFilename mif file name
+ * @return boolean (ETrue/EFalse)
+ */
+ TBool ResolveSkinIdAndMifId( const TDesC& aPath, TAknsItemID& aItemId,
+ TInt& aMifId, TInt& aMaskId, TDes& aFilename );
+
+ /**
+ * Sets the on resume update needed status
+ *
+ * @param aStatus update needed status (ETrue/EFalse)
+ * @return void
+ */
+ void SetUpdateNeeded(TBool aStatus);
+
+ private :
+
+ // Subscriber interface
+ // own
+ MLiwInterface* iInterface;
+
+ // Data Observer to CPS content registry
+ // Own // iConObserver;
+ CSapiDataObserver* iContentObserver;
+
+ // Data Observer to CPS publisher registry
+ // Own // iConObserver;
+ CSapiDataObserver* iPubObserver;
+
+ // Service handler
+ // Own
+ CLiwServiceHandler* iServiceHandler;
+
+ // Array of configurations
+ // Own
+ RPointerArray<CContentItem> iItemList;
+
+ // Number of configurations
+ TInt iItemCount;
+
+ // Command name in configuration Array
+ HBufC8* iCommandName;
+ /* publisher id */
+ HBufC* iPublisher;
+ /* content type */
+ HBufC* iContentType;
+ /* content id */
+ HBufC* iContentId;
+
+ // Reference of the sapi data plugin
+ // Not owned
+ CSapiDataPlugin* iPlugin;
+
+ // Menu item names
+ // Own
+ RPointerArray<HBufC> iMenuItems;
+
+ // Trigger names for the menu items
+ // Own
+ RPointerArray<HBufC8> iMenuTriggers;
+
+ // Store the status of update needed on resume
+ TBool iUpdateNeeded;
+ };
+
+#endif /*SAPIDATA_H*/