--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/upnpavcontrolpoint/avcpengine/inc/upnpavcpmanager.h Thu Dec 17 08:52:00 2009 +0200
@@ -0,0 +1,159 @@
+/** @file
+* Copyright (c) 2005-2006 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: Class comunicates with MSs
+*
+*/
+
+
+#ifndef C_CUPNPAVCPMANAGER_H
+#define C_CUPNPAVCPMANAGER_H
+
+// INCLUDES
+#include "upnpavcontrolpoint.h"
+
+// FORWARD DECLARATIONS
+class MUpnpResponseHandler;
+class MUpnpHttpResponseHandler;
+class CUpnpPathResolver;
+class CUpnpAVCPEngineSession;
+
+// CLASS DECLARATION
+/**
+* Class implements (derive CUpnpAVControlPoint).
+* It provides way to send SOAP action, HTTP request,
+* receive notification about responses also support eventing phase.
+* Additionally class keeps path resolvers for each MS (if it is needed).
+*
+* @since Series 60 3.1
+*/
+class CUpnpAVCPManager : public CUpnpAVControlPoint
+ {
+ public:
+ /**
+ * Two-phased constructor.
+ */
+ static CUpnpAVCPManager* NewL();
+ /**
+ * Destructor.
+ */
+ ~CUpnpAVCPManager();
+ /**
+ * Get unique command id
+ *
+ * @return command id
+ */
+ TInt NewCommandId();
+ /**
+ * Register a observer for receive notification about SOAP responses
+ *
+ * @param aHandler class implemented observer
+ */
+ void RegisterForAction(MUpnpResponseHandler& aHandler);
+ /**
+ * Register a observer for receive notification about HTTP responses
+ *
+ * @param aHandler class implemented observer
+ */
+ void RegisterForHttp(MUpnpHttpResponseHandler& aHandler);
+ /**
+ * Unregister a observer for receive notification about HTTP responses
+ *
+ * @param aHandler class implemented observer
+ */
+ void UnregisterForHttp(MUpnpHttpResponseHandler& aHandler);
+ /**
+ * Return path resolver.
+ * If path resolver was created, return instance, otherwise create a new one,
+ * subsribe for events.
+ * Parameter aSession is used for managing life time of resolver.
+ * if all session used resolver has been closed, resolver is doestoyed.
+ *
+ * @param aUUID UDN of MS
+ * aSession server-side session
+ */
+ CUpnpPathResolver& PathResolverL(const TDesC8& aUUID, CUpnpAVCPEngineSession* aSession);
+ /**
+ * Perform cleanup after closing server-side session.
+ * it checks whether it was the last session used resolver and
+ * destroy resolver if it was true.
+ */
+ void CleanupSessionL( CUpnpAVCPEngineSession* aSession);
+
+ private: // Method from CUpnpAVControlPoint
+ /**
+ * From CUpnpAVControlPoint handles HTTP messages.
+ * @since Series 60 2.0
+ * @param aMessage Incoming HTTP message.
+ */
+ void HttpResponseReceivedL(CUpnpHttpMessage* aMessage);
+ /**
+ * From CUpnpAVControlPoint handles actions' responses.
+ * @since Series 60 2.0
+ * @param aMessage Incoming HTTP message.
+ */
+ void ActionResponseReceivedL(CUpnpAction* aAction);
+ /**
+ * From CUpnpAVControlPoint handles events (as a response for SUBSCRIBE).
+ * @since Series 60 2.0
+ * @param aMessage Incoming HTTP message.
+ */
+ void StateUpdatedL(CUpnpService* aService);
+ /**
+ * From CUpnpAVControlPoint handles UPnP device discoveries.
+ * @since Series 60 2.0
+ * @param aDevice Device that is discovered.
+ */
+ void DeviceDiscoveredL(CUpnpDevice* aDevice);
+ /**
+ * From CUpnpAVControlPoint handles UPnP device disappears.
+ * @since Series 60 2.0
+ * @param aDevice Device that disappeared.
+ */
+ void DeviceDisappearedL(CUpnpDevice* aDevice);
+
+ private:
+ /**
+ * C++ default constructor.
+ */
+ CUpnpAVCPManager(MUpnpAVControlPointObserver* aObserver);
+ /**
+ * Symbian 2nd phase constructor.
+ */
+ void ConstructL();
+ /**
+ * Return index of action handler for specific session id
+ *
+ * @return index if found, else KErrNotFound
+ */
+ TInt HandlerBySessionId(TInt aSessionId);
+ /**
+ * Return index of HTTP handler for specific session id
+ *
+ * @return index if found, else KErrNotFound
+ */
+ TInt HttpHandlerBySessionId(TInt aSessionId);
+
+ private: // Data
+ // last command id
+ TInt iLastCommandId;
+ // array of observers registered for SOAP action
+ RPointerArray<MUpnpResponseHandler> iPendingHandlers;
+ // array of observer registered for HTTP response
+ RPointerArray<MUpnpHttpResponseHandler> iHttpPendingHandlers;
+ // array of path resolvers
+ RPointerArray<CUpnpPathResolver> iPathResolvers;
+ };
+
+#endif //C_CUPNPAVCPMANAGER_H
+