messagingfw/wappushfw/pushutils/inc/PushDispatcher.h
changeset 0 8e480a14352b
child 3 28ae839b4c09
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/messagingfw/wappushfw/pushutils/inc/PushDispatcher.h	Mon Jan 18 20:36:02 2010 +0200
@@ -0,0 +1,103 @@
+// Copyright (c) 2000-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:
+// This file contains the declaration of the PushAppDispatcher which Handles the push message using the
+// extracted app ID. Other class is PushContentTypeDispatcher for creating appropiate handler to handle the push message
+// 
+//
+
+/**
+ @file
+ @internalTechnology
+ @released
+*/
+
+#ifndef __PUSHDISPATCHER_H__
+#define __PUSHDISPATCHER_H__
+
+#include <e32std.h>
+
+//Forward declarations
+class CPluginOwner;
+class CPluginKiller;
+class MWapPushLog;
+class MConnManObserver;
+class CPushHandlerBase;
+class CContentHandlerBase;
+
+/** Handle for default user agent. */
+const TInt KUserAgentAppHandler = 0;
+
+/** Creates an appropriate App Handler for the given AppId or AppURI.
+	
+	Looks up the application Id passed in and uses the WAP Plugin Server
+	to determine the correct handler which is then created. If there is no
+	recognised application handler to deal with the Message App Type then the
+	default behaviour is to create an Unknown AppHandler to process message.
+
+	@param aAppId Application ID extracted from Push Message
+	@param aLog Reference to logging object 
+	@param aManager Reference to Connection Manager Observer Mixin class
+	@param aAppURI Application URI used instead of Application UID
+
+	@return Reference to the application plugin handler base class 
+*/
+//##ModelId=3B659EE80221
+class PushAppDispatcher
+/**
+@internalTechnology
+@released
+*/
+	{
+public:
+	//##ModelId=3B659E6E0145
+	IMPORT_C static CPushHandlerBase& GetHandlerL(TInt aAppId, MWapPushLog& aLog, MConnManObserver& aManager);
+	//##ModelId=3B659E6E014D
+	IMPORT_C static CPushHandlerBase& GetHandlerL(const TDesC8& aAppURI, MWapPushLog& aLog, MConnManObserver& aManager);
+
+private:
+	//##ModelId=3B659E6E0140
+	static CPushHandlerBase* CreatePluginFromDataL(const TDesC& aData, const TUid& aType, MWapPushLog& aLog, MConnManObserver& aManager);
+
+	friend class PushContentTypeDispatcher;
+	};
+
+
+/** Creates an appropriate Content Type handler for the given CPushMessage.
+
+	The content dispatcher uses the WAP plugin server to determine the correct handler
+	given the Content Type retrieved from the CPushMessage. It will then instantiate
+	an instance of the correct handler and pass back a pointer to this content
+	handler. If the Content Type is not recognised and no appropriate handler
+	exists, a Unknown Content Handler will be created to deal with the message.
+
+	@param aContentType Content type extracted from Push Message
+	@param aLog Reference to logging object 
+	@param aManager Reference to Connection Manager Observer Mixin class
+
+	@return  Reference to the content plugin handler base class 
+*/
+//##ModelId=3B659EE902E1
+class PushContentTypeDispatcher 
+/**
+@internalTechnology
+@released
+*/
+	{
+public:
+	//##ModelId=3B659E6E030C
+	IMPORT_C static CContentHandlerBase& GetHandlerL(const TDesC16& aContentType, MWapPushLog& aLog, MConnManObserver& aManager);
+	};
+
+
+#endif